MCP Health Checker

What it does

MCP (Model Context Protocol) servers are how OpenClaw connects to external tools — but connections go stale silently. A crashed MCP server doesn't throw an error until the agent tries to use it, causing confusing mid-task failures.

MCP Health Checker proactively monitors all configured MCP connections. It pings servers, measures latency, tracks uptime history, and alerts you before a stale connection causes a problem.

Inspired by OpenLobster's MCP connection health monitoring and OAuth 2.1+PKCE token refresh tracking.

When to invoke

• Automatically every 6 hours (cron) — silent background health check
• Manually before starting a task that depends on MCP tools
• When an MCP tool call fails unexpectedly — diagnose the connection
• After restarting MCP servers — verify all connections restored

Health checks performed