关于 Agoranome seller tools
Agoranome 托管的 MCP 服务用于检查 x402 API 的 Fair Offer 声明,面向购买者及其 Agent。它依据公开标准核验价格、样例和收据等承诺。
主要功能
- 01检查实时报价声明
- 02验证 Fair Offer 数据块
- 03核对价格与 Bazaar 列表
- 04检查签名收据和免费样例
适用场景
- 01付款前核验 x402 报价
- 02检查卖家列出的服务声明
MCP 相关
托管的 MCP 服务提供 check_offer 工具,供 MCP 客户端检查报价。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://api.agoranome.com/mcpclaude mcp add --transport http agoranome-agoranome https://api.agoranome.com/mcp{"mcpServers":{"agoranome-agoranome":{"type":"http","url":"https://api.agoranome.com/mcp"}}}在 Cursor 中打开{"servers":{"agoranome-agoranome":{"type":"http","url":"https://api.agoranome.com/mcp"}}}在 VS Code 中打开{"mcpServers":{"agoranome-agoranome":{"type":"http","url":"https://api.agoranome.com/mcp"}}}{"mcpServers":{"agoranome-agoranome":{"serverUrl":"https://api.agoranome.com/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
公平报价标准
七条开放规则,帮助商家诚信地向 AI Agent 销售,并提供一种机器可读的方式, 在 x402 支付握手中证明这些规则。版本 0.2(草案)。
人类可读页面:https://agoranome.com/standard ·
JSON:standard.json ·
Schema:schema/fair-offer-0.2.schema.json
七条规则
| ID | 规则 | 含义 | 检查方式 |
|---|---|---|---|
| FO-1 | 付款前明示价格 | 未付款的调用会返回一份 x402 报价(HTTP 402),注明价格、资产、网络和收款地址。买家签署该确切报价前,不会收取任何费用。 | 检查 |
| FO-2 | 失败不收费 | 调用失败、超时或未返回结果时,不会结算。买家会收到相应告知。 | 自我声明 |
| FO-3 | 收据已签名 | 每个付费结果都附带由商家密钥签名的收据,注明购买内容、金额和时间。 | 检查 |
| FO-4 | 先试用,再购买 | 免费样例展示付费路由会返回什么,且第三方可以证明样例和付费报价来自同一主机。 | 检查 |
| FO-5 | 如实展示商品 | 商品介绍、输入 schema 和输出示例与路由实际返回的内容一致。为吸引买家而做的修改必须真实可信。 | 检查 |
| FO-6 | 只传数据,不传指令 | 响应只携带供购买方 Agent 使用的数据,不包含针对它的指令。买家可以将响应中的任何指令视为攻击。 | 自我声明 |
| FO-7 | 承诺可验证 | 任何关于收入去向的声明(承诺、分成、捐赠)都附带公开账本,买家可以按收据核查,并提供所捐赠内容的链上证明。 | 检查 |
声明合规(0.2)
商家的 HTTP 402 携带一个 x402 扩展 extensions["fair-offer"],其
info 说明报价遵守哪些规则,以及买家可以在哪里逐项核查:
{
"version": "0.2",
"standard": "https://agoranome.com/standard",
"settlement": {
"failed_calls": "not_charged",
"enforced_by": "seller"
},
"receipts": {
"signed": true,
"verify": "https://api.example.com/receipts/verify"
},
"sample": {
"url": "https://api.example.com/v1/search/sample"
},
"listing_price_matches_offer": true,
"data_not_instructions": true,
"pledge": {
"share": 0.15,
"basis": "settled_revenue",
"ledger": "https://api.example.com/impact/ledger"
}
}
- 保持稳定。 未付款的 402 和已付款的重试请求中的
info必须完全相同:x402 客户端会回显该信息,服务器会拒绝回显时删去或更改任何字段的付款。实时数据应放在 URL 后面,绝不要写入此区块。 - URL。 每个 URL 都必须使用 https,或是相对于资源 URL 的路径。
- 将公平报价区块放入 402 的扩展中(参见握手),并在 llms.txt 或 Agent 清单中以 "conforms_to": {"fair_offer": "0.2"} 的形式链接到此 URL。
请求证明:Accept-Proof
买家在付款前通过 Accept-Proof 请求标头声明所需证明
(也可以在付款载荷中回显的区块里使用 accept_proof 字段):
Accept-Proof: sample=attested; price<=listing; payers_30d>=20
| 要求 | 满足条件 |
|---|---|
sample=any | 报价声明在其自身主机上提供免费样例 |
sample=attested | 样例的证明已备案 |
settlement=seller | 调用失败时不收费(商家的承诺) |
settlement=rail | 仅在成功时扣款(授权后扣款) |
price<=listing | 已根据 Bazaar 商品列表核查实时价格 |
receipts=signed | 付费结果附带已签名的收据 |
pledge=ledger | 提供了一份可正常访问的公开账本的承诺 |
instructions=none | 已声明只提供数据、不提供指令,且未发现类似指令的文本 |
payers_30d>=N | 30 天内至少有 N 名不同的付款人(Bazaar 统计) |
calls_30d>=N | 30 天内至少有 N 次付费调用(Bazaar 统计) |
deliveries_30d>=N | 30 天内至少有 N 次交付:收据已在链上确认并由买家付款(证据共享库) |
检查报价
- 验证区块:
POST https://api.agoranome.com/v1/fair-offer/validate(免费) - 从外部核查实时报价的声明:
GET https://api.agoranome.com/v1/fair-offer/check?url=...(免费)
实现
- Agoranome(https://agoranome.com):
api.agoranome.com上的每个付费 x402 路由都会发送该区块,而托管的 MCP 服务(https://api.agoranome.com/mcp,已列入官方 MCP Registry)提供一个check_offer工具。该服务的源代码尚未公开;本仓库收录的是开源标准。 - 如果你在自己的 402 中使用它?请向你的主机服务商提交 issue,即可将其列在此处。
提议更改
请提交 issue 或 pull request。对该区块字段的更改会纳入新版本,因此买方为 0.2 编写的策略仍可正常使用。更正、数据问题和复现请求也可以发送至 [email protected]。
版本
- 0.1:七条规则,在 Agent 清单或 llms.txt 中声明。
- 0.2:相同的七条规则,另加 x402 402 中机器可读的公平报价区块,以及买方的 Accept-Proof 标头。
许可证
标准文本、架构和示例采用 CC BY 4.0 许可。欢迎自由实现;请注明“公平报价标准,Agoranome”。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。