WxO Agent MCP

Invoke a Watson Orchestrate agent via MCP. Configure with WO_AGENT_ID.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "wxo-agent-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "wxo-agent-mcp"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

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

Code

                    ┌───────────────────────────────────────┐
                    │  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):

env

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

Terminal

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

bash

# 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-mcp folder in VS Code.
Run npm run build.
.vscode/mcp.json registers 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 calling get_agent first.
Or run npm run test:verify from 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`)

config.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:

config.json

{
    "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:

config.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 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

License

Apache-2.0

Read the full README →View source on GitHub →

Related MCP Servers

View all in Developer Tools View all alternatives

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about WxO Agent MCP

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "wxo-agent-mcp": { "command": "npx", "args": ["-y", "WxO Agent MCP"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/wxo-agent-mcp?style=directory)](https://allmcps.com/mcp/wxo-agent-mcp)

HTML Embed

<a href="https://allmcps.com/mcp/wxo-agent-mcp"><img src="https://allmcps.com/api/badge/wxo-agent-mcp?style=directory" alt="WxO Agent MCP on AllMCPs" /></a>

Technical Specs & Signals

CategoryDeveloper Tools

27Quality signal: Emerging · 27/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership8/20

Documentation & tools11/30

Adoption & activity1/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

★ Featured

Moxie Docs MCP

MCP & Agent Skills for Automated Documentation, and codebase conventions + context

Explore Server →

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💻 Developer Tools →Best MCP servers for Developers →Alternatives to WxO Agent MCP →Install in Claude Desktop Install in Cursor Install in VS Code

WxO Agent MCP

Invoke a Watson Orchestrate agent via MCP. Configure with WO_AGENT_ID.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "wxo-agent-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "wxo-agent-mcp"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

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

Code

                    ┌───────────────────────────────────────┐
                    │  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):

env

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

Terminal

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

bash

# 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-mcp folder in VS Code.
Run npm run build.
.vscode/mcp.json registers 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 calling get_agent first.
Or run npm run test:verify from 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`)

config.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:

config.json

{
    "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:

config.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 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

License

Apache-2.0

Read the full README →View source on GitHub →

Related MCP Servers

View all in Developer Tools View all alternatives

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about WxO Agent MCP

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "wxo-agent-mcp": { "command": "npx", "args": ["-y", "WxO Agent MCP"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/wxo-agent-mcp?style=directory)](https://allmcps.com/mcp/wxo-agent-mcp)

HTML Embed

<a href="https://allmcps.com/mcp/wxo-agent-mcp"><img src="https://allmcps.com/api/badge/wxo-agent-mcp?style=directory" alt="WxO Agent MCP on AllMCPs" /></a>

Technical Specs & Signals

CategoryDeveloper Tools

27Quality signal: Emerging · 27/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership8/20

Documentation & tools11/30

Adoption & activity1/15

Community engagement0/10

★ Featured

Moxie Docs MCP

MCP & Agent Skills for Automated Documentation, and codebase conventions + context

Explore Server →

Own this project?

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💻 Developer Tools →Best MCP servers for Developers →Alternatives to WxO Agent MCP →Install in Claude Desktop Install in Cursor Install in VS Code

WxO Agent MCP

Quick Install

Client Config & Setup

Documentation Overview

WxO Agent MCP

Architecture

Tools

Configuration

Quick Start

Verify

Test in VS Code

MCP Client Configuration

One-click install (Cursor Directory)

Cursor (.cursor/mcp.json)

VS Code Copilot (.vscode/mcp.json)

Antigravity

vs wxo-builder-mcp-server

Links

License

Related MCP Servers

Reviews

Frequently Asked Questions about WxO Agent MCP

AllMCPs Directory Badge

Technical Specs & Signals

Moxie Docs MCP

Own this project?

Share & Embed

Explore more

WxO Agent MCP

Quick Install

Client Config & Setup

Documentation Overview

WxO Agent MCP

Architecture

Tools

Configuration

Quick Start

Verify

Test in VS Code

MCP Client Configuration

One-click install (Cursor Directory)

Cursor (.cursor/mcp.json)

VS Code Copilot (.vscode/mcp.json)

Antigravity

vs wxo-builder-mcp-server

Links

License

Related MCP Servers

Reviews

Frequently Asked Questions about WxO Agent MCP

AllMCPs Directory Badge

Technical Specs & Signals

Moxie Docs MCP

Own this project?

Share & Embed

Explore more

Cursor (`.cursor/mcp.json`)

VS Code Copilot (`.vscode/mcp.json`)

Cursor (`.cursor/mcp.json`)

VS Code Copilot (`.vscode/mcp.json`)