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
- Further reading
- MCP — tools, revision 2026-07-28