Tool Search Proxy — Claude Code MCP server: setup
The Tool Search Proxy MCP server for Claude Code searches a large tool catalog and routes calls through a proxy. An agent can use it to find a fitting tool without loading the full catalog.
MIT ★ 5 updated 2026-11-16
claude mcp add --env TOOLSEARCH_UPSTREAM=<TOOLSEARCH_UPSTREAM> --env TOOLSEARCH_EMBEDDER=<TOOLSEARCH_EMBEDDER> --env MCP_TRANSPORT=<MCP_TRANSPORT> --transport stdio tool-search-proxy -- docker run -i --rm -e TOOLSEARCH_UPSTREAM -e TOOLSEARCH_EMBEDDER -e MCP_TRANSPORT ghcr.io/datolabs-io/mcp-toolsearch-proxy:0.10.0What Tool Search Proxy does
Tool Search Proxy gives a model catalog search and separate tools for calling matches. The model sees six proxy tools for searching, inspecting schemas, and making read, write, or destructive calls. Arguments are checked against the input schema before a request reaches the upstream server.
For HTTP use, the upstream must support streamable HTTP MCP and bearer-token authorization. The proxy forwards the caller’s Authorization header and keeps no credentials of its own. With stdio, there is no caller token, so the upstream must accept unauthenticated requests. Claude Code setup uses Docker and the TOOLSEARCH_UPSTREAM, TOOLSEARCH_EMBEDDER, and MCP_TRANSPORT values.
What it helps with
- locate a suitable tool in a large MCP catalog
- inspect a matching tool’s schema before calling it
- separate read, write, and destructive tool calls
- reject arguments that do not match a tool’s schema
Example prompts for the agent
- Search the MCP catalog for a tool that can read tasks, then show its schema.
- Find a suitable MCP tool for this task and call it with these arguments: …
- Search for tools that read data and run the matching calls.
How to install Tool Search Proxy
Platform CLI
claude mcp add --env TOOLSEARCH_UPSTREAM=<TOOLSEARCH_UPSTREAM> --env TOOLSEARCH_EMBEDDER=<TOOLSEARCH_EMBEDDER> --env MCP_TRANSPORT=<MCP_TRANSPORT> --transport stdio tool-search-proxy -- docker run -i --rm -e TOOLSEARCH_UPSTREAM -e TOOLSEARCH_EMBEDDER -e MCP_TRANSPORT ghcr.io/datolabs-io/mcp-toolsearch-proxy:0.10.0Replace <…> with your own values
Platform CLI
codex mcp add tool-search-proxy --env TOOLSEARCH_UPSTREAM=<TOOLSEARCH_UPSTREAM> --env TOOLSEARCH_EMBEDDER=<TOOLSEARCH_EMBEDDER> --env MCP_TRANSPORT=<MCP_TRANSPORT> -- docker run -i --rm -e TOOLSEARCH_UPSTREAM -e TOOLSEARCH_EMBEDDER -e MCP_TRANSPORT ghcr.io/datolabs-io/mcp-toolsearch-proxy:0.10.0Replace <…> with your own values
Config file
{
"mcpServers": {
"tool-search-proxy": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"TOOLSEARCH_UPSTREAM",
"-e",
"TOOLSEARCH_EMBEDDER",
"-e",
"MCP_TRANSPORT",
"ghcr.io/datolabs-io/mcp-toolsearch-proxy:0.10.0"
],
"env": {
"TOOLSEARCH_UPSTREAM": "<TOOLSEARCH_UPSTREAM>",
"TOOLSEARCH_EMBEDDER": "<TOOLSEARCH_EMBEDDER>",
"MCP_TRANSPORT": "<MCP_TRANSPORT>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"tool-search-proxy": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"TOOLSEARCH_UPSTREAM",
"-e",
"TOOLSEARCH_EMBEDDER",
"-e",
"MCP_TRANSPORT",
"ghcr.io/datolabs-io/mcp-toolsearch-proxy:0.10.0"
],
"env": {
"TOOLSEARCH_UPSTREAM": "<TOOLSEARCH_UPSTREAM>",
"TOOLSEARCH_EMBEDDER": "<TOOLSEARCH_EMBEDDER>",
"MCP_TRANSPORT": "<MCP_TRANSPORT>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e TOOLSEARCH_UPSTREAM=<TOOLSEARCH_UPSTREAM> -e TOOLSEARCH_EMBEDDER=<TOOLSEARCH_EMBEDDER> -e MCP_TRANSPORT=<MCP_TRANSPORT> tool-search-proxy docker run -i --rm -e TOOLSEARCH_UPSTREAM -e TOOLSEARCH_EMBEDDER -e MCP_TRANSPORT ghcr.io/datolabs-io/mcp-toolsearch-proxy:0.10.0Replace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Tool Search Proxy
How do I install Tool Search Proxy in Claude Code?
Run: `claude mcp add --env TOOLSEARCH_UPSTREAM=<TOOLSEARCH_UPSTREAM> --env TOOLSEARCH_EMBEDDER=<TOOLSEARCH_EMBEDDER> --env MCP_TRANSPORT=<MCP_TRANSPORT> --transport stdio tool-search-proxy -- docker run -i --rm -e TOOLSEARCH_UPSTREAM -e TOOLSEARCH_EMBEDDER -e MCP_TRANSPORT ghcr.io/datolabs-io/mcp-toolsearch-proxy:0.10.0`.
What does Tool Search Proxy do?
It lets a model search a large MCP tool catalog and call matches through six proxy tools. Calls are grouped by action type, and arguments are checked against each tool’s schema.
What does Tool Search Proxy need to run?
Setup requires Docker and values for TOOLSEARCH_UPSTREAM, TOOLSEARCH_EMBEDDER, and MCP_TRANSPORT. For HTTP, the upstream must support streamable HTTP MCP and bearer authorization; with stdio, it must accept unauthenticated requests.