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.

List all available tools/skills in the Watson Orchestrate catalog

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

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.

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 a specific skill/tool by ID. Returns tool details including display name, description, and binding.

Delete a skill by ID

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

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

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

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.

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.

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

List all available agents

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

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

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

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

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.

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

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

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.

Delete an agent by ID

List available connector applications from the catalog

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

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

Get a connection by app_id

Create a connection. Then use configure_connection for credentials.

Delete a connection by app_id

Configure connection credentials (api_key, basic, bearer)

List all available flows

Create or update a flow

Get a flow by ID

Delete a flow by ID