IBM Granite via x402 MCP Server

by nirholasio.github.nirholas/ibm-x402-mcpv1.1.3

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

228Node.jsstdioremoteofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active2d ago

Install IBM Granite via x402 MCP server

claude mcp add ibm-x402 -e MCP_SVM_PAYMENT_ADDRESS='<mcp-svm-payment-address>' -e WATSONX_API_KEY='<watsonx-api-key>' -- npx -y @three-ws/ibm-x402-mcp

{
  "mcpServers": {
    "ibm-x402": {
      "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 (global) or .cursor/mcp.json (project).

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

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "ibm-x402": {
      "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 .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "ibm-x402": {
      "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.

Configuration

Variable	Required	Secret	Description
MCP_SVM_PAYMENT_ADDRESS	yes	—	Solana wallet address that receives USDC payments from tool callers (server operator's receiving wallet). Required to accept x402 payments.
WATSONX_API_KEY	yes	yes	IBM 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.
WATSONX_PROJECT_ID	—	—	watsonx.ai project id scoping all inference calls. Find it under your project → Manage → General → Project ID. Provide this or WATSONX_SPACE_ID.
WATSONX_SPACE_ID	—	—	watsonx.ai deployment space id. Alternative to WATSONX_PROJECT_ID.
WATSONX_URL	—	—	Regional 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_ID	—	—	Default chat/generation Granite model id. Defaults to ibm/granite-3-8b-instruct.
WATSONX_EMBED_MODEL_ID	—	—	Default embedding model id. Defaults to ibm/granite-embedding-278m-multilingual.
X402_FEE_PAYER_SOLANA	—	—	Solana account that sponsors transaction fees for x402 payments. Defaults to the three.ws fee payer.
X402_FACILITATOR_URL	—	—	x402 facilitator endpoint for payment verification and settlement. Defaults to https://facilitator.payai.network.

Remote endpoints

streamable-httphttps://three.ws/api/ibm-mcp

Freshness

Active — last maintenance signal 2d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-08 · 2d ago · GitHub
Latest release
2026-09-30 · 10d ago · GitHub · v1.5.2
Package published
no data · npm/PyPI
Registry entry updated
2026-08-19 · 51d ago · official registry · v1.1.3

FAQ

›How do I install the IBM Granite via x402 MCP server in Claude Code?

Run: claude mcp add ibm-x402 -e MCP_SVM_PAYMENT_ADDRESS='<mcp-svm-payment-address>' -e WATSONX_API_KEY='<watsonx-api-key>' -- npx -y @three-ws/ibm-x402-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does IBM Granite via x402 require an API key?

Yes. It expects MCP_SVM_PAYMENT_ADDRESS, WATSONX_API_KEY, of which 1 is a secret.

›Can I use IBM Granite via x402 as a remote (hosted) MCP server?

Yes — it offers both a hosted endpoint and a local stdio package.

›Is IBM Granite via x402 in the official MCP registry?

Yes, as io.github.nirholas/ibm-x402-mcp.