Watson Orchestrate MCP server

Read from the package source without running it. The installed server may list more.

• assign_tool_to_agent

  Assign a tool to an agent (add to toolkit). Use tool_name or tool_id, agent_name or agent_id. For "assign REST Countries to TimeWeatherAgent" – use MCP, not ADK.

• configure_connection

  Configure connection credentials (api_key, basic, bearer)

• copy_skill

  Copy a tool. Creates a new tool with same spec and connection. Use new_name (e.g. "MVKWeatherV2") for a custom name. Names must use only letters, digits, underscores.

• create_agentwrite action

  Create an agent. Pass tools array to assign tool IDs.

• create_connectionwrite action

  Create a connection. Then use configure_connection for credentials.

• create_flowwrite action

  Create or update a flow

• create_tool_and_assign_to_agentwrite action

  Create a tool from URL and assign to agent – ONE step. Use for 'create REST Countries tool and assign to TimeWeatherAgent'. Works with public APIs (no auth) and APIs with keys. Use this MCP tool, do NOT use ADK.

• delete_agentwrite action

  Delete an agent by ID

• delete_connectionwrite action

  Delete a connection by app_id

• delete_flowwrite action

  Delete a flow by ID

• delete_skillwrite action

  Delete a skill by ID

• deploy_skillwrite action

  Deploy a tool from OpenAPI spec. Set openapi_spec["x-ibm-connection-id"] to bind a connection.

• deploy_tool_from_urlwrite action

  Create a tool from a URL. Works with: (1) APIs with API key – auto-creates connection, (2) Public APIs (REST Countries, Open-Meteo) – no auth needed. Use this MCP tool, NOT ADK.

• execute_toolwrite action

  Execute a Watson Orchestrate tool by name or ID. Use for prompts like "execute News Search Tool" or "run the Weather tool". Resolves tool names (e.g. "News Search Tool") to IDs, ensures an agent has the tool, then invokes it. Pass parameters as a JSON object if the tool requires them.

• get_agent

  Get agent details by ID. Returns config, assigned tools, instructions, and model.

• get_agent_chat_starter_settings

  Get chat starter settings for an agent: welcome message and quick prompts. Use agent_id or agent_name.

• get_api_spec

  Get the Watson Orchestrate OpenAPI spec. Describes all REST endpoints the MCP server uses (tools, agents, connections, flows, runs). Use to understand what operations the Watson Orchestrate instance supports.

• get_connection

  Get a connection by app_id

• get_flow

  Get a flow by ID

• get_skill

  Get a specific skill/tool by ID. Returns tool details including display name, description, and binding.

• invoke_agent

  Chat with an agent. Use agent_name (e.g. "TimeWeatherAgent") or agent_id. For "ask TimeWeatherAgent what the exchange rate is CAD/USD" – use agent_name and message. Runs behind the scenes, no script needed.

• list_active_live_connections

  List only active and live connections (not tools). Returns deduplicated connection names. Use for 'list all connections which are active and live, just the connections not the tools'.

• list_agent_tools

  List tools assigned to an agent, with display names and descriptions when available. Use agent_name (e.g. "TimeWeatherAgent") or agent_id. For "which tools are assigned to TimeWeatherAgent". Returns accurate tool list from Watson Orchestrate.

• list_agents

  List all available agents

• list_connections

  List configured connections (scope: draft, live, or all)

• list_connectors

  List available connector applications from the catalog

• list_flows

  List all available flows

• list_skills

  List all available tools/skills in the Watson Orchestrate catalog

• list_standard_tools

  List only standard tools (tools with no connections). Returns accurate count and list from Watson Orchestrate. Use for 'list standard tools' or 'tools with no connections' – tools with empty/missing security and connection_id. Do not guess; use this tool for accurate data.

• list_tools_with_connections

  List Watson Orchestrate tools grouped by connection status: tools that require an API key/OAuth connection vs standard tools. Matches the extension Tools view. Use for prompts like "list my tools with active connections".

• test_tool_local

  Test an API endpoint locally (direct HTTP GET). Use for "run locally" or "test locally". Does not go through Watson Orchestrate.

• update_agentwrite action

  Update an agent. Use agent_name (e.g. "TimeWeatherAgent") or agent_id. Pass payload with instructions, tools, description, style, welcome_message, quick_prompts. For "update TimeWeatherAgent instructions" use agent_name and payload: { instructions: "..." }. welcome_message and quick_prompts update chat starter settings.

• update_agent_chat_starter_settingswrite action

  Update chat starter settings: welcome_message, quick_prompts (array of {title, prompt}). Use agent_id or agent_name.

• update_agent_instructions_from_toolswrite action

  Update an agent's instructions based on its assigned tools. Fetches tools, builds helpful instructions, and patches the agent. Use for "update TimeWeatherAgent instructions based on its tools".

• update_skillwrite action

  Update a tool (name, display_name, description, permission)

• Code scan10 source files scanned25/25
• –Live reliabilityno gateway calls yet and no remote to proben/a
• –Tool poisoningtools not inspected (local package is not executed); not countedn/a
• Auth qualitystatic API keys via environment variables6/15
• Maintenancelast push 217 days ago4/15
• Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10

Safety score

66/100

higher than 23% of 48,255 servers

Tools

35

the typical server has 7

Tools that change things

43%

typical: 0%. Fewer write tools means less an agent can break

Downloads a week

20

more than 7% of 12,191 servers with a package

Watson Orchestrate: common questions

Is Watson Orchestrate MCP server safe?

With care: it is graded C, so read the findings first (66/100). Read the Watson Orchestrate safety report

How do I install Watson Orchestrate?

It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.

Does Watson Orchestrate need an API key?

Yes. The registry entry asks for WO_API_KEY.

Is Watson Orchestrate maintained?

The last commit was 254 days ago (2026-02-23). The latest release is v1.0.4.

How does Watson Orchestrate compare with other MCP servers?

safety score 66/100 (higher than 23% of 48,255 servers); tools 35 (the typical server has 7); tools that change things 43% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.