MCP Academy · Lesson

Avoid Tool Name Collisions

Namespace tools so they stay unambiguous.

Two Tools, One Name

When many servers share a host, two of them may both ship a tool called search. Now the model cannot tell which one you mean. ⚠️

Why Collisions Confuse

The model picks tools by name. If two entries read the same, it may call the wrong one, producing puzzling results. A collision quietly breaks routing.

All lessons in this course

  1. One Host, Many Servers
  2. Avoid Tool Name Collisions
  3. Server Registries & Discovery
  4. Compose Tools Across Servers
← Back to MCP Academy