IBM watsonx.ai Granite MCP Server

by nirholasio.github.nirholas/ibm-watsonxv0.2.1

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

228Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active2d ago

Install IBM watsonx.ai Granite MCP server

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

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

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

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

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

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

Add to .vscode/mcp.json in your workspace.

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

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

Configuration

Variable	Required	Secret	Description
WATSONX_API_KEY	yes	yes	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.

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 · v0.2.1

FAQ

›How do I install the IBM watsonx.ai Granite MCP server in Claude Code?

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

›Does IBM watsonx.ai Granite require an API key?

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

›Can I use IBM watsonx.ai Granite as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is IBM watsonx.ai Granite in the official MCP registry?

Yes, as io.github.nirholas/ibm-watsonx.