Agoranome seller tools について
Agoranome のホスト型 MCP サービスは、購入者やエージェント向けに x402 API のオファーを Fair Offer Standard に照らして確認します。価格、サンプル、レシートなどの検証可能な項目を扱います。
主な機能
- 01ライブオファーの申告内容を確認
- 02Fair Offer データブロックを検証
- 03Bazaar 掲載価格と照合
- 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 エージェントに誠実に販売するための、公開された 7 つのルールと、x402 の支払いハンドシェイク内でそれらを証明する機械可読な方法です。バージョン 0.2(ドラフト)。
人間向けのページ:https://agoranome.com/standard ·
JSON:standard.json ·
スキーマ:schema/fair-offer-0.2.schema.json
7 つのルール
| ID | ルール | 意味 | 確認方法 |
|---|---|---|---|
| FO-1 | 支払い前に価格を提示 | 未払いの呼び出しは、価格、アセット、ネットワーク、支払い先アドレスを明記した x402 オファー(HTTP 402)を返します。購入者がそのオファーに正確に署名する前に、料金が請求されることはありません。 | 確認 |
| FO-2 | 失敗時は無料 | 呼び出しが失敗、タイムアウト、または結果なしで返された場合、決済されません。その旨が購入者に伝えられます。 | 自己申告 |
| FO-3 | レシートに署名する | 有料の結果にはすべて、販売者の鍵で署名されたレシートが付属します。購入内容、金額、日時が記載されます。 | 確認 |
| FO-4 | 購入前にサンプルを確認 | 無料サンプルでは有料ルートが返す内容を確認でき、第三者はサンプルと有料オファーが同じホストから提供されていることを証明できます。 | 確認 |
| FO-5 | 正直な掲載内容 | 掲載情報の説明、入力スキーマ、出力例は、ルートが実際に返す内容と一致しています。購入者を獲得するために編集しても、真実に即していなければなりません。 | 確認 |
| FO-6 | 指示ではなくデータを返す | レスポンスには、購入者のエージェントが利用するためのデータを含め、エージェントに向けた指示は含めません。購入者は、レスポンス内の指示を攻撃として扱えます。 | 自己申告 |
| 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 の extensions に配置し(ハンドシェイクを参照)、この URL を llms.txt またはエージェントマニフェストから "conforms_to": {"fair_offer": "0.2"} としてリンクしてください。
証明の要求: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 件の配信がある。オンチェーンで確認された、購入者が支払ったレシート(evidence commons) |
オファーの確認
- ブロックを検証します:
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 に導入していますか?ホストにイシューを送れば、ここに掲載できます。
変更の提案
イシューまたはプルリクエストを作成してください。ブロックのフィールドを変更する場合は、新しいバージョンに反映します。そのため、0.2 向けに作成された購入者のポリシーは引き続き機能します。修正、データに関する質問、複製のリクエストは、[email protected] にもお寄せいただけます。
バージョン
- 0.1:エージェントのマニフェストまたは llms.txt で宣言する、7 つのルール。
- 0.2:同じ 7 つのルールに加え、x402 の 402 と購入者の Accept-Proof ヘッダーに含める、機械可読なフェアオファーブロック。
ライセンス
標準テキスト、スキーマ、サンプルは CC BY 4.0 の下でライセンスされています。自由に実装してください。 「The Fair Offer Standard, Agoranome」とクレジットを表示してください。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。