proxypi
v1.0.0
Published
Self-healing API proxy MCP — your API calls, but they never actually break.
Maintainers
Readme
What it is
Self-healing API proxy MCP for Cursor, Claude Code, or any MCP-compatible client. Send any REST request — if it fails, ProxyPI reads the error, diagnoses the problem using Claude, patches the request, and retries. Successful fixes are remembered and applied instantly next time, without calling Claude.
How it works
You: proxypi_request → POST https://api.example.com/users
ProxyPI: try → fail → diagnose (Claude) → patch → retry → rememberNext time the same error occurs on the same host and path, the fix is applied from memory instantly — no Claude call needed.
Demo
npx proxypiInstall
npx proxypiConfig
Add to .cursor/mcp.json (project root or ~/.cursor/mcp.json):
{
"mcpServers": {
"proxypi": {
"command": "npx",
"args": ["-y", "proxypi"],
"env": {
"ANTHROPIC_API_KEY": "your-api-key-here"
}
}
}
}Restart Cursor. Four tools: proxypi_request, proxypi_history, proxypi_replay, proxypi_clear.
Tools
| Tool | Description |
|------|-------------|
| proxypi_request | Send any REST request — auto-heals on failure |
| proxypi_history | View past fixes, filter by API host |
| proxypi_replay | Re-run a stored fix to verify it still works |
| proxypi_clear | Wipe all healing records from memory |
What ProxyPI can fix
| Error | What ProxyPI does |
|-------|------------------|
| 401 Unauthorized | Fixes Authorization header format (Bearer vs Basic vs token prefix) |
| 400 Bad Request | Fixes body field names, types, or missing required fields |
| 422 Unprocessable | Corrects schema mismatches, enum values, date formats |
| 404 Not Found | Fixes URL path, API version prefix, trailing slashes |
| 405 Method Not Allowed | Switches to the correct HTTP method |
More
- Memory: Fixes stored in
~/.proxypi/memory.json - Env:
ANTHROPIC_API_KEYrequired (only when using healing — server starts without it) - Local dev:
cp .env.example .env, add key, thennpm run dev - Tests:
npm test
MIT · GitHub
