Protocols
Saved & recent

MCP tool invocation

Also called: tools/call, tool execution result

An MCP tool invocation requests a named operation with arguments. The 2026-07-28 tools/call method can return content for the host to consume and optional structured data. The host decides how to present or use that output; receiving tool text does not make it a higher-priority instruction.

For example, search_notes with query set to invoices could return matching note titles. A completed tool operation can report a domain failure through isError in its result, while an unknown tool can produce a protocol error. A completed result therefore needs interpretation, not merely a successful message exchange. Some operations instead request additional input before they can finish.

Read first
MCP tool discovery
Related
MCP tool discovery, MCP input requests, Idempotency key
Further reading
tools/call request name: search_notes query: invoices complete tool result titles: ["April invoices"] structuredContent: { count: 1 } call result host evaluates returned material tool-domain failure result envelope isError: true unknown tool JSON-RPC error envelope unknown tool name result-side error protocol error abbreviated message excerpts complete outcome example
A tool call returns an interpretable result; tool-level failures and protocol errors occupy different parts of the exchange.

View in the full Protocols collection