Watsonx MCP Server

IBM watsonx.ai MCP server for Claude integration

Local serverstdio

What is the Watsonx MCP server?

If you already use Watsonx, the watsonx mcp server is the piece that lets your assistant work with it directly. IBM watsonx.ai MCP server for Claude integration.

What the server does

MCP server for IBM watsonx.ai integration with Claude Code. Enables Claude to delegate tasks to IBM's foundation models (Granite, Llama, Mistral, etc.).

  • Text Generation — - Generate text using watsonx.ai foundation models
  • Chat — - Have conversations with watsonx.ai chat models
  • Embeddings — - Generate text embeddings
  • Model Listing — - List all available foundation models

Available tools

The toolset is worth reading before you wire it up, because it tells you what the integration is really for:

  • watsonx_generate — Generate text using watsonx.ai models
  • watsonx_chat — Chat with watsonx.ai models
  • watsonx_embeddings — Generate text embeddings
  • watsonx_list_models — List available models
  • Commands — The Commands tool exposed by this server
  • Features — The Features tool exposed by this server
  • Demo — The Demo tool exposed by this server

Credentials and setup notes

Configuration is passed through the environment: WATSONX_API_KEY, WATSONX_URL, WATSONX_SPACE_ID, WATSONX_PROJECT_ID. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

Installation

Setup follows the usual MCP pattern — install or clone the server, register it in your client's configuration file, restart the client.

Where it fits

This sits in the developer tooling group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Watsonx's toolset — watsonx_generate, watsonx_chat, watsonx_embeddings and 4 more — is a fair guide to whether it matches your workflow. It is maintained by ExpertVagabond; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against Watsonx's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

Worth knowing first

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Available tools

ToolWhat it does
watsonx_generateGenerate text using watsonx.ai models
watsonx_chatChat with watsonx.ai models
watsonx_embeddingsGenerate text embeddings
watsonx_list_modelsList available models
CommandsThe Commands tool exposed by this server.
FeaturesThe Features tool exposed by this server.
DemoThe Demo tool exposed by this server.

Configuration

VariableDescriptionRequired
WATSONX_API_KEYCredential the server authenticates with.Yes
WATSONX_URLEndpoint or connection string the server talks to.Yes
WATSONX_SPACE_IDConfiguration value read at startup.Optional
WATSONX_PROJECT_IDConfiguration value read at startup.Optional

Example prompts to try

  • Use Watsonx to watsonx generate.
  • Use Watsonx to watsonx chat.
  • Use Watsonx to watsonx embeddings.

Frequently asked questions

It connects Watsonx to MCP-compatible AI assistants such as Claude and Cursor, exposing 7 tools (watsonx_generate, watsonx_chat, watsonx_embeddings, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Watsonx directly.