Server data from the Official MCP Registry
Analyze your MCP setup: token costs, grades, duplicates, and optimization tips
About
Analyze your MCP setup: token costs, grades, duplicates, and optimization tips
Security Report
Valid MCP server (3 strong, 4 medium validity signals). 3 known CVEs in dependencies (0 critical, 3 high severity) Package registry verified. Imported from the Official MCP Registry.
6 files analyzed · 4 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-yifanyifan897645-mcp-checkup": {
"args": [
"-y",
"mcp-checkup"
],
"command": "npx"
}
}
}Documentation
View on GitHubFrom the project's GitHub README.
mcp-checkup
Your MCP servers are eating your context window. Find out how much.
mcp-checkup is an MCP server that analyzes your MCP setup — measuring the token cost of every installed server and tool, finding duplicates, grading efficiency, and generating optimization reports.
Quick Start
npx mcp-checkup
Then ask your AI assistant:
"Run an MCP health check on my setup"
"How many tokens are my MCP servers using?"
"Generate an MCP health report"
Why?
Every MCP tool costs 550–1,400 tokens just for its schema. A server with 50 tools can eat 30,000+ tokens before you type anything. Most developers have no idea how much context window their MCP servers are consuming.
Real examples from the community:
- Adding GitHub MCP increased one user's token usage from 34K to 80K (source)
- One developer found 67,000 tokens consumed by just 4 servers before any conversation (source)
- Context7 (240K weekly downloads) has tool descriptions costing 3x more tokens than necessary (source)
Tools
analyze_servers
Scan your MCP config and measure the token cost of every installed server. Auto-detects config files.
"Which of my MCP servers costs the most tokens?"
analyze_tools
Deep-dive into a specific server — per-tool token costs, grades, bloated descriptions, and optimization suggestions.
"Break down the token cost of my GitHub MCP server"
find_duplicates
Find duplicate tool names across your installed servers. Redundant tools waste context for no benefit.
"Do any of my MCP servers have overlapping tools?"
count_tokens
Count tokens in any text. Useful for estimating context usage.
"How many tokens is this prompt?"
generate_report
Full markdown health report: server grades (A-F), token costs, duplicates, and actionable recommendations.
"Generate a full MCP health report"
Grading System
Per-Tool Grades
| Grade | Tokens | Meaning |
|---|---|---|
| A | ≤100 | Excellent — minimal context cost |
| B | ≤300 | Good — reasonable schema size |
| C | ≤600 | Fair — could be optimized |
| D | ≤1000 | Poor — bloated schema |
| F | >1000 | Failing — severely impacts context window |
Per-Server Grades
| Grade | Total Tokens | Meaning |
|---|---|---|
| A | ≤500 | Lean and efficient |
| B | ≤1500 | Reasonable |
| C | ≤3000 | Getting heavy |
| D | ≤6000 | Significant context cost |
| F | >6000 | Major context window drain |
Installation
Claude Desktop / Claude Code
{
"mcpServers": {
"mcp-checkup": {
"command": "npx",
"args": ["-y", "mcp-checkup"]
}
}
}
Cursor
Add to .cursor/mcp.json with the same format.
Auto-Detection
mcp-checkup automatically finds your MCP config in these locations:
.mcp.json(current directory)- Claude Desktop config (Windows/macOS/Linux)
.cursor/mcp.json
Or pass a custom path to any tool.
How It Compares
| Tool | Purpose | Approach |
|---|---|---|
| mcp-checkup | Diagnose token costs | Analyze & report — see exactly what each tool costs |
| lean-ctx | Reduce token usage | Compress context at runtime |
| MCP Inspector | Debug MCP servers | Test connections and tool calls |
Use mcp-checkup first to find the problem, then decide how to fix it.
Part of the MCP Toolkit
- webcheck-mcp — Website health analysis
- git-summary-mcp — Git repository intelligence
- mcp-checkup — MCP setup health analyzer
- dev-utils-mcp — Developer utilities
- codescan-mcp — Codebase health scanner
- deadlink-checker-mcp — Dead link detector
License
MIT
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Fetch
Freeby Modelcontextprotocol · Developer Tools
Web content fetching and conversion for efficient LLM usage
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
MarkItDown
Freeby Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.
FinAgent
Freeby mcp-marketplace · Finance
Free stock data and market news for any MCP-compatible AI assistant.