Skip to main content
command CX Codex

mcp-audit — Claude Code command: what it does, how to install

Audits active MCP servers, estimates token overhead from tool schemas, and flags unused integrations to disable.

MIT ★ 2,966 updated 2026-09-29

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add rohitg00/pro-workflow
/plugin install pro-workflow@pro-workflow
Open on GitHub

What mcp-audit does

Each active MCP server attaches all its tool descriptions to every API request. A server with 20 tools consumes around 2K-4K tokens per prompt regardless of whether those tools run.

Running /mcp-audit inspects configured servers, tallies their tools, and highlights unused integrations. It compares your setup against target thresholds: fewer than 10 servers and under 80 tools are considered optimal. If you run more than 15 servers or over 120 total tools, the command flags candidates to remove. Individual servers with over 30 tools are flagged to split or turn off.

What it helps with

  • find unused MCP servers in active sessions
  • cut token overhead caused by tool definitions
  • measure token usage per API request across MCP servers
  • identify MCP servers carrying more than 30 tools

Example prompts for the agent

  • /mcp-audit
  • Run /mcp-audit to inspect token usage from connected tools

How to install mcp-audit

1Plugin marketplace

/plugin marketplace add rohitg00/pro-workflow
/plugin install pro-workflow@pro-workflow

2Manually: put the files in place

.claude/commands/mcp-audit.md

Call it with /mcp-audit. For all projects use ~/.claude/commands/

Questions about mcp-audit

How to install mcp-audit in Claude Code?

Run /plugin marketplace add rohitg00/pro-workflow followed by /plugin install pro-workflow@pro-workflow. Alternatively, place the command file at .claude/commands/mcp-audit.md.

What does mcp-audit do?

It lists active MCP servers with their tool counts, calculates per-request token overhead, and points out servers you can disable.

What thresholds does mcp-audit follow?

The command targets fewer than 10 servers and under 80 total tools. It advises reducing integrations once you cross 15 servers, 120 total tools, or 30 tools on a single server.

Source text

mcp-audit.md · MIT
---
description: Audit MCP servers for token overhead, redundancy, and usage — recommend servers to disable for faster sessions
---

# /mcp-audit - MCP Server Optimization

Audit your MCP servers and reduce token overhead.

## Quick Start

Run to see:
- Active MCP servers and their tool counts
- Estimated token overhead per request
- Servers you haven't used recently
- Recommendations for disabling/keeping

## Key Insight

Every MCP server adds ALL its tool descriptions to EVERY API request. A server with 20 tools adds ~2K-4K tokens per request whether you use it or not.

## Thresholds

- Servers: <10 ideal, >15 reduce
- Total tools: <80 ideal, >120 reduce
- Per server: <15 ok, >30 split or disable

## Usage

```
/mcp-audit
```

© Rohit Ghumare · MIT · rohitg00/pro-workflow

Similar slash commands

All slash commands for Agent setup: memory, context, orchestration →

From the same set83

The whole set →
quality-gates quality-gates — a Claude rule that makes the agent lint and typecheck before a commit, then sweep the staged diff for debug lines and hardcoded keys. CX Codex +1 ★ 2,966repo stars atomic-commits Enforces Git best practices: atomic commits in Conventional Commits format, mandatory feature branches, and selective file staging. CX Codex +1 ★ 2,966repo stars cost-tracker cost-tracker is a Claude Code command that estimates current-session spend, identifies its main cost drivers, and suggests optimizations. Compare the estimate with a task budget. CX Codex +1 ★ 2,966repo stars self-correction self-correction turns a correction into a one-line [LEARN] rule with a category, and saves it only once you approve the wording. CX Codex +1 ★ 2,966repo stars auto-setup auto-setup detects a project’s stack and configures quality gates, permission rules, and hooks. Useful when bringing a new codebase into Claude Code. CX Codex +1 ★ 2,966repo stars compact-guard compact-guard is a Claude Code command that saves working state before context compaction and restores critical data afterward. Run it before manual compaction or when auto-compaction warnings appear. CX Codex +1 ★ 2,966repo stars wrap-up wrap-up audits git diffs, runs test suites, records lessons learned, and prepares context before closing a Claude Code session. CX Codex +1 ★ 2,966repo stars planner planner — a read-only subagent turns complex coding work into an implementation plan. Use it when several files, architecture choices, or unclear requirements are involved. CX Codex ★ 2,966repo stars

Project sponsors

Companies that keep this analytics open