Skip to content

AAK-TOOL-NEAR-DUPLICATE-001: Two configured servers offer tools with nearly the same name

Severity
MEDIUM
Category
Tool Poisoning (tool-poisoning)
Scanner
agent_audit_kit/scanners/mcp_tool_names.py
Auto-fixable
No.
SARIF name
ToolNearDuplicateName

What it detects

A pin file or an MCP config that lists tools has two tools on different servers whose names differ only in a flourish (flight_search_pro beside flight_search), in how they are written (readFile beside read_file) or by one character. Selection is a model reading each description, which each server's author writes, so a similarly named tool with a stronger description can win calls meant for the other one, and no rule on either tool alone sees it.

How to fix

Decide which tools this agent may bind at all, and keep the other server's tool out with an allowlist at the client. Rename your own tool if the overlap is yours. Pin tool definitions with aak pin, so a new near-duplicate shows up as a change.

To confirm the finding is gone, report only this rule:

agent-audit-kit scan . --rules AAK-TOOL-NEAR-DUPLICATE-001

Limitations

Reads tool names from .agent-audit-kit/tool-pins.json and from a tools list in a JSON MCP config. A config with no list has nothing to read, and a server is never asked for its tools. On 442 public .mcp.json files that name Playwright or chrome-devtools-mcp the rule had nothing to report, so it has only fixtures behind it so far. The same exact name on two servers is left out, since clients namespace tools by server, and that may not hold for yours. A flourish is pro, plus, premium, new, official, enhanced, advanced, ultra, best, fast, secure, verified, better, improved, real, true, v2, v3, 2 or 3, at the start or the end of the name, so one in the middle is missed. One character apart counts for a name of 8 to 64 letters after joining its words, leaving out a plural s, so a shorter or a longer name, and two characters apart, are missed. A file reports at most 200 pairs.

References

  • OWASP MCP Top 10: MCP03:2025 (Tool Poisoning)
  • OWASP Agentic Top 10: ASI02 (Tool Misuse and Exploitation)
  • Adversa AI MCP Top 25 (AAK-defined ids): ADV-INJECT-04 (Tool Param Shell Injection)

All rules. This page is generated from the rule registry when the documentation is built; to change it, change the rule in agent_audit_kit/rules/builtin.py. To give the rule a hand-written write-up, add docs/rules/AAK-TOOL-NEAR-DUPLICATE-001.md: the page then shows that text, with the registry reference appended under it.