mcpField
A
Agoranome seller tools

Agoranome seller tools

远程服务
agoranome.com商业与营销03 天前更新

关于 Agoranome seller tools

Agoranome 托管的 MCP 服务用于检查 x402 API 的 Fair Offer 声明,面向购买者及其 Agent。它依据公开标准核验价格、样例和收据等承诺。

主要功能

  1. 01检查实时报价声明
  2. 02验证 Fair Offer 数据块
  3. 03核对价格与 Bazaar 列表
  4. 04检查签名收据和免费样例

适用场景

  1. 01付款前核验 x402 报价
  2. 02检查卖家列出的服务声明

MCP 相关

托管的 MCP 服务提供 check_offer 工具,供 MCP 客户端检查报价。

配置

远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。

服务地址https://api.agoranome.com/mcp
一键复制安装命令
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

命令在终端中运行;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>=N30 天内至少有 N 名不同的付款人(Bazaar 统计)
calls_30d>=N30 天内至少有 N 次付费调用(Bazaar 统计)
deliveries_30d>=N30 天内至少有 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”。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。