mpm-doctor

Diagnose Claude MPM installation, configuration, WebSocket, agent, memory, and hooks.

Updated Mar 25, 2026
One-click install
npx skills add https://github.com/bobmatnyc/claude-mpm-marketplace --skill mpm-doctor-bobmatnyc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mpm-doctor
Source: https://github.com/bobmatnyc/claude-mpm-marketplace/tree/main/plugins/claude-mpm/skills/mpm-doctor
Command: npx skills add https://github.com/bobmatnyc/claude-mpm-marketplace --skill mpm-doctor-bobmatnyc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnosing issues in Claude MPM installation and configuration to ensure a healthy, predictable runtime.

Core Features & Use Cases

  • Installation and configuration validation
  • WebSocket connectivity checks
  • Agent availability and memory health verification
  • Generated diagnostic report for engineering troubleshooting

Quick Start

Run the /mpm-doctor command to generate a comprehensive diagnostic report.

Frequently Asked Questions about mpm-doctor

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

FAQPage Schema
How do I run a health check on my Claude MPM installation?

Run the /mpm-doctor command to perform a health check that verifies your Claude MPM installation version, configuration validity, WebSocket connectivity, agent availability, memory accessibility, and hook configuration.

What does MPM diagnostics cover for fresh deployments and post-configuration changes?

MPM diagnostics covers installation version verification, configuration validation, WebSocket health checks, agent readiness, memory accessibility, and hook configuration to ensure a healthy, predictable runtime after deployment or changes.

How do I troubleshoot WebSocket connectivity and agent availability issues in MPM?

Troubleshoot WebSocket connectivity and agent availability by running /mpm-doctor, which generates a comprehensive diagnostic report covering WebSocket health, agent readiness, and memory accessibility for engineering troubleshooting.

Can I use mpm-doctor to validate hook configuration and memory accessibility?

Yes, mpm-doctor validates hook configuration and checks memory accessibility as part of its centralized health check, satisfying functional requirements to verify these components during installation and runtime troubleshooting.

Why does my MPM installation fail after configuration changes?

MPM installation failures after configuration changes can stem from invalid configuration, WebSocket connectivity issues, or unavailable agents. Running /mpm-doctor generates a diagnostic report identifying the specific failing component.

What's the best way to diagnose runtime issues in Claude MPM?

The best way to diagnose Claude MPM runtime issues is running /mpm-doctor, which provides a centralized health check covering installation, WebSocket connectivity, agent availability, memory, and hooks in a single diagnostic report.