mcpbeat

MCP Audit

hoangsonww/mcp-audit

> Audit the configured MCP servers (user + project scope) via the Agent variable names, headers, and the source file each definition came from. Reads /api/cc-config/mcp. Use when reviewing MCP integrations for hygiene, duplication, or unexpected transports.

703 tokens
context cost
the whole folder, loaded on every use
1
files
instructions only
0
copies elsewhere
how many repositories repackaged it
867
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository
npx skills add https://github.com/hoangsonww/Claude-Code-Agent-Monitor --skill mcp-audit

The instruction itself

8 sections, as written by the author

MCP Audit

Inventory and audit every Model Context Protocol server the user has

configured — both user-scope and project-scope — read through the Agent Monitor

dashboard at http://localhost:4820.

Input

The user provides: $ARGUMENTS

This may be:

  • empty — audit all MCP servers (default).
  • a server name fragment — focus on matching servers.
  • "stdio" / "http" — restrict to one transport kind.

Data Sources

| Endpoint | Returns |

|----------|---------|

| GET /api/cc-config/mcp | { user:[…], projectScoped:[…] }. Each server: { name, source, kind } where kind is stdio (with command, args, envNames), http (with url, headers), or unknown. source names the file the definition came from (e.g. ~/.claude.json (top-level), ~/.claude.json (projects[<root>]), ~/.claude/settings.json) |

Report Sections

1. Server inventory

List every server from user and projectScoped. For each show name,

source, kind, and the transport detail:

  • stdio — the command, its args, and the envNames (names only — values

are not exposed by the API).

  • http — the url and the headers key names (values not exposed).
  • unknown — a definition the server could not classify; flag it for review.

2. Scope split & duplication

Separate user-scope from project-scope servers. Flag any name that appears in

both scopes (project may shadow user) and any duplicate definitions across

source files.

3. Hygiene flags

  • Unknown transport — servers with kind: "unknown" (malformed or

unsupported definition).

  • Env reliance — stdio servers with many envNames; note they depend on

environment variables being present at launch.

  • Remote endpoints — http servers; surface the url host so the user can

confirm they trust the remote.

Output

  • Section 1 as a table (Scope | Name | Kind | Transport detail | Source).
  • Env names and header names listed by name only — never invent or print values

(the API does not expose them).

  • Cite only fields the API returned — never fabricate servers, commands, or

hosts.

  • Note: MCP servers are read-only via the Config Explorer (they are written

concurrently by the running CLI); edit their definitions in the source file

named by source.

  • If the dashboard is unreachable at http://localhost:4820, say so and tell

the user to start it with npm start from the repo root.

How to use it

Copy the folder

Take hoangsonww/mcp-audit from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.