compabob: Skill for Claude Code

.claude/skills/mcp-debug/SKILL.md

mcp-debug is a skill for Claude Code from chacosoldier/compabob. It costs 65 tokens per session (1,274 once invoked), scanned A, original, MIT.

A diagnostic tool for checking Model Context Protocol (MCP) servers and the tools they provide. It can check server health, trace a tool, or audit the configuration.

In plain words
What is it for?
Use it to check configured servers, investigate a specific tool failure, and review MCP configuration for errors or redundancy.
Why use it?
It helps explain why an MCP tool is failing silently or why a server is unavailable. It also reveals unused or duplicate servers.

Skill for Claude Code

Written for Claude Code: installed under .claude/. Also seen: reads .claude/ paths; mentions Claude Code.

This is chacosoldier/compabob's own configuration. It tells Claude Code how to work on compabob itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything compabob configures →

Reuse

Borrowing it

Nothing to install: this file belongs to chacosoldier/compabob. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/chacosoldier/compabob/main/.claude/skills/mcp-debug/SKILL.md
Clone the repo
git clone --depth 1 https://github.com/chacosoldier/compabob

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for mcp-debug

README.md
[![agentmods](https://agentmods.dev/badge/skills/chacosoldier/compabob/mcp-debug/github.svg)](https://agentmods.dev/skills/chacosoldier/compabob/mcp-debug)
Your own site
<a href="https://agentmods.dev/skills/chacosoldier/compabob/mcp-debug"><img src="https://agentmods.dev/badge/skills/chacosoldier/compabob/mcp-debug/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for mcp-debug

Your own site · 80×15
<a href="https://agentmods.dev/skills/chacosoldier/compabob/mcp-debug"><img src="https://agentmods.dev/badge/skills/chacosoldier/compabob/mcp-debug.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 65 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,274 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00065 $0.01274
Opus 5.5 $0.00026 $0.00510
Sonnet 5.5 $0.00013 $0.00255
Haiku 4.5 $0.00006 $0.00127

Measured 1mo ago against content hash bc30437c7349, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

mcp-debug scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

- **http / sse**: `curl -s -o /dev/null -w "%{http_code}"` the URL.
.claude/skills/mcp-debug/SKILL.md · 150 lines

How it starts

The opening of the file, as written. The whole thing — 150 lines — stays where its author put it; the contents beside it link to each section on GitHub.

MCP Debugger

A diagnostic tool for MCP (Model Context Protocol) server health and tool execution. Helps identify why MCP tools fail, which servers are down, and which servers are unused or redundant.

Reads MCP config from the two standard locations:

  • ~/.claude.json: user-scope servers.
  • <project>/.mcp.json: project-scope servers.

Mode detection

Check the arguments:

  • No args or status: health check all configured MCP servers.
  • trace <tool-name>: trace a specific tool's configuration and likely failure modes.
  • audit: full audit with recommendations (unused servers, error patterns, consolidation candidates).

Mode 1: Status (default)

Steps

  1. List configured servers via the Claude Code CLI:

    claude mcp list
    

    If the CLI is unavailable, parse ~/.claude.json (top-level mcpServers) and ./.mcp.json directly.

  2. For each server, run the lightweight connectivity check appropriate to its transport:

    • stdio: confirm the command exists on $PATH (which <bin>) and the wrapper script is executable.
    • http / sse: curl -s -o /dev/null -w "%{http_code}" the URL.
    • Authenticated remote: a 401 or 403 means reachable, not down. Flag as auth rather than error.
  3. Present a status table:

    Server Transport Status Note
    foo stdio ok
    bar http auth 401: token may need refresh
    baz stdio error binary not on PATH
  4. For warning/error rows, propose the next debugging step (install the binary, refresh the token, check the env var).

Output

## MCP Server Status

[table]

### Issues found
- <server>: <description + suggested fix>

### Summary
[X] ok | [Y] warnings | [Z] errors out of [N] servers

Mode 2: Trace

Steps

  1. Parse the tool name from args (e.g. /mcp-debug trace some-tool).

  2. Find which server provides this tool. The MCP tool naming convention is mcp__<server-slug>__<tool-name>; the server slug maps back to a key in ~/.claude.json or .mcp.json.

Read the full file on GitHub · 150 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 1mo ago Changed · +18 tokens per session bc30437c7349
  2. 1mo ago First seen · 150 lines · 47 tokens per session scan A 6e130f93118c

Subscribe to this mod's changes

mcp-debug is a skill published in the GitHub repository chacosoldier/compabob (34 stars, last pushed 5d ago), licensed MIT. It adds 65 tokens to every session and 1,274 once invoked, about $0.0003 per session on Opus 5.5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

ha-logs

A read-only troubleshooting skill for querying Hope Agent’s local SQLite databases, which store logs, conversations, and background-job status.

shiwenwen/hope-agent · 183 tokens

ha-self-diagnosis

Self-understanding and issue reporting for Hope Agent itself. Use when the user asks how Hope Agent works internally, asks about its own source code/docs/runtime behavior, reports a bug/failure/slowness/crash, asks to diagnose logs, or asks to create/submit a GitHub issue for a bug, feature request, or improvement…

shiwenwen/hope-agent · 114 tokens

sentry-app-setup

Create and configure a Sentry internal integration so the assistant can manage issues, alerts, and releases under its own identity.

vellum-ai/vellum-assistant · 29 tokens

ha-debug

Hope-native debugging for code failures, regressions, crashes, flaky behavior, and bad output: reproduce or characterize, rank falsifiable hypotheses, fix the smallest root cause, and prove the failing path.

shiwenwen/hope-agent · 43 tokens

dex-doctor

Whole-system checkup: verifies every Dex feature honestly (working/off/broken/couldn't-check), self-heals what's provably safe, guides the rest. Use when the user says 'is Dex healthy', 'something's broken', 'check my setup', 'run diagnostics'. Not for discovering unused features; use dex-level-up. Not for applying an…

davekilleen/Dex · 85 tokens

incident-review

Use when a service or operational incident needs a cited, timezone-aware timeline, blameless learning review, or prevention actions with accountable follow-up.

davekilleen/Dex · 32 tokens