# Tool Guardian

> Tool Guardian is an MCP server for ai models and llm tooling. One router in front of your MCP servers that loads each tool's schema only when needed. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Platforms:** CLI, Linux, macOS, Windows
- **Repository:** https://github.com/luminarisoftwares/tool-guardian
- **MCP Registry name:** io.github.LuminariSoftwares/tool-guardian
- **Categories:** [AI models and LLM tooling](https://ai-powered.com/categories/ai-and-llm), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add tool-guardian -- uvx tool-guardian
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

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

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/tool-guardian
