MCP Schema Bloat Fixer

Fight the invisible token tax that is killing your AI agents.

Repository: mcp-schema-bloat-fixer

The Problem (explained simply)

Imagine your AI agent is a smart kid trying to do homework.
But every time he starts, you force him to read a 200-page phone book of tools first.
By the time he finishes reading the phone book, he already forgot the homework question and also spent all his pocket money on “thinking tokens”.

That phone book is the tool schemas coming from MCP servers.
Many servers send 40-50% of the entire context window just on tool descriptions.

What This MCP Server Does

It gives your agent (or you) five superpowers:

Tool	What it does (simple)
`analyze_schema_bloat`	Tells you which tools are the biggest space-wasters
`compress_tool_description`	Makes long tool descriptions short but still clear
`select_relevant_tools`	Picks only the 3-5 tools the agent actually needs right now
`estimate_context_cost`	Shows how many tokens (and dollars) a set of tools will cost
`generate_minimal_schema`	Creates the smallest possible version of a tool schema

Quick Start

# Install
pip install mcp

# Run (stdio)
python -m src.server

# Or with mcpize (when available)
mcpize run .

Environment

Copy .env.example → .env if you want optional tiktoken for exact counts.

Why This Helps Entrepreneurs

Save real money on every AI call
Make your AI products more reliable (agents stop picking wrong tools)
Ship faster because debugging “why did the agent fail?” becomes easier

License

MIT – build cool stuff with it.

Built as part of the Daily AI Project series for Prevalid.