mcp-troubleshooting
starsforks
How to install mcp-troubleshooting?
amtiyo/agents/mcp-troubleshooting
$npx -y skills add amtiYo/agents --skill mcp-troubleshootingDiagnose and fix MCP configuration/runtime issues across supported integrations using agents CLI checks.
SKILL.md
| 1 | When MCP servers are failing or not visible: |
| 2 | |
| 3 | 1. Run `agents status --fast` to inspect configured vs enabled integrations. |
| 4 | 2. Run `agents mcp test` for schema/config validation. |
| 5 | 3. Run `agents mcp test --runtime` to check integration CLI/runtime connectivity. |
| 6 | 4. Run `agents doctor` for environment and binary diagnostics. |
| 7 | 5. Apply the smallest safe fix, then run `agents sync` and verify with `agents sync --check`. |
| 8 | |
| 9 | Troubleshooting priorities: |
| 10 | - Missing binaries or PATH issues. |
| 11 | - Invalid server names/transport fields. |
| 12 | - Missing required environment variables or secrets. |
| 13 | - Target mismatch (server not routed to expected integration). |
People who liked this also viewed
6 picksType
- find-skillsHelps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skSkillsJul 2026
- grill-meA relentless interview to sharpen a plan or design.SkillsJul 2026
- vercel-react-best-practicesVercel's official collection of agent skillsSkillsJul 2026
- improve-codebase-architectureScan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.SkillsJul 2026
- setup-matt-pocock-skillsConfigure this repo for the engineering skills — set up its issue tracker, triage label vocabulary, and domain doc layout. Run once before first use of the other engineering skills.SkillsJul 2026
- triageMove issues and external PRs through a state machine of triage roles — categorise, verify, grill if needed, and write agent-ready briefs.SkillsJul 2026
