WxO Agent MCP

WxO Agent MCP

Servidor MCP (Model Context Protocol) simple que invoca un único agente de Watson Orchestrate de forma remota. El agente se define una vez mediante variables de entorno o configuración de MCP.

Úsalo cuando necesites un MCP ligero que solo chatee con un agente: sin gestión de herramientas, sin listado de agentes, sin flujos. Solo invoke_agent(message) y get_agent().

Documentación completa: DOCUMENTATION.md (incluye capturas de pantalla para VS Code y Langflow).
Publicación: PUBLISHING.md – procedimiento para npm y MCP Registry.

Arquitectura

                    ┌───────────────────────────────────────┐
                    │  Cursor • VS Code • Langflow • etc.   │
                    │  (MCP clients)                        │
                    └──────────────────┬───────────────────┘
                                       │ stdio / JSON-RPC
                                       ▼
                    ┌───────────────────────────────────────┐
                    │  wxo-agent-mcp                        │
                    │  invoke_agent • get_agent              │
                    └──────────────────┬───────────────────┘
                                       │ HTTP / REST
                                       ▼
                    ┌───────────────────────────────────────┐
                    │  Watson Orchestrate                   │
                    │  agent + tools + LLM                   │
                    └───────────────────────────────────────┘

Herramientas

Herramienta	Descripción
invoke_agent	Envía un mensaje al agente de Watson Orchestrate configurado. El agente responde usando sus herramientas y LLM.
get_agent	Obtiene detalles del agente configurado (nombre, descripción, herramientas, instrucciones).

Configuración

Configúralas en .env o en la configuración de tu cliente MCP (p. ej., 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)

Inicio rápido

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

Verificación

# 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?"

Ejecuta get_agent y invoke_agent para confirmar la conectividad.

Probar en VS Code

1. Abre la carpeta wxo-agent-mcp en VS Code.
2. Ejecuta npm run build.
3. .vscode/mcp.json registra el servidor MCP como wxo-agent y carga .env.
4. Abre Copilot Chat (Ctrl+Shift+I) y pregunta: Usa invoke_agent para preguntar: ¿Qué tiempo hace en Ámsterdam?
   Para "qué puedes hacer", usa Usa invoke_agent para preguntar: ¿Qué puedes hacer? para evitar que Copilot llame a get_agent primero.
5. O ejecuta npm run test:verify desde la terminal (Ctrl+`).

Consulta DOCUMENTATION.md para más indicaciones y configuración.

Ejemplos de preguntas: Lista completa →

invoke_agent	get_agent
¿Qué tiempo hace en Ámsterdam?	Usa get_agent para mostrar detalles del agente
Cuéntame un chiste de papás	¿Qué herramientas tiene mi agente?
¿Qué hora es en Tokio?
¿Con qué puedes ayudarme?

Langflow: Añade un componente MCP Tools, elige STDIO, establece Command=node, Args=["/path/to/dist/index.js"] y las variables de entorno. Consulta DOCUMENTATION.md.

Configuración del cliente MCP

Instalación con un clic (Cursor Directory)

Añadir a Cursor — Abre la página de Cursor Directory. Después de añadirlo, configura WO_API_KEY, WO_INSTANCE_URL y WO_AGENT_ID en la configuración de MCP de Cursor.

Para el envío a cursor.directory/mcp/new:

Campo	Valor
Cursor Deep Link	cursor://anysphere.cursor-deeplink/mcp/install?name=WxO%20Agent%20MCP&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsInd4by1hZ2VudC1tY3AiXSwiZW52Ijp7IldPX0FQSV9LRVkiOiJ5b3VyLWFwaS1rZXkiLCJXT19JTlNUQU5DRV9VUkwiOiJodHRwczovL3lvdXItaW5zdGFuY2Uub3JjaGVzdHJhdGUuaWJtLmNvbSIsIldPX0FHRU5UX0lEIjoieW91ci1hZ2VudC1pZCJ9fQ==
Instrucciones de instalación	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)

El servidor se llama wxo-agent. Usa envFile para cargar .env:

{
    "servers": {
        "wxo-agent": {
            "type": "stdio",
            "command": "node",
            "args": ["${workspaceFolder}/dist/index.js"],
            "envFile": "${workspaceFolder}/.env"
        }
    }
}

Para npx (después de publicar), usa "command": "npx", "args": ["-y", "wxo-agent-mcp"] y añade env con tus credenciales.

Antigravity

Misma configuración que Cursor. Copia examples/antigravity-mcp.json o añádelo a tu configuración de MCP:

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

Comparación con wxo-builder-mcp-server

	wxo-agent-mcp	wxo-builder-mcp-server
Propósito	Invocar un agente	Kit de desarrollo completo (herramientas, agentes, conexiones, flujos)
Agente	Un único WO_AGENT_ID	Múltiples agentes, WO_AGENT_IDs
Herramientas	invoke_agent, get_agent	Más de 30 herramientas (list_skills, deploy_tool, etc.)
Caso de uso	Chatear con un agente específico	Crear y gestionar recursos de Watson Orchestrate

Enlaces

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

Licencia

Apache-2.0