Server data from the Official MCP Registry
Self-healing proxy for MCP servers with retry, circuit breaker, and observability
About
Self-healing proxy for MCP servers with retry, circuit breaker, and observability
Security Report
Valid MCP server (3 strong, 3 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry. Trust signals: trusted author (4/4 approved).
7 files analyzed · 1 issue found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
What You'll Need
Set these up before or after installing:
Environment variable: SELFHEAL_CONFIG
Environment variable: SELFHEAL_MAX_RETRIES
Environment variable: SELFHEAL_CIRCUIT_THRESHOLD
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-carsonroell-debug-selfheal-mcp": {
"env": {
"SELFHEAL_CONFIG": "your-selfheal-config-here",
"SELFHEAL_MAX_RETRIES": "your-selfheal-max-retries-here",
"SELFHEAL_CIRCUIT_THRESHOLD": "your-selfheal-circuit-threshold-here"
},
"args": [
"-y",
"selfheal-mcp"
],
"command": "npx"
}
}
}Documentation
View on GitHubFrom the project's GitHub 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:
{
"mcpServers": {
"selfheal": {
"command": "npx",
"args": ["-y", "selfheal-mcp"]
}
}
}
Then use wrap_call to make any HTTP request with self-healing:
Use the wrap_call tool to GET https://api.example.com/data with target "example-api"
Proxy Mode
Create selfheal.config.json:
{
"mode": "proxy",
"targets": [
{
"name": "my-server",
"transport": "streamable-http",
"url": "https://my-mcp-server.com/mcp"
}
]
}
{
"mcpServers": {
"selfheal": {
"command": "npx",
"args": ["-y", "selfheal-mcp"],
"env": {
"SELFHEAL_CONFIG": "/path/to/selfheal.config.json"
}
}
}
}
All tools from my-server are re-exposed with self-healing built in.
Tools
| Tool | Description |
|---|---|
wrap_call | Execute HTTP call with retry + circuit breaker |
circuit_status | Check health of any target |
circuit_reset | Reset circuit breaker after fixing issues |
metrics | Success rates, latency, top errors |
recent_errors | Recent failures with full details |
Proxy Mode Adds
| Tool | Description |
|---|---|
selfheal_metrics | Metrics for all proxied calls |
selfheal_circuits | Circuit status for all targets |
selfheal_recent_errors | Recent errors across all targets |
Configuration
Environment Variables
| Variable | Default | Description |
|---|---|---|
SELFHEAL_CONFIG | ./selfheal.config.json | Config file path |
SELFHEAL_MAX_RETRIES | 3 | Max retry attempts |
SELFHEAL_BASE_DELAY_MS | 1000 | Base delay for backoff |
SELFHEAL_MAX_DELAY_MS | 30000 | Max delay cap |
SELFHEAL_CIRCUIT_THRESHOLD | 5 | Failures before circuit opens |
SELFHEAL_CIRCUIT_COOLDOWN_MS | 120000 | Cooldown before half-open test |
How It Works
Agent → SelfHeal MCP → [Retry + Circuit Breaker] → Target API/MCP Server
↓
Metrics Collector
- Request arrives — Agent calls a tool
- Circuit check — If target has failed too many times, reject immediately
- Execute with retry — Try the call, retry on transient errors with exponential backoff
- Record metrics — Log success/failure, duration, attempts
- Update circuit — Track consecutive failures per target
Install
MCPize (Recommended)
One-click install with managed hosting: Install on MCPize
npm
npx selfheal-mcp
PyPI
Not applicable — this is a TypeScript server. For Python alternatives, see LeadEnrich MCP.
License
MIT — Built by Freedom Engineers
Related
- SiteHealth MCP — Full website health audit
- LeadEnrich MCP — Waterfall lead enrichment
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
Fetch
Freeby Modelcontextprotocol · Developer Tools
Web content fetching and conversion for efficient LLM usage
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
MarkItDown
Freeby Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.