SelfHeal MCP
Wraps any MCP server or HTTP endpoint with automatic retry logic, circuit breakers, and observability. Run it standalone to get a wrap_call tool that adds exponential backoff and failure tracking to arbitrary API requests, or use proxy mode to transparently wrap existing MCP servers so all their tools inherit self-healing behavior. Includes tools to check circuit breaker status, reset failed circuits, and pull metrics on success rates and recent errors. Useful when your agents are hitting flaky third-party APIs or you want to add resilience to an MCP server that doesn't handle transient failures gracefully. Configure retry counts, backoff delays, and circuit thresholds through environment variables.
- tools
- 8
- transport
- STDIO
- env vars
- 3
- last updated
- Apr 6, 2026
Tools
8 toolsPublic tool metadata for what this MCP can expose to an agent.
wrap_callExecute HTTP call with retry + circuit breaker
Execute HTTP call with retry + circuit breaker
No parameter schema in public metadata yet.
circuit_statusCheck health of any target
Check health of any target
No parameter schema in public metadata yet.
circuit_resetReset circuit breaker after fixing issues
Reset circuit breaker after fixing issues
No parameter schema in public metadata yet.
metricsSuccess rates, latency, top errors
Success rates, latency, top errors
No parameter schema in public metadata yet.
recent_errorsRecent failures with full details
Recent failures with full details
No parameter schema in public metadata yet.
selfheal_metricsMetrics for all proxied calls
Metrics for all proxied calls
No parameter schema in public metadata yet.
selfheal_circuitsCircuit status for all targets
Circuit status for all targets
No parameter schema in public metadata yet.
selfheal_recent_errorsRecent errors across all targets
Recent errors across all targets
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
SELFHEAL_CONFIGPath to selfheal.config.json (optional, defaults to cwd)
SELFHEAL_MAX_RETRIESMax retry attempts per call (default: 3)
SELFHEAL_CIRCUIT_THRESHOLDFailures before circuit opens (default: 5)
Readme
SelfHeal MCP
Self-healing proxy for MCP servers. Wraps any MCP tool call with automatic retry, circuit breaker protection, and call observability.
Your AI agents stop breaking on flaky APIs.
One-click install: Install on MCPize |
npx selfheal-mcp
Features
- Retry with backoff — Exponential backoff + jitter on transient failures (5xx, timeouts, rate limits)
- Circuit breaker — Per-target circuit breaker stops hammering dead services
- Call metrics — Success rates, latency, error frequency, broken down by tool and target
- Proxy mode — Wrap any existing MCP server transparently
- Zero config — Works standalone out of the box, config file for proxy mode
Quick Start
Standalone Mode
Add to your Claude Desktop / Claude Code config:
Details
- Repository
- github.com/carsonroell-debug/selfheal-mcp
- Website
- freedomengineers.tech
- Category
- Monitoring & Observability
- Package
selfheal-mcp- Transport
- STDIO
- Registry
- MCP registry, active
More from carsonroell-debug
Related Monitoring & Observability MCP servers
View all
SiteHealth MCPcarsonroell-debug/sitehealth-mcpFull website health audit — SSL, DNS, DMARC/SPF/DKIM, performance, uptime, links0stars
Prelimchat.prelim/prelimRead AI preliminary phone screens — your roles, candidate scores, transcripts, and analytics.0stars
Pingpulsecloudcorprecords/pingpulseUptime monitoring: monitors, outages, on-call schedules, status pages, maintenance and logs.0stars
Rtkcontext Mcpclauxel/rtk-context-compressor-mcpA paid remote MCP for OpenAI Codex context compressor, built to return verdicts, receipts, usage log0stars
GlucoBeatdmbejar/glucobeat-mcpLog glucose, meals, exercise and sleep in your GlucoBeat diary by chat, and look up your own data0stars
Nitrosendnitrosend/nitrosendAI-native email marketing. Campaigns, automations, transactional, contacts, and analytics.0stars