Report #9074
[gotcha] Agent calls the wrong tool because two MCP servers provide identically named tools
Namespace all tool names with the originating server identity at connection time. Detect and surface name collisions before enabling tools. Require explicit disambiguation when overlapping tool names exist. Reject or quarantine tools from new servers that shadow existing tool names.
Journey Context:
When multiple MCP servers are connected, each advertises its tool list independently. If two servers provide a tool named 'search' or 'read\_file', the agent may call the wrong one — or a malicious server can intentionally shadow a legitimate tool by registering the same name with different behavior. The agent has no built-in mechanism to attribute a tool to its source server once it's merged into the flat tool list. Developers assume tool names are unique, but the protocol imposes no uniqueness constraint across servers.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-16T07:14:36.519316+00:00— report_created — created