Skip to content
MCP server

Tool Guardian

One router in front of your MCP servers that loads each tool's schema only when needed

Runs locallyStatus and history
Install
Platforms
CLI, Linux, macOS
Runs
Locally
Version
0.10.1
Listing updated
today

Similar MCP servers

About Tool Guardian

Tool Guardian is an MCP server for ai models and llm tooling. It runs locally on your machine and is started by your AI client.

Tool Guardian sits between a client and your other MCP servers and shows the model six router tools in place of every backend tool. The model lists or searches capabilities, describes a single tool to see its arguments, then calls it through the router, so full schemas never fill the context window up front. Eight router tools appear when skills are enabled.

The README's bench against recorded answers from seven public servers reports 20,005 tokens of schemas without the router and 1,084 with it. A selftest command checks that your backends start and prints the real saving for your own setup. It also archives long tool output, so a 3,000-line build log can arrive as a short extract with the original one call away, and a failing backend reports an error instead of an empty list.

It is Python 3.9 or newer, standard library only, run through uvx or pip, and the README says when not to use it: clients that already load tools on demand, or setups with only a few small servers. It also warns the model must call tools reliably.

Install

Run in a terminal

claude mcp add tool-guardian -- uvx tool-guardian

Add to claude_desktop_config.json

{
  "mcpServers": {
    "tool-guardian": {
      "command": "uvx",
      "args": [
        "tool-guardian"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "tool-guardian": {
      "command": "uvx",
      "args": [
        "tool-guardian"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "tool-guardian": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "tool-guardian"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "tool-guardian": {
      "command": "uvx",
      "args": [
        "tool-guardian"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "tool-guardian": {
      "command": "uvx",
      "args": [
        "tool-guardian"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

list_capabilities
Lists backend servers and their tools.
search_capabilities
Searches backend tools by keyword.
describe_tool
Shows one backend tool's arguments.
call_tool
Calls a tool on a backend server.

What it does

Six router tools
Replaces many tool definitions with list, search, describe and call tools.
On-demand schemas
Fetches a tool's arguments only when the model asks.
Selftest
Checks backends start and prints the token saving for your setup.
Output archiving
Shortens long results and keeps the original retrievable.
Honest failures
Reports backend errors instead of an empty tool list.
Import existing servers
Copies servers from Claude Desktop, Cursor or Windsurf configs.

Good for

  • Cut tool-schema tokens on a small local model
  • Put many MCP servers behind one entry
  • Stop huge build logs flooding context
  • Measure savings before committing to a router

Tool Guardian FAQ

How do I run it?

uvx tool-guardian, with servers added through tool-guardian-setup.

Which clients are tested?

Claude Code, OpenCode, Cline and Continue; others are expected but untested.

When should I skip it?

If your client already loads tools on demand, or you run a handful of small servers.

What does it need?

Python 3.9 or newer; the router uses only the standard library.

How do I add Tool Guardian to Claude Code?

Run this command in your terminal: claude mcp add tool-guardian -- uvx tool-guardian

What are the best alternatives to Tool Guardian?

The closest alternatives to Tool Guardian are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers