AON — Agent Offer Network

AON MCP Server

あらゆるMCP対応エージェントが、実際に購入できる商品やサービスをおすすめできるようになります。すべてのオファーには、リアルタイムの価格と追跡可能なリンクが含まれており、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 エンドポイントには、現在5つのツールが掲載されています。Protocol v1.0 では、以下の4つの基本ツールが定義されています。aon_get_category_schema は任意の Hosted カテゴリーガイダンス拡張であり、Protocol 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 ブロックとともに、オファーを返します。
aon_resolve_category	自由形式のテキスト（「ハイキングブーツ」、「チームチャットソフトウェア」など）を AON Taxonomy v1 のカテゴリー ID に変換します。モデルがカテゴリー ID を暗記したり、作り出したりする必要はありません。
aon_get_category_schema	任意の Hosted 拡張：解決済みのカテゴリー ID に対する判断要素を返し、検索前に適切な確認質問をできるようにします。単独で取得した結果は、Query リクエストやレスポンスに decision_factors を追加しません。
aon_submit_feedback	オファーに対するユーザーの明示的な「非表示」／「興味なし」を記録します。沈黙から推測することはありません。初期段階のスキャフォールド：呼び出しは成功として受け付けられますが、フィードバックはまだ保存されません。この機能の背後にあるワークフローは順次展開中です。
aon_manage_watch	ユーザーから明示的なリクエストがあった場合に、オファーまたはカテゴリーのデフォルトのウォッチを復元（watch）またはキャンセル（unwatch）します。初期段階のスキャフォールド：成功として受け付けられますが、ウォッチの状態はまだ保存されません。

エージェントに役立つ設計上の注意点：

• 柔軟な設計 — 無効な値が原因で検索に失敗することはありません。無効な値は「送信されなかった」ものとして扱われ、extra.hints[] で修正されます。不正な形式、未知または無効なプレースメント、無効な JSON、intent.content の欠落、またはサイズ超過の本文のみが致命的なエラーになります。プレースメントがなくてもエラーにはなりません。呼び出しは匿名モードで実行されます。
• 関連性を重視 — 結果リストが空でも、それは正当な回答であり、埋め合わせではありません。
• ガイダンスループ — フォローアップ候補には、次の呼び出しにそのままマージできる 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
  }'

まだプレースメントをお持ちでない場合は、Developer Portal でアプリケーションとプレースメントを作成し、プレースメント ID（plc_…）を $AON_PLACEMENT_ID に保存してください。この ID はプレースメントを識別するもので、クライアント設定で安全に使用できます。

エンドポイントを試すだけの場合は、X-AON-Placement-Id ヘッダーを省略してください。呼び出しは AON の共有デフォルトプレースメントを通じて匿名モードで実行され、レスポンスには extra.identity.mode="anonymous" が含まれます。この場合、収益は発生しません。匿名の呼び出しによるクリックやコンバージョンは、後から遡っても含め、アプリケーションに関連付けられません。実際のトラフィックを送る前に、プレースメント 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 では、アプリケーションごとに tools/call リクエストを1分あたり60回まで許可しています。ハンドシェイク呼び出し（initialize、tools/list、notifications/*）はカウントされません。上限を超えた tools/call は、Retry-After ヘッダーと JSON-RPC エラー -32000 を含む HTTP 429 を返すため、モデルは再試行に関する案内を確認できます。詳細については、レート制限と FAQをご覧ください。

マネタイズとアトリビューション

すべてのオファーには、トラッキング付きの遷移先リンク（action.payload.url）が含まれています。そのまま表示してください。クリックとコンバージョンは、掲載先のアプリケーションにアトリビューションされ、これが開発者への収益分配の基準になります。レポートは開発者ポータルで確認できます。

レジストリマニフェスト

server.jsonは、このサーバーの MCP レジストリマニフェストです（スキーマ 2025-12-11、名前空間 pro.aon — aon.pro ドメインに対して DNS 検証済み）。

関連リポジトリ

• protocol — AgentOffer Protocol の仕様（規範）
• schema — JSON スキーマ、TypeScript 型、タクソノミー
• examples — HTTP／SDK／エージェント統合の例
• rfcs — プロトコル進化に関する提案

ライセンス

Apache-2.0