Skip to main content
Glama

AON MCP Server

MCP対応のエージェントであればどれでも、実際に購入できる本物の商品・サービスをレコメンドできるようになります。すべてのオファーには、Agent Offer Networkから取得された、リアルタイムの価格とトラッキング可能なリンクが付属します。

  • エンドポイント: POST https://api.aon.pro/v1/mcp

  • トランスポート: Streamable HTTP(ステートレスなJSON-RPC 2.0 — SSEなし、セッションハンドシェイクなし)

  • 認証: Authorization: Bearer <AON API key> — 無料キーは開発者ポータルで取得できます

  • 今すぐ試す: クイックスタートに共有の公開デモキーが掲載されています — curl1つで、サインアップは不要です

  • ドキュメント: docs.aon.pro/mcp

ツール

ツール

説明

aon_search_offers

自然言語の意図でオファーを検索します。引数はAgentOffer Queryのリクエストオブジェクトであり、REST APIと同じ構造です。価格、各オファーのトラッキングリンク、そしてエージェントがそのまま処理できる検証済みのフォローアップ提案を含むengagementブロックを返します。

aon_resolve_category

自由テキスト(“hiking boots”、“team chat software”)をAON Taxonomy v1のカテゴリIDに変換します。エージェントがIDを記憶したり、独自に作り出したりする必要はありません。

aon_get_category_schema

カテゴリ内で購入者が重視している決定要因を取得し、検索する前に適切な質問を聞くための情報を提供します。

aon_submit_feedback

ユーザーからのオファーに対する明示的な「dismissed」/「not interesting」を記録します。沈黙から推測することはありません。初期のスキャフォールド: 呼び出しは成功として応答されますが、フィードバックはまだ永続化されておらず、機能提供のワークフローは段階的に展開されています。

aon_manage_watch

ユーザーが明示的に求めた場合、オファーまたはカテゴリの既定のウォッチを復元(watch)または解除(unwatch)します。初期のスキャフォールド: 成功として応答されますが、ウォッチ状態はまだ永続化されていません。

エージェントに有益な設計上のメモ:

  • フォーな設計 — 無効な値は検索を失敗させず、「送信されなかった」ものとして扱い、extra.hints[]の中の修正された形で返します。認証情報の誤り、不正なJSON、intent.contentの欠落、またはボディサイズが大きすぎる場合だけがハードな失敗になります。

  • 関連性によるゲート — 空の結果リストも「誤まった情報」ではなく、れっきとした回答です。

  • 加導ループ — フォローアップの提案にはRFC 7386のrequest_patchが含まれており、次の呼び出しにそのまま統合されます。さらに、帰属情報を反映させるためのoriginも送信されます。

Related MCP server: Agentic Travel Recommendations Service

クイックスタート

curl -s -X POST https://api.aon.pro/v1/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $AON_API_KEY" \
  -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
  }'

まだキーがない場合はクイックスタートから共有デモキーをコピーして、$AON_API_KEYに設定してください。

クライアント設定

コピーしてそのまま使える設定ファイルはexamples/にあります。

クライアント

設定

Claude Code

examples/claude-code

Claude Desktop

examples/claude-desktopmcp-remote経由)

Cursor

examples/cursor

VS Code

examples/vscode

通常のcurl

examples/curl

レート制限

/v1/mcp では、キーごとに1分あたり60回のtools/callリクエストを許可しています。ハンドシェイク呼び出し(initializetools/listnotifications/*)はカウントされません。上限を超えた tools/call はHTTP 200とJSON-RPCエラー-32000を返すため、モデルはリトライに関するアドバイスを読むことができます。詳細はレート制限とFAQをご覧ください。

収益化と帰属

オオすべてのオファーには、追跡された遷移先リンク(action.payload.target)が含まれています。このリンクをそのまま表示してください。クリックとコンバージョンは、あなたのAPIキーのアプリケーションに帰属します。これが開発者への収益分配の基本です。レポートは開発者ポータルで提供されています。

レジストリマニフェスト

server.json は、このサーバーのMCPレジストリマニフェストです(schema 2025-12-11、namespace pro.aon — aon.proドメインに対してDNS検証済み)。

関連リポジトリ

  • protocol — AgentOfferプロトコル仕様(規範的内容)

  • schema — JSON Schemas・TypeScript型の定義・タソノミー

  • examples — HTTP / SDK / エージェント連携の例

  • rfcs — プロトコルの進化に関する提案

ライセンス

Apache–2.0

Related MCP Connectors

Related MCP Servers