Skip to main content
MCP server CX Codex

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

Install into Claude Code · Platform CLI All methods and platforms ↓
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
Open on GitHub

What 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.0

Replace <…> 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.

Similar MCP servers

MCP servers catalog →

Project sponsors

Companies that keep this analytics open