mcp-troubleshooting

Diagnose and fix MCP configuration/runtime issues across supported integrations using agents CLI checks.

Quality

77%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/mcp-troubleshooting/SKILL.md

When MCP servers are failing or not visible:

Run agents status --fast to inspect configured vs enabled integrations.
Run agents mcp test for schema/config validation.
Run agents mcp test --runtime to check integration CLI/runtime connectivity.
Run agents doctor for environment and binary diagnostics.
Apply the smallest safe fix, then run agents sync and verify with agents 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).

Repository: JoseMD12/finance-hub
Path: .agents/skills/mcp-troubleshooting/SKILL.md
Commit: a8dbf2a

Last updated: 3 days ago
First committed: 21 days ago

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.