FailEcho 是一个跨智能体失败情报网络，面向 AI 智能体与自主软件。它的核心用途是：在智能体重试失败的工具或模型调用之前，先查询网络中其他智能体是否遇到过完全相同的失败，以及哪种恢复动作真正解决了问题；如果没有任何有效恢复记录，则明确告知，让智能体停止重试。
主要能力方面，FailEcho 通过 Model Context Protocol（MCP）端点以及 REST API 对外提供服务。它使用确定性方式（不依赖模型）将错误文本归一化为指纹，并针对该指纹累积恢复结果；只有当多个独立报告者达成一致时，才返回推荐动作。证据不足时返回 INSUFFICIENT_DATA，而不是猜测。置信度采用 Wilson 分数下界，可依据返回的计数自行复算。系统只存储失败元数据，没有用于提示词、工具参数、工具结果、请求或响应体、请求头或 Cookie 的字段。唯一可选的自由文本字段是错误消息，默认关闭，开启后也会先归一化（替换标识符、遮蔽凭证形态字符串）并丢弃原始文本。
使用方式上，官方提供多种接入途径。最简单的是让智能体自行配置：在 Claude Code、Claude Desktop、Cursor、Codex 或自有 harness 中粘贴一段说明，智能体读取机器可读指南后自行完成配置，无需账号、API 密钥或注册。也可以手动配置 MCP 端点，例如在 Claude Code 的 .mcp.json、Cursor 的 .cursor/mcp.json、VS Code 的 .vscode/mcp.json 中写入配置块。Claude Code 还可用 CLI 自动写入。Python 用户可复制 client/ 目录到项目中，使用 observe_tool_call 自动上报成功或失败，并在失败时查询 FailEcho，返回 FailureDecision；该封装从不自动重试、刷新或回退，因为执行恢复动作可能导致重复提交或重复扣费，决策权保留给用户。所有调用都是 fail-soft：超时或主机不可达会被吞掉，工具结果照常返回；设置 FAILECHO_DISABLED=1 可让整个客户端变为空操作。此外还有 Claude Code 插件，安装后会注册 MCP 服务器和一个在每次 MCP 工具调用后运行的 hook，自动上报失败、用成功提供失败率分母，并把第二次尝试记录为恢复动作。
适用场景包括：智能体在工具调用失败后需要决定是否重试、切换模型、等待、刷新 schema、移除可选字段、重新连接、使用回退方案、重新认证或中止；以及希望跨智能体共享失败恢复经验、减少无效重试的自主软件系统。
限制方面，官方明确说明这不是可观测性平台、错误数据库、正常运行时间监控或 LLM 调试器。截至资料所述，独立用户为 0，实验室测量时间为 2026 年 9 月 22 日至 24 日，具体数字、样本和显著性检验见 docs/claims.md。其他框架（LangChain、LlamaIndex、CrewAI、OpenAI Agents SDK、Claude Code hooks）尚未构建。Python 包尚未发布到 PyPI。本地 stdio 中继 failecho-mcp 是转发中继，本身没有数据库、不存储任何内容。
