mcp-troubleshooting
Diagnose and fix MCP configuration/runtime issues across supported integrations using agents CLI checks.
Installation
Follow the repository instructions for this skill and your agent. Review the files and dependencies before adding it to your workflow.
View source ↗GuidesSkill instructions
When MCP servers are failing or not visible:
- Run
agents status --fastto inspect configured vs enabled integrations. - Run
agents mcp testfor schema/config validation. - Run
agents mcp test --runtimeto check integration CLI/runtime connectivity. - Run
agents doctorfor environment and binary diagnostics. - Apply the smallest safe fix, then run
agents syncand verify withagents sync --check.
Troubleshooting priorities:
- Missing binaries or PATH issues.
- Invalid server names/transport fields.
- Missing required environment variables or secrets.
- Target mismatch (server not routed to expected integration).
Examples
Read the usage examples in the source repository.
View source ↗Source history
- Indexed on
- 2026-03-11
- Index updated
- 2026-03-11
- Branch
- main
Index and sync dates describe this directory. View the source repository for code history.
GitHub ↗chat Comments (0)
Sign in to join the discussion and leave a comment.
No comments yet. Be the first to share your thoughts!