# failecho

failecho queries an open network of failure metadata before retrying broken tool calls. Helps autonomous agents apply proven fixes or abort hopeless attempts.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 2 repo stars
- Author: FailEcho
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/FailEcho/failecho
- Updated: 2026-09-24
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/failecho

## What it does

When an API drops requests or hits rate limits, agents often loop through useless retries. FailEcho shares failure resolution patterns across runs. Before retrying a failed tool or model call, your agent inspects what resolved that exact issue elsewhere.

The service logs only metadata without prompts or private payloads. You do not need an account or an API key. Connection works via an HTTP endpoint at `https://failecho.com/mcp` or through a local stdio runner using `npx -y failecho-mcp`.

Models rarely check MCP tools without explicit instructions.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://failecho.com/mcp`
- Environment variables: `FAILECHO_URL`, `FAILECHO_REPORTER_ID` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http failecho https://failecho.com/mcp
```

2. **Platform CLI**
```bash
claude mcp add --env FAILECHO_URL=<FAILECHO_URL> --env FAILECHO_REPORTER_ID=<FAILECHO_REPORTER_ID> --transport stdio failecho -- npx -y failecho-mcp
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add failecho --url https://failecho.com/mcp
```

2. **Platform CLI**
```bash
codex mcp add failecho --env FAILECHO_URL=<FAILECHO_URL> --env FAILECHO_REPORTER_ID=<FAILECHO_REPORTER_ID> -- npx -y failecho-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "failecho": {
            "url": "https://failecho.com/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "failecho": {
            "command": "npx",
            "args": [
                "-y",
                "failecho-mcp"
            ],
            "env": {
                "FAILECHO_URL": "<FAILECHO_URL>",
                "FAILECHO_REPORTER_ID": "<FAILECHO_REPORTER_ID>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "failecho": {
            "type": "http",
            "url": "https://failecho.com/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "failecho": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "failecho-mcp"
            ],
            "env": {
                "FAILECHO_URL": "<FAILECHO_URL>",
                "FAILECHO_REPORTER_ID": "<FAILECHO_REPORTER_ID>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http failecho https://failecho.com/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e FAILECHO_URL=<FAILECHO_URL> -e FAILECHO_REPORTER_ID=<FAILECHO_REPORTER_ID> failecho npx -y failecho-mcp
```
Replace <…> with your own values

## When to use it
- check crowd-sourced fixes before re-executing broken tool calls
- stop pointless retry loops when quotas are completely exhausted
- switch models automatically when receiving 429 rate limit responses
- share crash metadata across workflows without exposing user prompts

## Example prompts
- Check failecho for known remedies to this Groq 429 rate limit error
- The bash command failed, ask failecho if retrying makes sense
- Query failecho to see what worked for other agents on this API failure

## Similar
- [error-detective](https://affpapa.org/en/nevibecode/agents/error-detective.md) — subagent · 7557 installs
- [debugging](https://affpapa.org/en/nevibecode/skills/siviter-xyz-debugging.md) — skill · 151 installs
- [debug](https://affpapa.org/en/nevibecode/rules/debug.md) — rule · ★ 1054 repo stars
- [no-workarounds](https://affpapa.org/en/nevibecode/skills/no-workarounds.md) — skill · 593 installs
- [silent-failure-hunter](https://affpapa.org/en/nevibecode/agents/silent-failure-hunter.md) — subagent · ★ 47914 repo stars
- [error-analysis](https://affpapa.org/en/nevibecode/commands/error-analysis.md) — command · ★ 42780 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
