Summary
Lightweight wrapper for invoking a single Watson Orchestrate agent over MCP. You configure one agent ID via environment variables, then get two tools: invoke_agent to send messages and get responses back through the agent's LLM and toolchain, and get_agent to inspect what the agent can do. This is the minimal version if you just want to chat with one WxO agent from Cursor, VS Code, or Langflow without the full builder toolkit. The agent handles its own tools and orchestration on the IBM side. You're just piping conversational input and output through stdio. If you need to manage multiple agents or deploy new skills, look at wxo-builder-mcp-server instead.
Fastest browser for AI agents to run web automation tasks, always free.
Download Free life-time →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →
WxO Agent MCP
Simple MCP (Model Context Protocol) server that invokes a single Watson Orchestrate agent remotely. The agent is defined once via environment variables or MCP config.
Use this when you want a lightweight MCP that only chats with one agent—no tool management, no agent listing, no flows. Just invoke_agent(message) and get_agent().
Full documentation: DOCUMENTATION.md (includes screenshots for VS Code and Langflow).
Publishing: PUBLISHING.md – npm and MCP Registry procedure.
Architecture
┌───────────────────────────────────────┐
│ Cursor • VS Code • Langflow • etc. │
│ (MCP clients) │
└──────────────────┬───────────────────┘
│ stdio / JSON-RPC
▼
┌───────────────────────────────────────┐
│ wxo-agent-mcp │
│ invoke_agent • get_agent │
└──────────────────┬───────────────────┘
│ HTTP / REST
▼
┌───────────────────────────────────────┐
│ Watson Orchestrate │
│ agent + tools + LLM │
└───────────────────────────────────────┘
Tools
| Tool | Description |
|---|---|
| invoke_agent | Send a message to the configured Watson Orchestrate agent. The agent responds using its tools and LLM. |
| get_agent | Get details of the configured agent (name, description, tools, instructions). |
Configuration
Set these in .env or your MCP client config (e.g. Cursor mcp.json):
WO_API_KEY=your-ibm-cloud-api-key
WO_INSTANCE_URL=https://your-instance-id.orchestrate.ibm.com
WO_AGENT_ID=your-agent-id
# Or WO_AGENT_IDs=id1,id2 (first is used)
Quick Start
npm install
npm run build
cp .env.example .env
# Edit .env with your credentials and agent ID
WO_API_KEY=... WO_INSTANCE_URL=... WO_AGENT_ID=... node dist/index.js
Verify
# Default question ("Hello, who are you?")
WO_API_KEY=... WO_INSTANCE_URL=... WO_AGENT_IDs=... npm run test:verify
# Custom question
npm run test:verify -- -ask "What is the weather in Amsterdam?"
Runs get_agent and invoke_agent to confirm connectivity.
Test in VS Code
- Open the
wxo-agent-mcpfolder in VS Code. - Run
npm run build. .vscode/mcp.jsonregisters the MCP server as wxo-agent and loads.env.- Open Copilot Chat (Ctrl+Shift+I) and ask: Use invoke_agent to ask: What is the weather in Amsterdam?
For "what can you do", use Use invoke_agent to ask: What can you do? to avoid Copilot callingget_agentfirst. - Or run
npm run test:verifyfrom the terminal (Ctrl+`).
See DOCUMENTATION.md for more prompts and setup.
Question examples: Full list →
| invoke_agent | get_agent |
|---|---|
| What is the weather in Amsterdam? | Use get_agent to show agent details |
| Tell me a dad joke | What tools does my agent have? |
| What time is it in Tokyo? | |
| What can you help me with? |
Langflow: Add an MCP Tools component, choose STDIO, set Command=node, Args=["/path/to/dist/index.js"], and env vars. See DOCUMENTATION.md.
MCP Client Configuration
One-click install (Cursor Directory)
Add to Cursor — Opens the Cursor Directory page. After adding, set WO_API_KEY, WO_INSTANCE_URL, and WO_AGENT_ID in Cursor MCP settings.
For cursor.directory/mcp/new submission:
| Field | Value |
|---|---|
| Cursor Deep Link | cursor://anysphere.cursor-deeplink/mcp/install?name=WxO%20Agent%20MCP&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsInd4by1hZ2VudC1tY3AiXSwiZW52Ijp7IldPX0FQSV9LRVkiOiJ5b3VyLWFwaS1rZXkiLCJXT19JTlNUQU5DRV9VUkwiOiJodHRwczovL3lvdXItaW5zdGFuY2Uub3JjaGVzdHJhdGUuaWJtLmNvbSIsIldPX0FHRU5UX0lEIjoieW91ci1hZ2VudC1pZCJ9fQ== |
| Install instructions | https://github.com/markusvankempen/wxo-agent-mcp#mcp-client-configuration |
Cursor (.cursor/mcp.json)
{
"mcpServers": {
"wxo-agent": {
"command": "npx",
"args": ["-y", "wxo-agent-mcp"],
"env": {
"WO_API_KEY": "your-api-key",
"WO_INSTANCE_URL": "https://xxx.orchestrate.ibm.com",
"WO_AGENT_ID": "your-agent-id"
}
}
}
}
VS Code Copilot (.vscode/mcp.json)
The server is named wxo-agent. Use envFile to load .env:
{
"servers": {
"wxo-agent": {
"type": "stdio",
"command": "node",
"args": ["${workspaceFolder}/dist/index.js"],
"envFile": "${workspaceFolder}/.env"
}
}
}
For npx (after publishing), use "command": "npx", "args": ["-y", "wxo-agent-mcp"], and add env with your credentials.
Antigravity
Same config as Cursor. Copy examples/antigravity-mcp.json or add to your MCP config:
{
"mcpServers": {
"wxo-agent": {
"command": "npx",
"args": ["-y", "wxo-agent-mcp"],
"env": {
"WO_API_KEY": "your-api-key",
"WO_INSTANCE_URL": "https://xxx.orchestrate.ibm.com",
"WO_AGENT_ID": "your-agent-id"
}
}
}
}
vs wxo-builder-mcp-server
| wxo-agent-mcp | wxo-builder-mcp-server | |
|---|---|---|
| Purpose | Invoke one agent | Full dev toolkit (tools, agents, connections, flows) |
| Agent | Single WO_AGENT_ID | Multiple agents, WO_AGENT_IDs |
| Tools | invoke_agent, get_agent | 30+ tools (list_skills, deploy_tool, etc.) |
| Use case | Chat with a specific agent | Build and manage Watson Orchestrate resources |
Links
- npm: wxo-agent-mcp
- MCP Registry: io.github.markusvankempen/wxo-agent-mcp
- GitHub: markusvankempen/wxo-agent-mcp
License
Apache-2.0
Featured
Fastest browser for AI agents to run web automation tasks, always free.
Download Free life-time →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →Configuration
WO_API_KEY*secretIBM Cloud API key for Watson Orchestrate
WO_INSTANCE_URL*Watson Orchestrate instance URL (e.g. https://xxx.orchestrate.ibm.com)
WO_AGENT_ID*Agent ID to invoke (or use WO_AGENT_IDs)
Categories
Registryactive
Packagewxo-agent-mcp
TransportSTDIO
AuthRequired
UpdatedFeb 22, 2026
