Agent Kiosk — 23-in-1 B2A Intelligence, Action & x402 API

Agent Kiosk — 24-in-1 自律型 B2A インテリジェンス、アクション、コンプライアンスのスーパーマーケット（x402 v2 & MCP）

Agent Kiosk は、Base Mainnet (eip155:8453) 上で自律型 AI エージェント、トレーディングボット、コーディングアシスタント、研究ワークフロー向けに構築された、即時利用可能な従量課金 API および Model Context Protocol（MCP）サーバーです。有料およびプリペイドのすべてのレスポンスには、暗号署名付きの SHA-256 + HMAC-SHA256 attestation エンベロープ（attested タグ）が含まれます。

• 本番用 Base URL： https://agent-kiosk.vercel.app
• 加盟店の支払い受取先（payTo）： 0xd8429209Aee6A398B9707DFf5F28AAA93452eE95（Base USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913、小数桁数 6）
• カタログの範囲： x402 で保護されたエンドポイント 24 個（呼び出しごとに課金される有料エンドポイント 23 個 + プリペイド 30 日間 API パス 1 個）に加え、無料のディスカバリー、テレメトリー、MCP ティーザー、パートナー手数料スワップのルート
• ライブテレメトリーとウォレットダッシュボード： https://agent-kiosk.vercel.app/stats（GET /v1/stats JSON）
• MCP エンドポイント： https://agent-kiosk.vercel.app/mcp（https://agent-kiosk--batuhansenavci.run.tools）
• x402scan ストア（24/24 検証済み）： x402scan.com/server/a1af2789-615a-4324-b3f1-83b97834ece8
• Glama MCP 掲載ページ： glama.ai/mcp/servers/ralf9090/agent-kiosk
• Smithery ストア： smithery.ai/servers/batuhansenavci/agent-kiosk

---

1. 統合ルート、メソッド、価格カタログ

A. 呼び出しごとに課金される有料 x402 エンドポイント 23 個（Base USDC eip155:8453）

すべての /v1/* ルートは POST（主に JSON ボディ）と GET（クエリパラメーター）を受け付けます。認証されていないリクエストには、PAYMENT-REQUIRED ヘッダー付きの HTTP 402 Payment Required が返されます。

#	MCP ツール	x402 REST ルート	メソッド	価格（USDC）	最小単位（小数点以下6桁）	説明
1	x402_ping	/v1/ping	POST / GET	$0.001	1000	x402 v2 および v1 のウォレットを即時に検証する ping、決済チェック、往復エコーです。
2	llm_chat_completions	/v1/chat/completions	POST / GET	$0.002	2000	OpenAI 互換の LLM Chat Completions ゲートウェイ（gpt-4o-mini、openai、deepseek-chat）です。
3	evm_tx_simulator	/v1/tx-simulate	POST / GET	$0.005	5000	EVM トランザクションの事前シミュレーター（eth_call + eth_estimateGas）、リバートデコーダー、ERC-20 allowance および EIP-1967 プロキシ検出機能です。
4	perp_funding_arbitrage	/v1/funding-rates	POST / GET	$0.008	8000	取引所間の無期限先物ファンディングレート裁定取引、ベーシス APR スプレッド、未決済建玉レーダー（Hyperliquid + dYdX v4）です。
5	tradfi_macro_radar	/v1/macro-radar	POST / GET	$0.008	8000	S&P 500、Nasdaq、VIX、DXY、米国10年国債利回り、金、原油、暗号資産の恐怖・強欲指数、BTC ドミナンス、DeFi TVL のリアルタイム情報です。
6	web_extract	/v1/web-extract	POST / GET	$0.01	10000	プロンプトインジェクションの罠を検出する、URL から Markdown へのクリーンな変換ツールです。
7	package_audit	/v1/package-audit	POST / GET	$0.01	10000	Google OSV.dev を利用した、オープンソースパッケージおよび CVE の脆弱性スキャナー（npm、PyPI、crates.io）です。
8	github_intel	/v1/github-intel	POST / GET	$0.01	10000	GitHub リポジトリおよびオープンソースの競合インテリジェンスです。スター数、リリース、イシュー、トピックのリーダーを確認できます。
9	kalshi_polymarket_arb	/v1/prediction-arb	POST / GET	$0.015	15000	Kalshi、Polymarket、Manifold の予測市場を統合し、複数プラットフォーム間の確率スプレッドをスキャンします。
10	social_search	/v1/social-search	POST / GET	$0.02	20000	Reddit および HackerNews の最新の議論を、整形済みの JSON と Markdown で取得します。
11	security_audit	/v1/security-audit	POST / GET	$0.02	20000	0x トークン／コントラクトのハニーポットおよび税率スキャナー（GoPlus + DexScreener）と、URL のフィッシング監査です。
12	token_alpha	/v1/token-alpha	POST / GET	$0.02	20000	DEX のリアルタイム注文フロー（買い圧力と売り圧力）、流動性の厚み、モメンタムシグナルです。
13	domain_intel	/v1/domain-intel	POST / GET	$0.02	20000	B2B 企業およびドメインのインテリジェンスです。DNS、MX メールプロバイダー、SaaS TXT スタック、RDAP、サブドメインを確認できます。
14	academic_search	/v1/academic-search	POST / GET	$0.02	20000	査読済み科学文献の検索（OpenAlex + arXiv）です。要旨と PDF リンクも取得できます。
15	prediction_markets	/v1/prediction-markets	POST / GET	$0.02	20000	Polymarket と Manifold Markets のイベント発生確率（%）と賭けの取引量をリアルタイムで取得します。
16	defi_yields	/v1/defi-yields	POST / GET	$0.02	20000	DeFiLlama による DeFi の最高 APY および利回りレーダーです。トークン、チェーン、TVL で絞り込めます。
17	maps_leads	/v1/maps-leads	POST / GET	$0.03	30000	都市を指定して取得する B2B ビジネスリードです。電話番号、ウェブサイト、メールアドレス、住所、GPS 情報が含まれます。
18	wallet_profiler	/v1/wallet-profiler	POST / GET	$0.03	30000	マルチチェーンのクジラおよびウォレットプロファイラー（Base、Ethereum、Arbitrum、Polygon）です。USDC／ETH 残高とトランザクション数を確認できます。
19	compliance_check	/v1/compliance-check	POST / GET	$0.05	50000	AML、制裁（OFAC）、取引相手のスクリーニング： Base と Ethereum における14のリスクベクトル（フィッシング、Tornado Cash ミキサー、ハニーポット作成者、ダークウェブ、サイバー犯罪）を確認します。
20	defi_swap_quote	/v1/defi-swap-quote	POST / GET	$0.05	50000	実行可能な DeFi スワップおよびクロスチェーンブリッジの Calldata ビルダー： 最適な DEX ルート（LI.FI + ParaSwap）と、署名可能な EVM transactionRequest（to、data、value、gasLimit）を提供します。
21	token_due_diligence	/v1/token-due-diligence	POST / GET	$0.10	100000	機関投資家向け3-in-1トークン評価： GoPlus コントラクト監査 + DEX 注文フロー + ソーシャルセンチメント（グレード A～F）です。
22	b2b_company_dossier	/v1/b2b-company-dossier	POST / GET	$0.10	100000	4-in-1 B2B エグゼクティブ向け企業情報： DNS／SaaS 技術スタック + ウェブサイトのスクレイピング + 地域別リード + ソーシャルメディアでの言及です。
23	whale_alpha_radar	/v1/whale-alpha-radar	POST / GET	$0.10	100000	3-in-1クジラのポートフォリオおよび利回り最適化： 4チェーンのウォレットプロファイラー + DeFi の高利回り情報 + マクロ市場の確率です。

B. 1 前払い30日間APIパスエンドポイント（Base USDC eip155:8453）

#	MCP ツール	x402 REST ルート	メソッド	価格（USDC）	最小単位（小数点以下6桁）	説明
24	buy_prepaid_pass	/v1/buy-pass	POST / GET	$5.00	5000000	30日間前払いVIP APIキー（ak_live_...）： ステートレスなHMAC-SHA256署名付きAPIキーを発行し、X-API-KEY または Authorization: Bearer を使って、呼び出しごとのx402署名なしで、23個すべての有料従量課金エンドポイントを30日間利用できます。

C. 無料／未払いルート（$0.00 USDC — x402決済なしでHTTP 200）

ルート	メソッド	価格	用途
/v1/free-swap	POST / GET	$0.00	決済不要で実行可能なDEXスワップおよびクロスチェーンブリッジのcalldataビルダー（payToWallet 宛てのオンチェーンパートナー手数料0.25%で収益化）。
/v1/models	GET	$0.00	OpenAI互換モデル一覧の検出（gpt-4o-mini、openai、deepseek-chat）。
/mcp	POST / GET	$0.00（ティーザー）／有料（全機能）	Streamable-HTTP MCP JSON-RPC 2.0サーバー（24個すべてのツールを一覧表示。認証なしの tools/call は、HTTP 200で1項目のティーザープレビューと x402_unlock_full_data チャレンジを返します。一方、x402_ping と defi_swap_quote は完全なプレビューデータを返します。ツール引数に payment_signature または x_api_key を渡すと、マスクされていない全データが返されます）。
/v1/stats, /stats	GET	$0.00	サーバーのファネルに関するライブのJSONおよびHTMLテレメトリーと、オンチェーンBase USDCウォレット残高ダッシュボード。
/.well-known/x402.json	GET	$0.00	マシン可読なx402 v2カタログ、ファシリテーター設定、ルート内訳（/.well-known/x402 および /.well-known/agent.json も同じ内容を参照します）。
/.well-known/agent-card.json	GET	$0.00	a2a-x402 拡張機能を備えたGoogle A2A v0.3.0 Agent Card。
/.well-known/mcp.json	GET	$0.00	MCPサーバーマニフェスト（24個のツール、4個のプロンプト、3個のリソース）。
/openapi.json	GET	$0.00	24個すべてのx402エンドポイントを対象とするOpenAPI 3.1.0仕様。
/llms.txt, /llms-full.txt	GET	$0.00	LLM向けの検出カタログ、購入者向け統合ガイド、完全な入力スキーマ。

---

2. 本番環境向けx402購入者ガイドおよびファシリテーター統合

A. Base Mainnet 決済ファシリテーター（当社は販売者であり、ファシリテーターではありません）

Agent Kiosk は、src/x402.js で設定された複数ファシリテーターのフェイルオーバーパイプラインを使用して、Base Mainnet（eip155:8453 / base） 上で受信した EIP-3009（TransferWithAuthorization）USDC 署名を検証し、決済します。

役割	ファシリテーター名	API ベース URL	対応エンドポイント	検証エンドポイント	決済エンドポイント	対応バージョンとスキーム	ファシリテーター署名者／リレイヤーアドレス（加盟店アドレスではありません）
プライマリ	PayAI Network	https://facilitator.payai.network	GET https://facilitator.payai.network/supported	POST https://facilitator.payai.network/verify	POST https://facilitator.payai.network/settle	x402 v2（eip155:8453、exact）および x402 v1（base、exact）、API キー不要	0xB2Bd29925CBbCEA7628279c91945Ca5B98bf371B、0xc6699d2aadA6c36Dfea5C248DD70f9CB0235cB63（および /supported の signers["eip155:*"] に記載されているプール署名者）
セカンダリフォールバック	Dexter	https://facilitator.dexter.cash	GET https://facilitator.dexter.cash/supported	POST https://facilitator.dexter.cash/verify	POST https://facilitator.dexter.cash/settle	x402 v2（eip155:8453、exact）および x402 v1（base、exact）	0x402Feee072D655B85e08f1751AF9ddbCd249521f
第3フォールバック（v1）	Mogami	https://facilitator.mogami.tech	GET https://facilitator.mogami.tech/supported	POST https://facilitator.mogami.tech/verify	POST https://facilitator.mogami.tech/settle	x402 v1（base、exact）	公開 v1 リレイヤープール

• 加盟店受取アドレス（payTo）： 0xd8429209Aee6A398B9707DFf5F28AAA93452eE95（Base Mainnet USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913、小数点以下 6 桁）。

B. 受け付ける支払い、チャレンジ、レシートのヘッダー

方向	ヘッダー／パラメーター	プロトコル	形式と説明
HTTP 402 レスポンス	PAYMENT-REQUIRED	x402 v2	Base64 エンコードされた JSON PaymentRequired チャレンジ（x402Version: 2、scheme: "exact"、network: "eip155:8453"、amount、maxAmountRequired、asset、payTo、maxTimeoutSeconds: 60、extra: { name: "USD Coin", version: "2" } を含む accepts[0]）。同一の JSON オブジェクトが HTTP 402 レスポンス本文としても返されます。
HTTP リクエスト（都度払い）	PAYMENT-SIGNATURE	x402 v2	{ x402Version: 2, scheme: "exact", network: "eip155:8453", payload: { signature, authorization: { from, to, value, validAfter, validBefore, nonce } } } を含む Base64、Base64URL、または生の JSON 文字列。
HTTP リクエスト（レガシー／エイリアス）	X-PAYMENT または X-PAYMENT-SIGNATURE	x402 v1 / v2	X-PAYMENT または X-PAYMENT-SIGNATURE の下に支払いヘッダーを送信する x402 v1（network: "base"）および v2 クライアントで受け付けます。
HTTP リクエスト（プリペイドパス）	X-API-KEY または Authorization: Bearer <key>	プリペイドパス	POST /v1/buy-pass（$5.00 USDC）で発行された ak_live_<payloadB64>.<sigB64> パスを渡すと、都度署名なしで 30 日間、23 個の有料エンドポイントすべてにアクセスできます。
MCP tools/call 引数	payment_signature、x_payment、または x_api_key	HTTP／stdio 経由の MCP	x402 支払いペイロードまたは ak_live_... キーを POST /mcp の params.arguments 内に直接渡すと、MCP クライアントでマスクされていない完全なデータを利用できます。
HTTP 200 レスポンス（レシート）	PAYMENT-RESPONSE および X-PAYMENT-RESPONSE	x402 v2 および v1	ファシリテーターから返される Base64 エンコード済みの JSON 決済レシート：{"success":true,"transaction":"0x...","network":"eip155:8453","payer":"0x..."}。オンチェーン取引ハッシュは、HTTP 200 の JSON 本文でも tx_hash として返されます。

C. タイムアウト、不確定な決済と復旧手順

1. サーバーとチャレンジのタイムアウト：
   • すべての 402 Payment Required チャレンジでは、maxTimeoutSeconds: 60 が指定されています。購入者は、validAfter = 0、validBefore >= now + 300 秒として EIP-3009 TransferWithAuthorization メッセージに署名してください。
   • サーバー側のファシリテーター呼び出しでは、POST /verify の各ファシリテーターに 6.5 秒のタイムアウト、POST /settle の各ファシリテーターに 10.0 秒のタイムアウトが設定されています。
   • プライマリーファシリテーター（facilitator.payai.network）が /verify または /settle で HTTP／ネットワークエラーを返した場合、ミドルウェアは次に設定されているファシリテーター（facilitator.dexter.cash）へ自動的にフェイルオーバーします。署名が暗号学的に無効な場合（invalid_exact_evm_signature）、サーバーは再試行せず、正確なエラー理由を添えてただちに HTTP 402 を返します。
2. 不確定な決済への対処（クライアントのタイムアウト／ネットワーク切断）：
   • 各 EIP-3009 TransferWithAuthorization では、一意の 32 バイト nonce が使用されます。Base Mainnet で一度消費されると、USDC コントラクト（0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913）はその (authorizer, nonce) の組み合わせを使用済みとして恒久的に記録し（AuthorizationUsed イベント）、同じ署名の再利用や二重請求はオンチェーンで不可能になります。
   • タイムアウト時の購入者向けルール： PAYMENT-SIGNATURE を送信した後に HTTP リクエストがタイムアウトまたは切断された場合、ただちに新しい nonce に署名しないでください。
     1. authorizationState(address authorizer, bytes32 nonce)（0xe94a0102）を使って Base USDC（0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913）を照会するか、https://basescan.org/address/0xd8429209Aee6A398B9707DFf5F28AAA93452eE95#tokentxns を確認します。
     2. authorizationState が false（オンチェーンで決済されていない）の場合： validBefore の期限が切れるまで、まったく同じ PAYMENT-SIGNATURE ヘッダー（同じ nonce）を使って安全にリクエストを再試行できます。または、validBefore の期限が切れてから新しい nonce に署名してください。
     3. authorizationState が true（オンチェーンで決済済みだが、HTTP 応答が転送中に失われた）の場合： Base の txHash、エンドポイントのパス、タイムスタンプを添えて github.com/ralf9090/agent-kiosk/issues に issue を作成してください。応答の即時再送、または Prepaid API Pass クレジットの無償付与を受けられます。

---

3. Base Mainnet で検証済みの決済記録（運営者テスト）

開示： 以下のトランザクションは、第三者顧客の利用量ではなく、本番環境へのデプロイ（https://agent-kiosk.vercel.app）に対して実行され、Base Mainnet（eip155:8453）上でPayAI Networkのファシリテーター（https://facilitator.payai.network/settle）を介して決済された運営者によるテスト決済です。

例 1 — POST https://agent-kiosk.vercel.app/v1/token-alpha（0.02 USDC／20000 最小単位）

• エンドポイントとメソッド： POST https://agent-kiosk.vercel.app/v1/token-alpha
• 決済額： 0.02 USDC（20000 最小単位、Base USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913）
• Base Mainnet トランザクションリンク： https://basescan.org/tx/0x5aa1b42ef7dae5323ba561b9374e9e5db0d42b0eae23d7e4fc5c2f0929df61be（ブロック 52809684、ステータス：Success）
• ファシリテーターのリレイヤー（オンチェーンの from）： 0xc6699d2aadA6c36Dfea5C248DD70f9CB0235cB63（PayAI Network のリレイヤー）
• 販売者の受取先（payTo）： 0xd8429209Aee6A398B9707DFf5F28AAA93452eE95

デコード済み PAYMENT-RESPONSE／X-PAYMENT-RESPONSE ヘッダー：

{
  "success": true,
  "transaction": "0x5aa1b42ef7dae5323ba561b9374e9e5db0d42b0eae23d7e4fc5c2f0929df61be",
  "network": "eip155:8453",
  "payer": "0xd8429209aee6a398b9707dff5f28aaa93452ee95"
}

HTTP 200 リソース応答（機密情報を伏せたもの。{"query":"AERO","chain":"base"} を指定して POST /v1/token-alpha を実行）：

{
  "ok": true,
  "payment_mode": "x402",
  "tx_hash": "0x5aa1b42ef7dae5323ba561b9374e9e5db0d42b0eae23d7e4fc5c2f0929df61be",
  "attestation": {
    "attested": true,
    "issuer": "io.github.ralf9090/agent-kiosk",
    "signer_wallet": "0xd8429209Aee6A398B9707DFf5F28AAA93452eE95",
    "algorithm": "HMAC-SHA256",
    "route": "/v1/token-alpha",
    "payload_sha256": "c1bcebf107e25a742a7afc58ca39692bc33f4e6da49a2ca1afc8b892fae63a1f",
    "timestamp_utc": "2026-10-19T11:18:33.296Z",
    "signature": "<REDACTED_ATTESTATION_HMAC>"
  },
  "data": {
    "query": "AERO",
    "found": true,
    "token": {
      "name": "Aerodrome",
      "symbol": "AERO",
      "address": "0x940181a94A35A4569E4529A3CDfB74e38FD98631",
      "primary_chain": "base",
      "price_usd": 0.7866,
      "market_cap_usd": 789632423,
      "fdv_usd": 1575158274
    },
    "alpha_metrics": {
      "signal": "SELL_PRESSURE",
      "total_top5_liquidity_usd": 47963273,
      "volume_1h_usd": 403817,
      "volume_24h_usd": 12606349,
      "order_flow_1h": { "buys": 88, "sells": 495, "buy_pressure_pct": 15.1 },
      "order_flow_24h": { "buys": 3508, "sells": 13997, "buy_pressure_pct": 20 }
    },
    "llm_summary": "Aerodrome (AERO on base): $0.7866 | Signal: SELL_PRESSURE | 1h Buy Pressure: 15.1% (88 buys vs 495 sells) | Liquidity: $47,963,273 | 24h Vol: $12,606,349."
  }
}

例 2 — POST https://agent-kiosk.vercel.app/v1/ping（0.001 USDC／1000 原子単位）

• エンドポイントとメソッド： POST https://agent-kiosk.vercel.app/v1/ping
• 決済額： 0.001 USDC（1000 原子単位）
• Base Mainnet トランザクションリンク： https://basescan.org/tx/0xd4869a2190887c15b9fb53c109045fe60bb6bef6a3cf8b66e6f7e0a9904fda7e（ブロック 52809683、ステータス：Success）
• ファシリテーターリレイヤー（オンチェーンのfrom）： 0xB2Bd29925CBbCEA7628279c91945Ca5B98bf371B（PayAI Network リレイヤー）

デコードされたPAYMENT-RESPONSE／X-PAYMENT-RESPONSEヘッダー：

{
  "success": true,
  "transaction": "0xd4869a2190887c15b9fb53c109045fe60bb6bef6a3cf8b66e6f7e0a9904fda7e",
  "network": "eip155:8453",
  "payer": "0xd8429209aee6a398b9707dff5f28aaa93452ee95"
}

編集済みのHTTP 200リソースレスポンス（{"message":"x402-registry-verification"}を指定したPOST /v1/ping）：

{
  "ok": true,
  "payment_mode": "x402",
  "tx_hash": "0xd4869a2190887c15b9fb53c109045fe60bb6bef6a3cf8b66e6f7e0a9904fda7e",
  "attestation": {
    "attested": true,
    "issuer": "io.github.ralf9090/agent-kiosk",
    "signer_wallet": "0xd8429209Aee6A398B9707DFf5F28AAA93452eE95",
    "algorithm": "HMAC-SHA256",
    "route": "/v1/ping",
    "payload_sha256": "6fc2d484b7899b71b18d80b87c18230e8904e7f296ca3c471763cc618a932041",
    "timestamp_utc": "2026-10-19T11:18:31.280Z",
    "signature": "<REDACTED_ATTESTATION_HMAC>"
  },
  "data": {
    "status": "pong",
    "verified": true,
    "payment_mode": "x402",
    "service": "Agent Kiosk",
    "version": "2.6.0",
    "protocol": "x402 v2 & v1 + MCP (Attested)",
    "network": "eip155:8453",
    "asset": "USDC",
    "echo": "x402-registry-verification",
    "payer": "0xd8429209Aee6A398B9707DFf5F28AAA93452eE95",
    "tx_hash": "0xd4869a2190887c15b9fb53c109045fe60bb6bef6a3cf8b66e6f7e0a9904fda7e"
  }
}

---

4. クイック接続（Claude Desktop／Cursor／Windsurf／VS Code）

{
  "mcpServers": {
    "agent-kiosk": {
      "url": "https://agent-kiosk.vercel.app/mcp"
    }
  }
}