Skip to content
MCP server

IBM Granite via x402

x402 pay-per-use IBM Granite AI: chat, code, embeddings, analysis, forecasting. Pay USDC…

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
1.1.4
Listing updated
5 days ago

About IBM Granite via x402

IBM Granite via x402 is an open-source MCP server. It runs locally on your machine and is started by your AI client.

x402 pay-per-use IBM Granite AI: chat, code, embeddings, analysis, forecasting. Pay USDC per call.

Install

Run in a terminal

claude mcp add ibm-x402-mcp --env MCP_SVM_PAYMENT_ADDRESS='<MCP_SVM_PAYMENT_ADDRESS>' --env WATSONX_API_KEY='<WATSONX_API_KEY>' -- npx -y @three-ws/ibm-x402-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "ibm-x402-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/ibm-x402-mcp"
      ],
      "env": {
        "MCP_SVM_PAYMENT_ADDRESS": "<MCP_SVM_PAYMENT_ADDRESS>",
        "WATSONX_API_KEY": "<WATSONX_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "ibm-x402-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/ibm-x402-mcp"
      ],
      "env": {
        "MCP_SVM_PAYMENT_ADDRESS": "<MCP_SVM_PAYMENT_ADDRESS>",
        "WATSONX_API_KEY": "<WATSONX_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "ibm-x402-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/ibm-x402-mcp"
      ],
      "env": {
        "MCP_SVM_PAYMENT_ADDRESS": "<MCP_SVM_PAYMENT_ADDRESS>",
        "WATSONX_API_KEY": "<WATSONX_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "ibm-x402-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/ibm-x402-mcp"
      ],
      "env": {
        "MCP_SVM_PAYMENT_ADDRESS": "<MCP_SVM_PAYMENT_ADDRESS>",
        "WATSONX_API_KEY": "<WATSONX_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "ibm-x402-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/ibm-x402-mcp"
      ],
      "env": {
        "MCP_SVM_PAYMENT_ADDRESS": "<MCP_SVM_PAYMENT_ADDRESS>",
        "WATSONX_API_KEY": "<WATSONX_API_KEY>"
      }
    }
  }
}

Configuration

  • MCP_SVM_PAYMENT_ADDRESSSolana wallet address that receives USDC payments from tool callers (server operator's receiving wallet). Required to accept x402 payments.Required
  • WATSONX_API_KEYIBM Cloud API key used by the server to call watsonx.ai on behalf of end users. Create one at https://cloud.ibm.com/iam/apikeys.Required
  • WATSONX_PROJECT_IDwatsonx.ai project id scoping all inference calls. Find it under your project → Manage → General → Project ID. Provide this or WATSONX_SPACE_ID.
  • WATSONX_SPACE_IDwatsonx.ai deployment space id. Alternative to WATSONX_PROJECT_ID.
  • WATSONX_URLRegional watsonx.ai inference host. Defaults to https://us-south.ml.cloud.ibm.com. Other regions: eu-de, eu-gb, jp-tok, au-syd, ca-tor.
  • WATSONX_MODEL_IDDefault chat/generation Granite model id. Defaults to ibm/granite-3-8b-instruct.
  • WATSONX_EMBED_MODEL_IDDefault embedding model id. Defaults to ibm/granite-embedding-278m-multilingual.
  • X402_FEE_PAYER_SOLANASolana account that sponsors transaction fees for x402 payments. Defaults to the three.ws fee payer.
  • X402_FACILITATOR_URLx402 facilitator endpoint for payment verification and settlement. Defaults to https://facilitator.payai.network.

Pricing

Open source

Prices change. Check three.ws before you buy.

IBM Granite via x402 FAQ

Is IBM Granite via x402 free?

Yes. IBM Granite via x402 is open source, so you can use and self-host it for free.

How do I add IBM Granite via x402 to Claude Code?

Run this command in your terminal: claude mcp add ibm-x402-mcp --env MCP_SVM_PAYMENT_ADDRESS='<MCP_SVM_PAYMENT_ADDRESS>' --env WATSONX_API_KEY='<WATSONX_API_KEY>' -- npx -y @three-ws/ibm-x402-mcp