# Tool Search Proxy

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5 repo stars
- Author: datolabs-io
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/datolabs-io/mcp-toolsearch-proxy
- Updated: 2026-11-16
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/tool-search-proxy

## What it 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.

## Requirements
- Needs: Docker
- Environment variables: `TOOLSEARCH_UPSTREAM`, `TOOLSEARCH_EMBEDDER`, `MCP_TRANSPORT` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
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

### Codex

**Platform CLI**
```bash
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.0
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "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

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "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

### Gemini CLI

**Platform CLI**
```bash
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.0
```
Replace <…> with your own values

## When to use it
- 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
- 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.

## Similar
- [tavily-key-generator-proxy](https://affpapa.org/en/nevibecode/skills/tavily-key-generator-proxy.md) — skill · 1400 installs
- [headless-checkout-proxy](https://affpapa.org/en/nevibecode/skills/headless-checkout-proxy.md) — skill · 1200 installs
- [tg-ws-proxy-telegram-socks5](https://affpapa.org/en/nevibecode/skills/tg-ws-proxy-telegram-socks5.md) — skill · 889 installs
- [proxy-manager](https://affpapa.org/en/nevibecode/skills/proxy-manager.md) — skill · 675 installs
- [qiaomu-markdown-proxy](https://affpapa.org/en/nevibecode/skills/qiaomu-markdown-proxy.md) — skill · 663 installs
- [proxy-pattern](https://affpapa.org/en/nevibecode/skills/proxy-pattern.md) — skill · 635 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
