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"

Related MCP server: AgentCost

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

Per-Server Grades

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

Use mcp-checkup first to find the problem, then decide how to fix it.

Part of the MCP Toolkit

View all servers →

• 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