MCP Tool Guardian

Production-ready MCP Server for AI Agent Reliability & Accountability

Protect your AI agents from bad tool outputs, schema mismatches, and potential tool poisoning. Built for entrepreneurs who want safer, more accountable AI systems.

The Problem (Simple Explanation)

Imagine your AI helper is like a 10-year-old kid who asks friends for information. Sometimes the friends give wrong, incomplete, or even tricky answers. The kid then makes mistakes because of that bad information.

MCP Tool Guardian is like a smart teacher who checks every answer the friends give before the kid uses it. It makes sure the answer matches the expected shape, cleans dangerous parts, and gives a reliability score.

This is especially useful for founders building AI products who care about trust and accountability (like Prevalid's mission).

What This MCP Server Does

It exposes tools that any MCP-compatible AI agent (Claude Desktop, Cursor, Windsurf, etc.) can call:

Tool	What it does (kid-friendly)
`validate_against_schema`	Checks if the data looks exactly like the promised shape (like checking if a LEGO set has all the right pieces)
`sanitize_tool_output`	Cleans the data – removes secrets, weird characters, or possible injection tricks
`score_reliability`	Gives a score from 0-100 how trustworthy the tool answer is
`detect_suspicious_patterns`	Looks for common "poison" patterns that bad tools sometimes hide
`create_audit_entry`	Writes a simple log so you can later see what happened (accountability!)

Why This is Valuable for Entrepreneurs

Reduce AI failures: Fewer cascading errors from bad tool data
Low cost: Pure local computation – no expensive external APIs needed
Accountability: Perfect for Prevalid-style AI Execution OS
Ready for production: Stateless design compatible with new MCP 2026-07-28 spec
Easy to sell: Can be packaged as a paid MCP or internal reliability layer

Quick Start

Requirements

Python 3.10+
mcp package (official SDK)

pip install mcp jsonschema pydantic

Run the server

python -m src.server

Or with uv:

uv run python -m src.server

Add to Claude Desktop / Cursor

Add this to your MCP config:

{
  "mcpServers": {
    "tool-guardian": {
      "command": "python",
      "args": ["-m", "src.server"],
      "cwd": "/path/to/mcp-tool-guardian-20260730"
    }
  }
}

Project Structure

mcp-tool-guardian-20260730/
├── src/
│   ├── __init__.py
│   ├── server.py          # Main MCP server
│   ├── tools/
│   │   ├── __init__.py
│   │   ├── validate.py
│   │   ├── sanitize.py
│   │   ├── reliability.py
│   │   └── audit.py
│   └── utils/
│       └── schemas.py
├── tests/
│   └── test_tools.py
├── mcpize.yaml
├── .env.example
├── pyproject.toml
├── LAUNCH.md
└── README.md

License

MIT – Build freely, stay accountable.