Skip to main content
Glama
princeruhulofficial

mcp-schema-bloat-fixer

by princeruhulofficial
OverviewSchemaSourceRelated ServersScoreDiscussionsAdmin
Python
Remote

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.

Related MCP server: Refract

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.

This server cannot be installed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • mcp-compressor

    atlassian-labs
    A
    license
    Not graded
    quality
    A
    maintenance
    A proxy server that wraps existing MCP servers to significantly reduce token consumption by compressing tool descriptions into a two-step interface. It enables users to integrate extensive toolsets without exceeding context limits or incurring high API costs.
    118
    Apache 2.0

  • Refract

    LoudiliMed
    A
    license
    A
    quality
    B
    maintenance
    MCP proxy that compresses tool schemas on the fly. Up to 98% token reduction, 100% signal preserved verified after every compression. Zero LLM calls, fully deterministic.
    5
    4
    MIT

  • CostGate

    YukiMiyatake
    A
    license
    Not graded
    quality
    C
    maintenance
    Reduces AI token consumption by optimizing MCP tool definitions and responses, with a probe for measurement and a gate for filtered tool exposure and cost reduction.
    MIT

  • mcp-slim

    Coefficient-work
    A
    license
    Not graded
    quality
    B
    maintenance
    Optimizes MCP tool menus from OpenAPI specs by grouping operations by tag and trimming schemas to reduce token usage, improving agent tool-selection accuracy.
    432
    MIT