MCP Troubleshooting

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

Bilal140202 Updated

File contents

When MCP servers are failing or not visible:

  1. Run agents status --fast to inspect configured vs enabled integrations.
  2. Run agents mcp test for schema/config validation.
  3. Run agents mcp test --runtime to check integration CLI/runtime connectivity.
  4. Run agents doctor for environment and binary diagnostics.
  5. 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).

Bilal140202/the-lord-of-the-skills/tree/main/skills/moria/claude-code/amtiYo__agents commit 1ef623c475

Frequently asked questions

npx skillmds@latest add bilal140202/mcp-troubleshooting