v20

OpenAPI 3.1.0raw.githubusercontent.com2026-08-035471202.8 KB

Execution

Call a tool

Executes a tool on the server and returns the MCP CallToolResult directly. Tool-level failures (isError: true in the result) are successful calls — the server answered; only transport/auth errors use the error envelope.

post/projects/{projectId}/servers/{serverId}/tools/call

Path parameters

projectIdstring required

ID of the hosted project that contains the server.

serverIdstring required

ID of the server inside the project.

Request body

toolNamestring required

Tool name, exactly as returned by the tools list.

parametersobject

Tool arguments matching the tool's inputSchema. Defaults to {}.

Response

The MCP CallToolResult. Check isError for tool-level failures.

contentobject[] required

Content blocks (text, image, resource, ...).

structuredContentobject

Structured output matching the tool's outputSchema, when declared.

isErrorboolean

true when the tool reported a failure. The HTTP call still succeeds — the server answered.