Skip to content
MCP server

IBM watsonx.ai Granite

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

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

About IBM watsonx.ai Granite

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

Install

Run in a terminal

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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

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

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

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

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

Configuration

  • WATSONX_API_KEYIBM Cloud API key (create one at https://cloud.ibm.com/iam/apikeys).Required
  • WATSONX_PROJECT_IDwatsonx.ai project id (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 inference host. Defaults to https://us-south.ml.cloud.ibm.com.
  • WATSONX_MODEL_IDDefault chat/generation model id. Defaults to ibm/granite-3-8b-instruct.
  • WATSONX_EMBED_MODEL_IDDefault embedding model id. Defaults to ibm/granite-embedding-278m-multilingual.
  • WATSONX_API_VERSIONwatsonx.ai REST API version date. Defaults to 2024-05-31.

Pricing

Open source

Prices change. Check three.ws before you buy.

IBM watsonx.ai Granite FAQ

Is IBM watsonx.ai Granite free?

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

How do I add IBM watsonx.ai Granite to Claude Code?

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