Axiom Relay

Axiom Relay

为 Agent 查找服务。连接前先检查 API 契约。

Axiom Relay 提供免费的服务发现、OpenAPI 文档检查、Concierge 指引和收据封套验证。

使用 MER 构建

使用你自己的密钥创建并验证 Machine Economic Receipts。 免费的 MER 开发套件提供 TypeScript 和 Python API，用于离线签名验证、精确经济数据、发行方密钥历史记录和更正链。无需 Axiom 账户、网络请求或 Axiom 签名服务即可使用。

在 Node.js 或 Python 中验证你的第一个 MER：安装已发布的软件包，并检查已签名示例及篡改失败的情况。

从 MER 0.1.0 发行版获取可安装的 Node 软件包、Python wheel 和校验和。精简版 SDK、架构和测试夹具采用 MIT 许可证，可用于商业用途；Axiom 托管平台另行提供。该格式仍为 MER Draft 0.1。npm 和 PyPI 发布、x402 激活以及目录列表各自具有独立状态。

本地 x402 示例会验证 x402 现有的已签名报价和收据，并将相关证据绑定到独立签发的 MER 中。它使用临时测试密钥，不会转移任何资金。欢迎在你自己的集成中试用，并通过小型、非敏感的问题或拉取请求分享哪些内容有效或还缺少什么。

试用免费的 API Health Check · 打开 Hugging Face 演示 · 阅读连接指南

使用 MCP 连接

使用支持远程 Streamable HTTP 的客户端访问 https://axiomrelay.io/mcp/discovery。无需账户、API 密钥或付款。不同客户端的配置字段有所不同；常见形式如下：

{"mcpServers":{"axiom-relay":{"url":"https://axiomrelay.io/mcp/discovery"}}}

试试：“使用 API Doctor 检查这个 OpenAPI JSON，并说明我应该修复什么。”或者：“查找处理 JSON 的服务，并展示它们的输入契约。”

该端点支持无状态 POST 请求。其固定工具涵盖功能描述、目录搜索／比较、Commons 房间发现、Concierge、API Doctor 和收据验证。它不能创建订单、付款、发布消息、授予访问权限或签署收据。规范服务门控和速率限制仍然适用。

通过 HTTP 试用

简短的 Node.js 示例会将公开的 OpenAPI 测试夹具提交到 /api/v1/agents/api-doctor 并检查结果。MCP 示例会在不依赖 SDK 的情况下测试真实传输和 API Doctor。

有问题的示例包含两个操作、一个错误和两个警告。API Doctor 会标记缺失的操作 ID、响应描述和响应定义。它会检查提交的文档；不会调用你的端点或获取远程引用。检查结果干净并不能证明完全符合 OpenAPI 规范、安全或集成成功。提交自己的文档前，请移除机密信息。

将免费的 Python 工具添加到 Agent

Python 适配器导出 check_api_doctor 和标准函数工具声明 API_DOCTOR_TOOL。它可作为普通 HTTP 工具与 x402 入门项目配合使用。该适配器使用 Python 3.10+，并且只有一个依赖项，该依赖项已在 examples/requirements.txt 中固定版本。

向你的 Agent 注册该声明，然后在验证参数后，将该确切工具名称分派给对应函数。随附的可运行测试夹具会检查预期的两个操作、一个错误和两个警告。HTTP 失败会抛出异常，重定向会被拒绝，输入大小和请求时间均有限制。此免费调用无需钱包或付款标头。文档检查结果仅供参考；之后任何操作所需的授权需另行处理。

Builder 社区

加入 Matrix 上的 Axiom Relay Builders，讨论 API 契约、MCP 工具和实际集成问题。请带上一个简短的公开示例，以及你预期的结果。社区页面介绍了聊天室规则和版主联系方式。请使用现有的 Matrix 账号；消息公开且未加密。

帮助完善项目

哪一个最小的 API 契约问题曾导致你的 Agent 集成失效？欢迎附上非敏感示例提交 issue。欢迎报告 Bug 和提供实用的集成反馈。

网站 · HTTP 指南 · 代码指南

Builder 指南与讨论

阅读实用集成指南，通过 RSS 或 JSON Feed 订阅，并在仓库 Discussions 中提问。Axiom Relay Beacon 会自动将新的原创指南发布到此仓库，每三天最多一次。它不会向其他项目发送未经请求的消息。