skills.rest
MDGrey33
MDGrey33COMMUNITY
Explore all skills by this author →
WebsiteGitHub

mcp-doctor

Check configured MCP servers and report healthy, absent, or broken ones.

2|Updated Feb 23, 2026
Search Tags:#troubleshooting#claude code#mcp#diagnostics#health-check#session tools
One-click install
npx skills add https://github.com/MDGrey33/memnyx --skill mcp-doctor-mdgrey33
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: mcp-doctor
Source: https://github.com/MDGrey33/memnyx/tree/main/.claude/skills/mcp-doctor
Command: npx skills add https://github.com/MDGrey33/memnyx --skill mcp-doctor-mdgrey33

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It removes the guesswork from MCP troubleshooting by quickly telling you which configured servers are healthy, missing, or failing to connect.

Core Features & Use Cases

  • Session health checks: Compares .mcp.json against the tools loaded in the current Claude Code session.
  • Deep diagnostics: Tests stdio, node-based, and HTTP or SSE servers directly when a server is absent or broken.
  • Operational reporting: Summarizes local servers and Claude.ai integrations with clear status labels and next-step guidance.
  • Use case: After starting Claude Code, you can verify whether your memory, browser, or other MCP services are actually available before relying on them.

Quick Start

Ask the skill to check your configured MCP servers and report any missing or unhealthy connections.

Frequently Asked Questions about mcp-doctor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check if my MCP servers are connected in Claude Code?▼

To check if MCP servers are connected in Claude Code, verify the session health by comparing your `.mcp.json` configuration against the tools actually loaded in the current session to identify healthy, absent, or broken connections.

Why does Claude Code fail to load my MCP tools?▼

Claude Code may fail to load MCP tools if a configured server is broken or absent. You can run deep diagnostics to test stdio, node-based, and HTTP or SSE native transports directly to retrieve tool counts and error summaries for failing connections.

What is the best way to troubleshoot missing MCP servers?▼

The best way to troubleshoot missing MCP servers is to run a health check that reads your `.mcp.json` file, enumerates active session tools, and applies deep diagnostics to stdio and HTTP transports to report clear status labels and next-step guidance.

Can I test Claude.ai MCP integrations during a local diagnostic session?▼

Yes, you can test Claude.ai MCP integrations alongside local MCP services during a diagnostic session. The health check summarizes both local servers and Claude.ai integrations with clear status labels and operational reporting.

Do I need a .mcp.json file to verify MCP server health?▼

Yes, a `.mcp.json` file is required to verify MCP server health. The diagnostic process reads this configuration file to compare against active session tools and test native transports for connection failures.

Related Skills

Explore More Software Engineering Skills→
billynewportbillynewport

setup mcp config

Generate a .mcp.json file connecting Claude Code to the DataSurface MCP server in Kubernetes.

Community
Intermediate
lukacflukacf
19

MCP Server Setup

Configure MCP servers and transport endpoints for Meerkat deployments.

Community
Intermediate
ouim-meouim-me
28

Reacher Setup Guide for AI Agents

Guide interactive Reacher setup for secure Claude API, memory, browser, and SSH access.

Official
Advanced
ErixWongErixWong
17

mcp-client

Manage connections to multiple MCP Servers via STDIO and HTTP Stream transports.

Community
Advanced