MCP Server Triage (mcptoon)
A layered troubleshooting playbook that uses the mcptoon CLI to find and fix broken MCP servers.
What it does
When an MCP server stops responding or its tools disappear, this skill walks Claude top-down through mcptoon doctor → mcptoon health → mcptoon list / manifest / inspect / call, stopping at the first layer where the fault appears. It includes a symptom→cause→fix table for common breakages (binary not on PATH, startup timeouts, spawn ENOENT, schema mismatches, config overwritten in an agent dir) and closes the loop with mcptoon sync plus a re-check of health.
Who it's for
- Developers managing several MCP servers through mcptoon
- Anyone frequently editing stdio/HTTP MCP configs and hitting errors
- Teams gating CI on
mcptoon health --json
Examples
- "Everything died after I hand-edited the config" → detect the overwritten agent config, repair
~/.mcptoon/config.json, sync. - "Tool call returns unknown tool" → verify the tool toggle, sync, then confirm via manifest.
- "Schema error on arguments" → run
mcptoon inspect <server> <tool>and match the inputSchema exactly.
· · · Install guide · · ·
Try it now, no install
Paste this into Claude to use the skill without installing anything.
Read the instructions in this file and follow them to help me: https://raw.githubusercontent.com/activeing123/mcptoon/HEAD/plugin/mcptoon-skills/skills/triage/SKILL.md What I want: (describe your task here)
If Claude can't open the link, open it yourself and paste the contents instead.
↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the plugin/mcptoon-skills/skills/triage folder from the GitHub repo activeing123/mcptoon into my ~/.claude/skills/triage/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/activeing123/mcptoon.git /tmp/mcptoon && mkdir -p ~/.claude/skills && cp -r /tmp/mcptoon/plugin/mcptoon-skills/skills/triage ~/.claude/skills/triage⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal.
- Clone the repo:
git clone https://github.com/activeing123/mcptoon.git /tmp/mcptoon - Create the skills folder:
mkdir -p ~/.claude/skills - Copy the skill:
cp -r /tmp/mcptoon/plugin/mcptoon-skills/skills/triage ~/.claude/skills/triage - Confirm the CLI exists:
mcptoon --version(install it per the repo README if missing). - Restart Claude Code and try: "My MCP server is down, triage it."