WxO Agent 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

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

1. Open the wxo-agent-mcp folder in VS Code.
2. Run npm run build.
3. .vscode/mcp.json registers the MCP server as wxo-agent and loads .env.
4. 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 calling get_agent first.
5. Or run npm run test:verify from the terminal (Ctrl+`).

See DOCUMENTATION.md for more prompts and setup.

Question examples: Full list →

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](https://cursor.directory/mcp/wxo-agent-mcp) — 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](https://cursor.directory/mcp/new) submission:

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

Links

• npm: wxo-agent-mcp
• MCP Registry: io.github.markusvankempen/wxo-agent-mcp
• GitHub: markusvankempen/wxo-agent-mcp

License

Apache-2.0