detections
- ID: SDT012
- Created: 26th August 2026
- Updated: 26th August 2026
- Contributors: Nimer Kees, Yonatan Machluf, The ITM Team,
Model Context Protocol Tool Definition Integrity Monitoring
Model Context Protocol (MCP) tool definition integrity monitoring detects changes to the model-visible metadata that shapes how a synthetic subject understands and uses connected MCP tools. The detection covers tool descriptions, server instructions, parameter text, input schemas, prompt templates, resource descriptions, and tool-discovery responses.
Implementation
Capture and hash the full MCP tool-definition surface at connection time, approval time, and session start. This should include tool name, description, parameters, input schema, server instructions, prompt templates, resource descriptors, version metadata, and tools/list payloads, which are the tool-discovery responses returned by an MCP server when the client asks what tools are available.
Compare the current MCP definition surface against the last approved or trusted baseline. Perform explicit text and schema diffs between sessions, across reconnects, after server updates, and during long-running synthetic subject sessions where tools can be refreshed. Alert when tool descriptions, parameters, schemas, server instructions, prompt templates, resource descriptions, or tool-discovery responses change without an approved change record.
Detect rug-pull patterns by identifying MCP tools that were trusted or approved under one definition and later altered before or during use. Detect tool shadowing by identifying definitions that rename, redefine, override, impersonate, or semantically conflict with another tool. Also alert when one MCP server’s metadata appears to influence the selection, interpretation, or use of tools exposed by another server.
Treat any unapproved change to the MCP tool-definition surface as an alertable event. For running synthetic subjects, suspend or require re-approval before the changed tool is used. For conversational connectors, compare between-session MCP context so that a tool rewritten after approval is surfaced rather than silently absorbed.
Investigative Use
This detection supports investigation of MCP tool poisoning, connect-time tool metadata invocation, poisoned tool descriptions, rug-pull attacks, cross-server tool shadowing, and unexpected tool use. It helps investigators determine whether the synthetic subject acted under the tool definition that was originally approved or under a later altered definition.
It is especially useful where a connected MCP server changes descriptions, schemas, server instructions, or tool-discovery metadata after the synthetic subject has already trusted the tool or incorporated it into its operating context.
Sections
| ID | Name | Description |
|---|---|---|
| CF002 | Connected Tools and Functions | Connected tools and functions are the plugins, connectors, functions, application programming interfaces, and Model Context Protocol (MCP) servers made available to a synthetic subject. MCP is an integration pattern that allows a synthetic subject to discover and use external tools, data sources, and actions through a structured interface.
This configuration creates an elevated exposure condition because connected tools define what the synthetic subject can do beyond text generation. A tool may allow it to read records, send messages, update systems, retrieve files, call APIs, execute commands, or transmit data outside the immediate application.
The primary risk is unsafe tool trust. Tool names, descriptions, schemas, parameters, outputs, and server definitions may influence how the synthetic subject chooses and uses tools. If these definitions are changed, poisoned, impersonated, or poorly governed, the synthetic subject may call the wrong tool, pass sensitive data to an unsafe tool, or perform an action outside its approved purpose.
Investigators should review connected tool inventories, MCP server records, tool definitions, schemas, descriptions, permissions, version history, provenance, tool-call logs, runtime egress, and change approvals. Particular attention should be given to newly added tools, changed descriptions or schemas, shadowed tool names, unexpected destinations, and tool calls that cannot be attributed to an approved configuration.
Investigative RelevanceConnected tools and functions are relevant because they convert a synthetic subject from an advisory system into an actor with operational capability. The configuration of tools determines whether the synthetic subject can only answer, or whether it can retrieve, modify, send, execute, or integrate across systems.
This section is especially relevant where synthetic subjects use marketplace tools, plugins, MCP servers, internal functions, SaaS connectors, email tools, database tools, cloud APIs, command execution tools, or externally supplied tool runtimes. |
| IV004 | MCP Invocation | Model Context Protocol (MCP) invocation occurs when a synthetic subject is caused to act, change behavior, select tools, or continue a workflow through MCP-supplied content. MCP is an integration pattern that allows a synthetic subject to discover and use external tools, data sources, and actions through a structured interface.
This invocation creates an elevated exposure condition because MCP servers can supply model-visible information before, during, and after tool use. Tool descriptions, server instructions, schemas, tool outputs, resource content, sampling requests, prompts, and connector metadata may all enter the synthetic subject’s context and influence its behavior.
The primary risk is protocol-mediated instruction flow. The synthetic subject may treat MCP-supplied text as trusted operational context even when it originates from a third-party server, compromised connector, unapproved tool, or attacker-influenced resource. This may cause the synthetic subject to call tools, disclose information, change reasoning, prefer malicious servers, or pass sensitive context across boundaries.
Investigators should review MCP server inventory, tool definitions, server instructions, schemas, tool-list responses, resource reads, sampling requests, prompt templates, tool outputs, connection history, version changes, and tool-call logs. Particular attention should be given to instruction-bearing metadata, changed tool descriptions, untrusted server output, cross-server influence, and behavior that begins when an MCP server connects or returns content.
Investigative RelevanceMCP invocation is relevant because MCP can introduce instructions into a synthetic subject through several protocol surfaces, not only through executed tool calls. A synthetic subject may be influenced when a server connects, when tools are listed, when resources are read, when prompts are supplied, or when tool output is returned.
This section is especially relevant where synthetic subjects connect to MCP servers, tool registries, marketplace connectors, local developer tools, SaaS integrations, filesystem tools, browser tools, or third-party agent tool platforms. |
| CF002.002 | Changed Tool Definition | Changed tool definition occurs when a connected tool’s name, description, schema, parameters, permissions, or server definition changes after approval. This may occur through a vendor update, package update, configuration change, or replacement Model Context Protocol (MCP) server.
This configuration creates an elevated exposure condition because synthetic subjects rely on tool definitions to decide when and how to use tools. A changed description or schema may alter tool selection, input handling, output routing, or the apparent purpose of the tool.
The primary risk is post-approval behavior drift. A tool approved for one purpose may later behave differently, request different inputs, expose new actions, or direct the synthetic subject toward unsafe use without a full review.
Investigators should review tool definition history, package versions, MCP server manifests, approval records, schema changes, descriptions, parameters, and tool-call patterns before and after the change. Particular attention should be given to changed descriptions, added parameters, new external destinations, and tools that changed without re-approval.
Investigative RelevanceChanged tool definitions are relevant because tool behavior can shift after the organization has accepted the integration. This sub-section is especially relevant where connected tools update automatically, use remote schemas, or depend on vendor-managed metadata. |
| CF002.003 | Poisoned Tool Description | Poisoned tool description occurs when a connected tool’s description, metadata, schema, or usage instructions contain hidden or adversarial instructions that influence the synthetic subject. These instructions may be visible to the model during tool selection but hidden, truncated, or unclear to the human reviewer.
This configuration creates an elevated exposure condition because tool descriptions are not passive documentation. They may enter the model’s context and affect which tool is selected, what data is passed to it, and how the synthetic subject behaves before or after the call.
The primary risk is metadata-driven manipulation. A synthetic subject may disclose secrets, call unsafe tools, pass sensitive data, or perform unauthorized actions because the tool description instructs it to do so.
Investigators should review tool descriptions, metadata, schemas, client display behavior, hidden text, encoded content, prompt-like language, and tool-call logs. Particular attention should be given to descriptions containing instructions to ignore rules, access sensitive files, forward data, or prefer one tool over another.
Investigative RelevancePoisoned tool descriptions are relevant because the attack surface may sit in tool metadata rather than user prompts or tool code. This sub-section is especially relevant where tools are installed from marketplaces, open registries, third-party repositories, or MCP servers managed outside the organization. |
| CF002.004 | Impersonating Tool Package | Impersonating tool package occurs when a connected tool, plugin, package, or Model Context Protocol (MCP) server presents itself as a trusted integration while being operated, published, or modified by an unauthorized or malicious supplier.
This configuration creates an elevated exposure condition because the synthetic subject and the deploying team may trust the tool based on its name, description, repository appearance, or apparent relationship to a legitimate service.
The primary risk is supplier impersonation. An impersonating package may receive sensitive inputs, send messages, call APIs, or exfiltrate data while appearing to be an approved or official tool.
Investigators should review package names, publishers, repository ownership, signatures, download sources, version history, dependency changes, marketplace records, and tool-call logs. Particular attention should be given to lookalike names, recently transferred ownership, sudden behavior changes, and tools that mimic official vendor integrations.
Investigative RelevanceImpersonating tool packages are relevant because synthetic subjects may use third-party tools with high trust and high permissions. This sub-section is especially relevant where agents rely on public package registries, marketplace listings, MCP servers, or community-maintained connectors. |
| CF012.002 | Third-Party Tool Agent Platform | A third-party tool agent platform is a standalone artificial intelligence agent platform connected to external tools through marketplaces, plugins, connectors, or Model Context Protocol (MCP) servers. MCP servers provide a standardized way for agents to access external tools, data sources, and actions. Each connected tool may allow the agent to read data or perform actions such as sending email, calling application programming interfaces (APIs), updating records, or retrieving files.
This deployment pattern creates an elevated exposure condition because every added tool becomes another supplier in the trust chain. The organization may approve the agent platform, but each marketplace tool, connector, or MCP server introduces its own permissions, update path, dependencies, and operator.
The primary risk is tool-mediated compromise. A connected tool may become malicious through a silent update, impersonating package, compromised dependency, weak marketplace review, or supplier compromise. Once connected, the tool may act through the agent’s authority and access organizational data or systems on the agent’s behalf.
A related risk is attribution failure. Harmful activity may appear to originate from the agent platform, while the actual cause sits inside a specific tool, connector, package, or MCP server. If logs do not preserve tool-level provenance, investigators may be unable to determine which supplier component read the data, sent the message, called the API, or caused the adverse outcome.
Investigators should review the agent platform’s directive, installed tools, marketplace sources, MCP servers, connector permissions, package provenance, update history, tool-call logs, outbound destinations, and vendor audit records. Particular attention should be given to newly added tools, recently updated packages, impersonating names, unexpected email or API actions, and cases where activity cannot be attributed to a specific connected tool.
Investigative RelevanceThird-party tool agent platforms are relevant because they extend organizational trust beyond the agent vendor to every connected tool in the platform ecosystem. A tool added for convenience may become a separate operational actor with access to sensitive data and action capability.
This sub-section is especially relevant where a standalone agent platform can install marketplace tools, connect to MCP servers, send mail, call APIs, read documents, access customer data, update SaaS records, or execute workflow actions through third-party integrations. |
| IV004.001 | Connect-Time Tool Metadata Invocation | Connect-time tool metadata invocation occurs when a synthetic subject is influenced by tool, connector, or Model Context Protocol (MCP) metadata at the moment the tool is made available. MCP is an integration pattern that allows a synthetic subject to discover and use external tools, data sources, and actions through a structured interface.
This invocation does not require the tool to be called. The triggering content may appear in the tool description, server instructions, schema, parameter text, tool list, or other metadata loaded into the synthetic subject’s context during connection or discovery. Once that metadata is visible to the model, it may function as an instruction source.
This creates an elevated exposure condition because the synthetic subject may change behavior before any observable tool execution occurs. A malicious or compromised connector may instruct the synthetic subject to prefer a certain tool, ignore competing tools, request sensitive data, disclose information, alter its reasoning, or prepare a later action before the operator has approved any tool call.
The primary risk is line jumping. The connector-supplied metadata enters the instruction context ahead of the normal approval point, allowing it to influence the synthetic subject before a human reviews a specific action. Human approval may then become ineffective because the synthetic subject has already been steered by the metadata it received at connection time.
A related risk is metadata drift. A tool or server may appear safe when first approved, then later change its description, schema, server instructions, or metadata. If those changes are not detected and re-approved, an already trusted connector can become a new invocation source without a new user prompt or tool execution.
Investigators should review the exact tool metadata loaded into context, tool descriptions, server instructions, schema fields, connector version history, MCP server responses, approval records, tool-list payloads, hidden characters, and behavior changes following connection. Particular attention should be given to instruction-like metadata, invisible Unicode, changed descriptions, cross-server tool shadowing, and behavioral shifts that correlate with connector enrollment rather than a user prompt.
Investigative RelevanceConnect-time tool metadata invocation is relevant because the triggering instruction may enter the synthetic subject before any tool use appears in ordinary logs. An investigation that reviews only executed tool calls may miss the earlier metadata that caused the synthetic subject to behave differently.
This section is especially relevant where synthetic subjects connect to MCP servers, plugins, marketplace tools, internal connectors, tool registries, tool discovery endpoints, or dynamically supplied function definitions. |
| IV004.005 | MCP Prompt Template Invocation | MCP prompt template invocation occurs when a prompt template supplied by an MCP server causes a synthetic subject to act. MCP prompt templates allow servers to provide structured messages and instructions for interacting with language models. Prompt templates can provide reusable instructions, workflows, or task structures that are exposed by a server and made available to the user or client.
This invocation creates an elevated exposure condition because a server-supplied prompt may carry instructions that appear operationally legitimate. The prompt template may define the task, request inputs, structure the workflow, select tools, or frame what the synthetic subject should do next.
The primary risk is server-supplied task steering. A malicious or compromised MCP prompt template may cause the synthetic subject to request sensitive data, invoke unsafe tools, disclose context, bypass policy, or route work through attacker-controlled resources while appearing to follow a normal workflow.
Investigators should review MCP prompt templates, prompt arguments, template provenance, server ownership, prompt version history, user selections, resulting model prompts, and downstream tool calls. Particular attention should be given to prompt templates that request secrets, route data externally, override standing instructions, or cause tool use beyond the apparent task.
Investigative RelevanceMCP prompt template invocation is relevant because the instruction source may be a reusable prompt supplied by a server rather than a direct user instruction. The operator may select a prompt template without understanding the full model-visible instruction it contains.
This sub-section is especially relevant where MCP servers expose slash-command-style workflows, reusable prompts, coding templates, investigation templates, automation prompts, or task-specific prompt libraries. |
| IV004.006 | Cross-Server Tool Shadowing Invocation | Cross-server tool shadowing invocation occurs when one MCP server supplies metadata that changes how a synthetic subject interprets, selects, or uses tools from another MCP server. The malicious or compromised server may not need to provide the tool that performs the harmful action; it may only need to influence how the synthetic subject uses a trusted tool.
This invocation creates an elevated exposure condition because trust boundaries between MCP servers may collapse inside the model context. A low-trust server may insert instructions that cause the synthetic subject to prefer, avoid, misuse, or reinterpret tools exposed by a separate trusted server. The primary risk is cross-server influence. A malicious MCP server may shadow a trusted tool name, redefine expected behavior, inject instructions about another server’s tools, or cause sensitive data to be routed through the wrong tool. The operator may believe the synthetic subject is using an approved integration while its tool selection has been influenced by another server’s metadata.
Investigators should review MCP server inventories, tool namespaces, tool names, descriptions, schemas, server instructions, tool-list responses, connection order, and cross-server tool-call behavior. Particular attention should be given to duplicate tool names, instruction-bearing descriptions referring to other tools, newly connected servers, changed metadata, and tool calls whose selection does not match the operator’s request.
Investigative RelevanceCross-server tool shadowing invocation is relevant because the effective instruction may originate from a different server than the tool ultimately used. The investigation must reconstruct the full MCP context, not only the tool that performed the final action.
This sub-section is especially relevant where synthetic subjects connect to multiple MCP servers, local developer tools, vendor connectors, marketplace servers, filesystem tools, communication tools, or mixed-trust tool registries. |