Join our Newsletter — 33% off our NHI Course

Model Context Protocol (MCP) tools/list

Model Context Protocol tools/list is a protocol method that returns the tools an MCP server makes available to a client. It is used by AI agents and other model clients to discover callable actions, their names, and any descriptions or input schemas before selecting a tool at runtime.

What tools/list means in MCP

In model context protocol, tools/list is the discovery step that tells a client which actions a server exposes, how each tool is named, and what input shape the server expects before the client decides what to call.

This matters because the list is not just metadata, it defines the action surface an agent can see at runtime. A misleading or incomplete tool catalogue can shape downstream behaviour just as much as a bad permission grant, especially when the client is selecting tools dynamically.

Why tool discovery matters for agents

For AI agents and other model clients, tools/list is the mechanism that converts a server into something actionable. It lets the client reason about capabilities without hardcoding integrations, but it also means the client is trusting the server to describe those capabilities accurately and consistently.

That trust boundary is important in MCP because tool names, descriptions and schemas influence tool selection, argument construction and prompt composition. If the listing is manipulated, stale, or too broad, the model may choose the wrong action or infer authority that the server should not have implied.

In practice, this is why MCP guidance often pairs discovery with controls over server provenance, approval and scope. The method is simple, but the security consequence is not.

How tools/list shapes runtime authorization

tools/list does not itself execute anything, but it strongly influences what will be executed next. A client that consumes the list without policy checks may surface tools that should be hidden, overstate trust in a remote server, or accept a tool schema that enables unsafe downstream calls.

For that reason, organisations should treat the listing as part of the control plane, not just a convenience API. A well-governed client compares discovered tools against allowed servers, approved tool sets and expected schemas before the agent is allowed to act.

When the MCP server is remote, the discovery response also becomes part of the supply chain of the interaction. If the server changes its tool surface without warning, the client may need change control or re-approval before relying on the new capability set.

Common failure modes and what they affect

Tool discovery failures usually show up as trust failures, not syntax failures. A server can advertise tools that are overly powerful, poorly described, duplicated under a confusing name, or inconsistent with prior responses, and the agent may still call them if the client trusts the list blindly.

Those failures can lead to tool misuse, confused-deputy behaviour, unintended data access, or actions that exceed the user’s intent. The problem is not only whether a tool exists, but whether the client can rely on the advertised surface as a faithful description of what is safe to invoke.

For that reason, discovery should be read alongside authentication, authorization and server governance, rather than treated as a neutral directory lookup.

Standards & Framework Alignment

This section maps relevant standards and security frameworks to the operational risks and controls described in this guidance.

OWASP Agentic AI Top 10 and OWASP API Security Top 10 address the attack and risk surface, while NIST SP 800-53 Rev 5 sets the governance and control requirements practitioners need to meet.

Framework Control / Reference Relevance
OWASP Agentic AI Top 10 ASI02 — Tool Misuse tools/list exposes callable agent tools that can be abused through unsafe selection
ASI03 — Identity & Privilege Abuse Tool discovery shapes what authority an agent can exercise through MCP
Recommendation — Apply ASI02 controls to restrict tool visibility and validate tool use before execution. Enforce ASI03 by binding discovered tools to least-privilege agent permissions and approval gates.
OWASP API Security Top 10 API9 — Improper Inventory Management tools/list is an API inventory of callable capabilities that must stay accurate
Recommendation — Maintain an accurate tool inventory and remove stale or unauthorized tools from exposure.
NIST SP 800-53 Rev 5 AC-6 — Least Privilege Tool discovery should not expose more authority than the client or user needs
IA-9 — Identification and Authentication (Non-Organizational Users) MCP clients often rely on server-to-server trust and authenticated access to remote tools
Recommendation — Limit discovered tools to the minimum capability set required for the task. Authenticate remote MCP servers and bind tool access to approved identities and tokens.

Practitioner Guidance

Why practitioners should care: Treat tools/list as a security-relevant discovery interface, not a passive inventory. In agentic systems, the quality of the tool catalogue directly affects least privilege, user intent alignment and the chance of unsafe tool selection.

What to watch for: Pay attention to unexpected tool additions, name changes, schema drift and servers that expose more capability than the client policy expects. Those are often the earliest signs that an MCP deployment needs re-review.

Practitioner takeaway: Pair every use of tools/list with an explicit trust decision, so the agent only sees tools that have been approved for that server, that purpose and that runtime context.