Measure and grade (A to F) the context-token cost of an MCP server's tool surface, with CI gates to stop it bloating.
View on GitHub ↗Measure and grade the context-token cost of an MCP server's tool surface.
Every tool an MCP server exposes (its name, description and JSON input schema) is injected into the model's context on every turn. A server with forty verbose tools can quietly burn thousands of tokens before the user has typed a word. That cost is invisible in most workflows and it is the one thing a good MCP server should keep lean. mcp-context-budget makes it visible: it connects to a live server over stdio, adds up the token footprint of the whole tool surface, grades it from A to F against a budget, and tells you exactly what to trim.
Zero third-party dependencies. Pure standard-library Python. MIT licensed.
Part of a small MCP-quality toolchain: correctness (mcp-conformance-kit), surface stability (mcp-surface-diff), security hygiene (mcp-server-audit), performance (mcp-load-lab), and an aggregate grade (mcp-scorecard). This tool adds the missing dimension: context efficiency.
The 2026 MCP roadmap calls out progressive tool discovery precisely because large tool surfaces do not scale: they crowd the context window, raise latency and cost, and make the model slower to pick the right tool. Before you reach for progressive discovery, it helps to know how heavy your surface actually is, and which tools are the offenders. That is what this tool reports.
Or run straight from a checkout with no install at all:
A sample server is bundled so you can try it immediately:
From the project README.
Add the radar badge to your README — it shows your project was picked up by MCP Radar and links to this page:
[](https://mcp.liqiwa.com/s/shriramkv--mcp-context-budget.html)
An OKF-backed Model Context Protocol (MCP) server delivering persistent long-term memory and SQLite FTS5 search for AI agents.
sosoj92/jarvis-assistant-vocalAssistant vocal local en francais : Claude ou Ollama (offline), domotique Hue, OBS, agenda, navigateur, appels Twilio, serveur MCP. Python.
Stupidoodle/swissdevjobs-cliSearch & apply to ~4,700 salary-transparent tech jobs across 7 countries (🇨🇭🇩🇪🇬🇧🇺🇸🇨🇦🇳🇱🇫🇷) from your terminal or AI agent — zero-dependency Python CLI + MCP server + Claude Code plugin
agents-universe/agents-universe让智能体像人一样学习和工作，共享智能体和项目记忆
bybit-exchange/kaasTurn scattered notes, docs and transcripts into a queryable Markdown wiki — an LLM knowledge-base compiler with MCP access, no embeddings, self-hosted.
alxgntv/substack-api-mcpMCP server for Substack posts (FastMCP + substack-api-client)
The top new MCP servers of the week, every Monday. No spam, unsubscribe anytime.