Skip to content

Commit 2fb4b32

Browse files
committed
docs(tools): expand on unique key for tool disambiguation
1 parent 41da03a commit 2fb4b32

File tree

1 file changed

+3
-1
lines changed

1 file changed

+3
-1
lines changed

docs/docs/concepts/tools.mdx

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -216,10 +216,12 @@ When implementing tools:
216216
### Tool name conflicts
217217

218218
MCP client applications and MCP server proxies may encounter tool name conflicts when building their own tool lists.
219-
To resolve these conflicts, we recommend maintaining a unique identifier (such as a config key, in the case of client applications) for each connected MCP server, and prefixing that to the tool name with `___` (three underscores) as a separator.
219+
To resolve these conflicts, we recommend maintaining a unique identifier for each connected MCP server, and prefixing that to the tool name with `___` (three underscores) as a separator.
220220

221221
For example, if two web search MCP servers called `a` and `b` both expose a `search_web` tool, client applications or proxies may consider registering these as `a___search_web` and `b___search_web` to disambiguate them.
222222

223+
For client applications with an MCP configuration file, we recommend using the name of the server as provided by the end-user in the configuration as a unique key. Server-provided names are not guaranteed to be unique.
224+
223225
## Security considerations
224226

225227
When exposing tools:

0 commit comments

Comments
 (0)