PluginBench
MCP Server

IBM Granite via x402 MCP Server

io.github.nirholas/ibm-x402-mcp

What is the IBM Granite via x402 MCP server?

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

How to install IBM Granite via x402

Copy-paste configuration for popular MCP clients.

transport: stdio
Config generated by PluginBench — verify against the source before use.
Environment / auth
  • MCP_SVM_PAYMENT_ADDRESS
    required

    Solana wallet address that receives USDC payments from tool callers (server operator's receiving wallet). Required to accept x402 payments.

  • WATSONX_API_KEY
    required
    secret

    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.

Claude Desktop
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "ibm-x402-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/ibm-x402-mcp"
      ],
      "env": {
        "MCP_SVM_PAYMENT_ADDRESS": "<YOUR_MCP_SVM_PAYMENT_ADDRESS>",
        "WATSONX_API_KEY": "<YOUR_WATSONX_API_KEY>",
        "WATSONX_PROJECT_ID": "<YOUR_WATSONX_PROJECT_ID>",
        "WATSONX_SPACE_ID": "<YOUR_WATSONX_SPACE_ID>",
        "WATSONX_URL": "<YOUR_WATSONX_URL>",
        "WATSONX_MODEL_ID": "<YOUR_WATSONX_MODEL_ID>",
        "WATSONX_EMBED_MODEL_ID": "<YOUR_WATSONX_EMBED_MODEL_ID>",
        "X402_FEE_PAYER_SOLANA": "<YOUR_X402_FEE_PAYER_SOLANA>",
        "X402_FACILITATOR_URL": "<YOUR_X402_FACILITATOR_URL>"
      }
    }
  }
}
Cursor
~/.cursor/mcp.json
{
  "mcpServers": {
    "ibm-x402-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/ibm-x402-mcp"
      ],
      "env": {
        "MCP_SVM_PAYMENT_ADDRESS": "<YOUR_MCP_SVM_PAYMENT_ADDRESS>",
        "WATSONX_API_KEY": "<YOUR_WATSONX_API_KEY>",
        "WATSONX_PROJECT_ID": "<YOUR_WATSONX_PROJECT_ID>",
        "WATSONX_SPACE_ID": "<YOUR_WATSONX_SPACE_ID>",
        "WATSONX_URL": "<YOUR_WATSONX_URL>",
        "WATSONX_MODEL_ID": "<YOUR_WATSONX_MODEL_ID>",
        "WATSONX_EMBED_MODEL_ID": "<YOUR_WATSONX_EMBED_MODEL_ID>",
        "X402_FEE_PAYER_SOLANA": "<YOUR_X402_FEE_PAYER_SOLANA>",
        "X402_FACILITATOR_URL": "<YOUR_X402_FACILITATOR_URL>"
      }
    }
  }
}
Windsurf
~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "ibm-x402-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/ibm-x402-mcp"
      ],
      "env": {
        "MCP_SVM_PAYMENT_ADDRESS": "<YOUR_MCP_SVM_PAYMENT_ADDRESS>",
        "WATSONX_API_KEY": "<YOUR_WATSONX_API_KEY>",
        "WATSONX_PROJECT_ID": "<YOUR_WATSONX_PROJECT_ID>",
        "WATSONX_SPACE_ID": "<YOUR_WATSONX_SPACE_ID>",
        "WATSONX_URL": "<YOUR_WATSONX_URL>",
        "WATSONX_MODEL_ID": "<YOUR_WATSONX_MODEL_ID>",
        "WATSONX_EMBED_MODEL_ID": "<YOUR_WATSONX_EMBED_MODEL_ID>",
        "X402_FEE_PAYER_SOLANA": "<YOUR_X402_FEE_PAYER_SOLANA>",
        "X402_FACILITATOR_URL": "<YOUR_X402_FACILITATOR_URL>"
      }
    }
  }
}
VS Code
.vscode/mcp.json
{
  "servers": {
    "ibm-x402-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/ibm-x402-mcp"
      ],
      "env": {
        "MCP_SVM_PAYMENT_ADDRESS": "<YOUR_MCP_SVM_PAYMENT_ADDRESS>",
        "WATSONX_API_KEY": "<YOUR_WATSONX_API_KEY>",
        "WATSONX_PROJECT_ID": "<YOUR_WATSONX_PROJECT_ID>",
        "WATSONX_SPACE_ID": "<YOUR_WATSONX_SPACE_ID>",
        "WATSONX_URL": "<YOUR_WATSONX_URL>",
        "WATSONX_MODEL_ID": "<YOUR_WATSONX_MODEL_ID>",
        "WATSONX_EMBED_MODEL_ID": "<YOUR_WATSONX_EMBED_MODEL_ID>",
        "X402_FEE_PAYER_SOLANA": "<YOUR_X402_FEE_PAYER_SOLANA>",
        "X402_FACILITATOR_URL": "<YOUR_X402_FACILITATOR_URL>"
      }
    }
  }
}
Claude Code
claude mcp add ibm-x402-mcp --env MCP_SVM_PAYMENT_ADDRESS=<YOUR_MCP_SVM_PAYMENT_ADDRESS> --env WATSONX_API_KEY=<YOUR_WATSONX_API_KEY> --env WATSONX_PROJECT_ID=<YOUR_WATSONX_PROJECT_ID> --env WATSONX_SPACE_ID=<YOUR_WATSONX_SPACE_ID> --env WATSONX_URL=<YOUR_WATSONX_URL> --env WATSONX_MODEL_ID=<YOUR_WATSONX_MODEL_ID> --env WATSONX_EMBED_MODEL_ID=<YOUR_WATSONX_EMBED_MODEL_ID> --env X402_FEE_PAYER_SOLANA=<YOUR_X402_FEE_PAYER_SOLANA> --env X402_FACILITATOR_URL=<YOUR_X402_FACILITATOR_URL> -- npx -y @three-ws/ibm-x402-mcp

Related MCP servers

3D AI Agent Avatar — render any GLB, give it a Solana wallet, a voice, and pump.fun powers.

View repository →

MCP tools from three.ws: free + paid text-to-3D, rigging, agent reputation, market intel.

View repository →

UCAI — The ABI-to-MCP Server Generator. Convert any smart contract ABI into an AI-ready MCP server.

View repository →

Trending agents and coins, the $THREE holder leaderboard, and the site-wide activity ticker.

View repository →

Browse the AgenC on-chain task marketplace, query the agent registry, and link identities.

View repository →

Self-custodial pump.fun sniper: arm strategies, snipe, manage positions. Simulate by default.

View repository →