Protocols
Saved & recent

MCP tool discovery

Also called: tools/list, tool input schema

Tool discovery tells an MCP client which named operations a server exposes and how to supply their arguments. In the inspected 2026-07-28 revision, tools/list returns tool descriptions and input schemas, with pagination when the catalog spans multiple pages. A tool description is information about an operation, not an execution of it.

A document service might advertise search_notes with a required query string. The client can use that schema to form a later call. Available tools may depend on the authorization supplied with the request, so one user’s catalog is not necessarily valid for another. Finding a tool also does not remove the server’s responsibility to authorize its eventual invocation.

Read first
Model Context Protocol
Related
MCP tool invocation, MCP authorization, MCP capability negotiation
Further reading
MCP — tools, revision 2026-07-28
client document service tools/list caller-visible catalogue page search_notes inputSchema query: string · required nextCursor · optional next page visibility depends on authorization later tools/call invocation outside discovery
Discovery describes the tools visible to this caller; a separate request invokes a selected operation.

View in the full Protocols collection