mpm-doctor

Diagnose Claude MPM installations by verifying components and reporting statuses.

Updated Jan 30, 2026

Search Tags:#troubleshooting #diagnostics #installation #system check #mpm #mpm-command

Ready to run

npx skills add https://github.com/MacPhobos/research-mind --skill mpm-doctor

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: mpm-doctor
Source: https://github.com/MacPhobos/research-mind/tree/main/.claude/skills/mpm-doctor
Command: npx skills add https://github.com/MacPhobos/research-mind --skill mpm-doctor

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps users quickly identify and troubleshoot problems with their Claude MPM (Multi-Platform Manager) installation, ensuring it's running correctly.

Core Features & Use Cases

Comprehensive Checks: Verifies installation, configuration, WebSocket connectivity, agent status, memory system health, and hook functionality.
Diagnostic Output: Provides clear status indicators (OK, Warning, Error) for each checked component.
Use Case: After a recent update or when experiencing unexpected behavior with MPM commands, run /mpm-doctor to pinpoint the exact cause of the issue.

Quick Start

Run a diagnostic check on your MPM installation.

Frequently Asked Questions about mpm-doctor

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

FAQPage Schema

How do I run diagnostics on my MPM installation to check system health?▼

To run diagnostics on your MPM installation, execute the mpm-doctor command. It verifies package installation, configuration validity, WebSocket server health, agent availability, memory system status, and hook system setup, returning clear OK, Warning, or Error status indicators.

Why is my Claude MPM configuration not working after a recent update?▼

If your Claude MPM configuration is not working after an update, run a diagnostic check to pinpoint the exact cause. The diagnostic process verifies configuration validity and checks core components like the WebSocket server and agent availability to identify update-related issues.

What components does an MPM system check verify during troubleshooting?▼

An MPM system check verifies package installation, configuration validity, WebSocket server health, agent availability, memory system status, and hook system setup. These diagnostic checks ensure the integrity of your MPM environment and identify specific component failures.

When should I use a diagnostic check for my Claude MPM environment?▼

You should use a diagnostic check for your Claude MPM environment when experiencing unexpected behavior with MPM commands or after a recent update. Running diagnostics helps troubleshoot issues by validating the health and setup of all core installation components.

Does the MPM diagnostic tool check WebSocket connectivity and agent status?▼

Yes, the MPM diagnostic tool checks WebSocket connectivity and agent status. It performs comprehensive checks on your installation, verifying WebSocket server health and agent availability alongside configuration validity, memory system status, and hook functionality.