Same topic, related formats. Practice these next.
Same topic, related formats. Practice these next.
Click any words you think contain an error. Click again to unmark.
Two servers expose a tool named the same; without server-qualified prefixes the model cannot pick the right one, and routing by first-responder is non-deterministic.
Imagine two coworkers in an open office both named Sam. You shout 'Sam, file this!' and whoever turns around first grabs the document. Sometimes the right Sam takes it, sometimes the wrong one files it in the wrong cabinet. The fix is to use full names, 'GitHub Sam' and 'Jira Sam'. In an MCP host, two servers each expose a tool called search. If the host hands both to the model under the bare name search, the model has no way to say which one it means. Worse, routing the call to whichever server answers first is a coin flip. The host should rename the tools with a server prefix before the model ever sees them, so every call names exactly one target.
Everything you need to truly understand this topic: intuition, mechanics, step by step explanation, code, formulas, and worked example. Click to expand.
Everything you need to truly understand this topic: intuition, mechanics, step by step explanation, code, formulas, and worked example.
Everything important, quickly.
5 min: name the two bugs (colliding bare name plus first-responder routing), explain server-qualified prefixing at catalog-assembly time, then layer in descriptions and the shadowing risk.
| Approach | How the model addresses a tool | Routing outcome |
|---|---|---|
| Bare colliding names | Emits search, which maps to two servers | Ambiguous, host must guess |
| First-responder routing | Emits search, host picks fastest server | Non-deterministic, can mutate wrong service |
| Server-qualified prefixes | Emits github:search, names one server | Deterministic, one unambiguous target |
| Prefixes plus clear descriptions | Names one server and picks by capability | Deterministic and correct tool chosen |
Real products, models, and research that use this idea.
What an interviewer would ask next. Try answering before peeking at the approach.
Red flags and common mistakes that signal junior thinking. Click to expand.
Letting the host route a colliding tool call to whichever server responds first. That is non-deterministic and can mutate the wrong service silently.
The night-before-the-interview bullets. Scan these on the way to the call.
Primary sources. Skim if you want the original framing.