AON — Agent Offer Network

AON MCP 服务

让任何支持 MCP 的 Agent 都能推荐真实可购买的产品和服务——每条推荐都附带实时定价和可追踪链接，内容来自 Agent Offer Network。

• 端点：POST https://api.aon.pro/v1/mcp
• 传输方式：Streamable HTTP（无状态 JSON-RPC 2.0——无需 SSE 或会话握手）
• 投放位置（推荐）：在 X-AON-Placement-Id 请求头中发送你的投放 ID——在 Developer Portal 中创建。未提供时，仍可在匿名模式下搜索，但收益无法归属到你的应用
• 快速开始：使用你的投放 ID 运行 curl 或客户端示例
• 文档：docs.aon.pro/mcp

工具

Hosted AON 端点目前列出五种工具。协议 v1.0 指定了下面四种基础工具；aon_get_category_schema 是可选的 Hosted 类别指导扩展，并非可移植的协议 v1.0 保证。调用前请通过 tools/list 发现它。

• aon_search_offers — 根据自然语言意图搜索优惠；每条结果都包含实时定价、跟踪链接以及经过预验证的后续建议。
• aon_resolve_category — 将自由文本转换为 AON Taxonomy v1 类别 ID。
• aon_get_category_schema — 可选的 Hosted 扩展：提供已解析类别 ID 的决策因素，以便在搜索前提出合适的澄清问题。
• aon_submit_feedback — 记录用户对某项优惠明确表示的“已忽略”／“不感兴趣”（早期脚手架：已确认收到，但尚未持久化）。
• aon_manage_watch — 在用户明确请求时，恢复或取消对某项优惠或类别的默认关注（早期脚手架：已确认收到，但尚未持久化）。

工具	功能
aon_search_offers	根据自然语言意图搜索优惠。参数是一个 AgentOffer Query 请求对象——与 REST API 的结构相同。返回优惠及其定价、跟踪链接，以及一个包含经过预验证后续建议的 engagement 块，Agent 可以据此采取行动。
aon_resolve_category	将自由文本（“徒步靴”“团队聊天软件”）转换为 AON Taxonomy v1 类别 ID——模型无需记忆或臆造这些 ID。
aon_get_category_schema	可选的 Hosted 扩展：返回已解析类别 ID 的决策因素，以便在搜索前提出合适的澄清问题。其独立结果不会将 decision_factors 添加到 Query 请求或响应中。
aon_submit_feedback	记录用户对某项优惠明确表示的“已忽略”／“不感兴趣”——绝不会根据沉默推断。早期脚手架：调用会成功确认收到，但反馈尚未持久化；相关工作流正在逐步推出。
aon_manage_watch	在用户明确提出请求时，恢复（watch）或取消（unwatch）对某项优惠或类别的默认关注。早期脚手架：已成功确认收到，但关注状态尚未持久化。

Agent 可从以下设计说明中获益：

• 宽容设计 — 无效值不会导致搜索失败；系统会将其视为“未发送”，并在 extra.hints[] 中予以修正。只有格式错误、未知或未启用的 placement、无效 JSON、缺少 intent.content 或请求正文过大才会导致硬性失败。缺少 placement 不算错误：调用会以匿名模式运行。
• 相关性门控 — 空结果列表也是有效答案，绝不填充无关内容。
• 指导循环 — 后续建议包含一个 RFC 7386 request_patch，可直接合并到下一次调用中；还包含一个 origin，用于回传并归因建议采纳情况。

快速开始

curl -s -X POST https://api.aon.pro/v1/mcp \
  -H "Content-Type: application/json" \
  -H "X-AON-Placement-Id: $AON_PLACEMENT_ID" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "aon_search_offers",
      "arguments": {
        "intent": {
          "content": [
            { "type": "input_text", "text": "credit card with cashback" }
          ]
        }
      }
    },
    "id": 1
  }'

还没有 placement？请在 Developer Portal 中创建应用和 placement，并将 placement ID（plc_…）保存到 $AON_PLACEMENT_ID。它用于标识你的 placement，可安全用于客户端配置。

若只想试用端点，可以不发送 X-AON-Placement-Id 标头：调用会通过 AON 的共享默认 placement 以匿名模式运行，响应中会包含 extra.identity.mode="anonymous"，并且不会带来任何收益——匿名调用产生的点击和转化无法归因到你的应用，也无法事后补记。正式接入流量前，请配置 placement ID。

客户端设置

可直接粘贴的配置位于 examples/：

客户端	配置
Claude Code	examples/claude-code
Claude Desktop	examples/claude-desktop（通过 mcp-remote）
Cursor	examples/cursor
VS Code	examples/vscode
纯 curl	examples/curl

速率限制

/v1/mcp 每个应用每分钟允许 60 次 tools/call 请求；握手调用（initialize、tools/list、notifications/*）不计入限制。超出限制的 tools/call 请求会返回 HTTP 429 响应，其中包含 Retry-After 标头和 JSON-RPC 错误 -32000，以便模型读取重试建议。详情请参阅： 速率限制与常见问题。

变现与归因

每个优惠都包含一个可追踪的目标链接（action.payload.url）。 请原样展示该链接——点击和转化会归因到你所放置内容对应的应用，这是开发者收入分成的依据。报告可在开发者门户中查看。

注册表清单

server.json 是此服务的 MCP 注册表清单（架构 2025-12-11，命名空间 pro.aon——已通过 DNS 针对 aon.pro 域名验证）。

相关仓库

• protocol — AgentOffer Protocol 规范（规范性文件）
• schema — JSON 架构、TypeScript 类型、分类体系
• examples — HTTP / SDK / Agent 集成示例
• rfcs — 协议演进提案

许可证

Apache-2.0