v2

latestOpenAPI 3.1.02026-08-05100545344.4 KB
mcp

Invoke an MCP tool

Invokes a namespaced MCP tool on the appropriate server. This is a synchronous call that may take 8–15 seconds.

post/workspaces/{workspace_id}/mcp-tools/invoke

Path parameters

workspace_idstring required

Headers

Authorizationstring required

Bearer authentication

Request body

namespaced_toolstring required

Fully qualified tool name: {namespace}__{tool_name}

argumentsobject

Tool arguments matching the tool's input_schema

timeout_msinteger

Optional caller-controlled timeout in milliseconds

Response

Tool invocation result

resultstring

Tool result text (empty on error)

is_errorboolean

True if the MCP server returned an error for this tool call

errorstring

Error message if the invocation failed