{
  "markdown": "# mcp-checkup\n\n[![npm version](https://img.shields.io/npm/v/mcp-checkup.svg)](https://www.npmjs.com/package/mcp-checkup)\n[![npm downloads](https://img.shields.io/npm/dm/mcp-checkup.svg)](https://www.npmjs.com/package/mcp-checkup)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nYour MCP servers are eating your context window. Find out how much.\n\n**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.\n\n## Quick Start\n\n```bash\nnpx mcp-checkup\n```\n\nThen ask your AI assistant:\n\n```\n\"Run an MCP health check on my setup\"\n\"How many tokens are my MCP servers using?\"\n\"Generate an MCP health report\"\n```\n\n## Why?\n\nEvery 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.\n\n**Real examples from the community:**\n- Adding GitHub MCP increased one user's token usage from 34K to 80K ([source](https://github.com/github/github-mcp-server/issues/1286))\n- One developer found 67,000 tokens consumed by just 4 servers before any conversation ([source](https://mariogiancini.com/the-hidden-cost-of-mcp-servers-and-when-theyre-worth-it))\n- Context7 (240K weekly downloads) has tool descriptions costing 3x more tokens than necessary ([source](https://dev.to/0coceo/the-1-most-popular-mcp-server-gets-an-f-2olm))\n\n## Tools\n\n### `analyze_servers`\nScan your MCP config and measure the token cost of every installed server. Auto-detects config files.\n\n```\n\"Which of my MCP servers costs the most tokens?\"\n```\n\n### `analyze_tools`\nDeep-dive into a specific server — per-tool token costs, grades, bloated descriptions, and optimization suggestions.\n\n```\n\"Break down the token cost of my GitHub MCP server\"\n```\n\n### `find_duplicates`\nFind duplicate tool names across your installed servers. Redundant tools waste context for no benefit.\n\n```\n\"Do any of my MCP servers have overlapping tools?\"\n```\n\n### `count_tokens`\nCount tokens in any text. Useful for estimating context usage.\n\n```\n\"How many tokens is this prompt?\"\n```\n\n### `generate_report`\nFull markdown health report: server grades (A-F), token costs, duplicates, and actionable recommendations.\n\n```\n\"Generate a full MCP health report\"\n```\n\n## Grading System\n\n### Per-Tool Grades\n| Grade | Tokens | Meaning |\n|-------|--------|---------|\n| A | ≤100 | Excellent — minimal context cost |\n| B | ≤300 | Good — reasonable schema size |\n| C | ≤600 | Fair — could be optimized |\n| D | ≤1000 | Poor — bloated schema |\n| F | >1000 | Failing — severely impacts context window |\n\n### Per-Server Grades\n| Grade | Total Tokens | Meaning |\n|-------|-------------|---------|\n| A | ≤500 | Lean and efficient |\n| B | ≤1500 | Reasonable |\n| C | ≤3000 | Getting heavy |\n| D | ≤6000 | Significant context cost |\n| F | >6000 | Major context window drain |\n\n## Installation\n\n### Claude Desktop / Claude Code\n\n```json\n{\n  \"mcpServers\": {\n    \"mcp-checkup\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-checkup\"]\n    }\n  }\n}\n```\n\n### Cursor\n\nAdd to `.cursor/mcp.json` with the same format.\n\n## Auto-Detection\n\nmcp-checkup automatically finds your MCP config in these locations:\n- `.mcp.json` (current directory)\n- Claude Desktop config (Windows/macOS/Linux)\n- `.cursor/mcp.json`\n\nOr pass a custom path to any tool.\n\n## How It Compares\n\n| Tool | Purpose | Approach |\n|------|---------|----------|\n| **mcp-checkup** | Diagnose token costs | Analyze & report — see exactly what each tool costs |\n| [lean-ctx](https://github.com/yvgude/lean-ctx) | Reduce token usage | Compress context at runtime |\n| [MCP Inspector](https://github.com/modelcontextprotocol/inspector) | Debug MCP servers | Test connections and tool calls |\n\n**Use mcp-checkup first** to find the problem, then decide how to fix it.\n\n## Part of the MCP Toolkit\n\n**[View all servers →](https://yifanyifan897645.github.io/mcp-toolkit/)**\n\n- [webcheck-mcp](https://www.npmjs.com/package/webcheck-mcp) — Website health analysis\n- [git-summary-mcp](https://www.npmjs.com/package/git-summary-mcp) — Git repository intelligence\n- [mcp-checkup](https://www.npmjs.com/package/mcp-checkup) — MCP setup health analyzer\n- [dev-utils-mcp](https://www.npmjs.com/package/dev-utils-mcp) — Developer utilities\n- [codescan-mcp](https://www.npmjs.com/package/codescan-mcp) — Codebase health scanner\n- [deadlink-checker-mcp](https://www.npmjs.com/package/deadlink-checker-mcp) — Dead link detector\n\n## License\n\nMIT\n",
  "bytes": 4652,
  "sha": "d318d8e3eef4c255f6b6a7a13d2e76d8646bdee98013efad7dd6906e708b29a7",
  "repo_slug": "yifanyifan897645/mcp-checkup",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_yifanyifan897645_mcp_checkup_b6b3d1b2/readme"
}