PluginBench
MCP Server

IBM watsonx.ai Granite MCP Server

io.github.nirholas/ibm-watsonx

RepositoryRegistry

What is the IBM watsonx.ai Granite MCP server?

IBM watsonx.ai MCP by three.ws: chat, text generation, embeddings, and tokenization.

How to install IBM watsonx.ai Granite

Copy-paste configuration for popular MCP clients.

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

    IBM Cloud API key (create one at https://cloud.ibm.com/iam/apikeys).

  • WATSONX_PROJECT_ID

    watsonx.ai project id (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 inference host. Defaults to https://us-south.ml.cloud.ibm.com.

  • WATSONX_MODEL_ID

    Default chat/generation model id. Defaults to ibm/granite-3-8b-instruct.

  • WATSONX_EMBED_MODEL_ID

    Default embedding model id. Defaults to ibm/granite-embedding-278m-multilingual.

  • WATSONX_API_VERSION

    watsonx.ai REST API version date. Defaults to 2024-05-31.

Claude Desktop
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "ibm-watsonx": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/ibm-watsonx-mcp"
      ],
      "env": {
        "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>",
        "WATSONX_API_VERSION": "<YOUR_WATSONX_API_VERSION>"
      }
    }
  }
}
Cursor
~/.cursor/mcp.json
{
  "mcpServers": {
    "ibm-watsonx": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/ibm-watsonx-mcp"
      ],
      "env": {
        "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>",
        "WATSONX_API_VERSION": "<YOUR_WATSONX_API_VERSION>"
      }
    }
  }
}
Windsurf
~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "ibm-watsonx": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/ibm-watsonx-mcp"
      ],
      "env": {
        "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>",
        "WATSONX_API_VERSION": "<YOUR_WATSONX_API_VERSION>"
      }
    }
  }
}
VS Code
.vscode/mcp.json
{
  "servers": {
    "ibm-watsonx": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/ibm-watsonx-mcp"
      ],
      "env": {
        "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>",
        "WATSONX_API_VERSION": "<YOUR_WATSONX_API_VERSION>"
      }
    }
  }
}
Claude Code
claude mcp add ibm-watsonx --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 WATSONX_API_VERSION=<YOUR_WATSONX_API_VERSION> -- npx -y @three-ws/ibm-watsonx-mcp

Related MCP servers

3D AI Agent Avatar

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

View repository →

three.ws 3D Agent Tools

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

View repository →

UCAI

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

View repository →

three.ws Activity

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

View repository →

three.ws AgenC

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

View repository →

Agent Sniper

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

View repository →