amanchain-mcp

AmanChain MCP Gateway

59 種類の従量課金型 AI サービスを MCP ツールとして利用できます — Base 上での USDC による x402 決済を自動化します。

暗号資産の価格と監査、クジラのアラート、市場レポート、LLM チャット、画像生成、 請求書と領収書、ウェブの取得・検索・要約、位置情報、翻訳などに対応しています — API キー、サインアップ、サブスクリプションは不要です。エージェントは USDC で呼び出しごとに 支払います（ガス代不要 — ファシリテーターがガス代を負担します）。すべての決済はオンチェーンで行われ、領収書が発行されます。

Claude Code、Claude Desktop、Cursor および MCP 互換クライアントで利用できます。

クイックスタート（60 秒）

1. 約 1 ドル分の USDC を入れた Base ウォレットを用意します（Coinbase → USDC を出金 → Base ネットワーク、または bridge.base.org）。
2. サーバーを追加します。

Claude Code

claude mcp add amanchain -e AMAN_PRIVATE_KEY=0xYOUR_KEY -- npx -y amanchain-mcp

Claude Desktop / Cursor（claude_desktop_config.json / mcp.json）

{
  "mcpServers": {
    "amanchain": {
      "command": "npx",
      "args": ["-y", "amanchain-mcp"],
      "env": { "AMAN_PRIVATE_KEY": "0xYOUR_KEY" }
    }
  }
}

3. エージェントに 「amanchain を使って現在の BTC 価格を取得して」 と尋ねれば完了です。

ウォレットをまだお持ちでない場合：AMAN_PRIVATE_KEY を設定せずに実行できます — カタログ、価格、サービスの検出はすべて利用可能です。有料の呼び出しでは、設定方法が明確に案内されます。

エージェントが利用できる機能

まず amanchain_catalog を使用し、その後、サービスごとに用意されたツールを使います。主な例：

ツール	機能	価格
aman_crypto_price	暗号資産のリアルタイム価格	約 $0.001
aman_token_audit	オンチェーンのトークン監査（裏付け、フラグ、保有者、流動性）	約 $0.025
aman_market_report	市場の総合レポート	約 $0.03
aman_llm_chat	LLM によるテキスト生成	約 $0.008
aman_image_gen	画像生成	約 $0.013
aman_web_search / aman_web_fetch / aman_summarize	ウェブ処理パイプライン	約 $0.003～0.008
aman_crypto_whale_watch	クジラの取引監視	約 $0.10
aman_geo_ip、aman_weather、aman_fx_rates、aman_translate …	ユーティリティ	約 $0.001～0.005

価格はネットワークによって設定され、すべての 402 レスポンスでリアルタイムに提示されます。また、 ライブカタログで公開されています。 すべての支払いでオンチェーンの領収書が発行されます — 公開されている 領収書台帳をご覧ください。

安全性

• 秘密鍵がマシンの外に出ることはありません — ローカルで EIP-3009 USDC 送金に署名するためだけに使われます。
• AMAN_MAX_USD_PER_CALL（デフォルト $0.05） — この上限を超える価格の見積もりを拒否します。
• AMAN_MAX_USD_PER_DAY（デフォルト $1.00） — 1 日ごとのローリング上限です。~/.amanchain-mcp-spend.json に保存されます。
• 価格はサーバーの署名付き 402 チャレンジからのみ取得します — 推測することはありません。

すべての環境変数：AMAN_PRIVATE_KEY、AMAN_ORIGIN、AMAN_MAX_USD_PER_CALL、AMAN_MAX_USD_PER_DAY、AMAN_SPEND_LEDGER。

仕組み

agent ── tools/call ──▶ amanchain-mcp ──▶ POST /api/x402/<service>
                              ◀────────── 402 + signed price challenge
        local EIP-3009 signature (USDC on Base, gasless)
                              ──▶ retry + PAYMENT-SIGNATURE
                              ◀────────── 200 + result + on-chain receipt

AmanChain は耐量子性のプルーフ・オブ・ワーク・チェーンです。AI マーケットプレイスではエージェントによる支払いがオンチェーンで決済され、サービスの結果と領収書がブロックに採掘されます。

リンク

• ライブカタログ：/.well-known/x402.json
• 公開領収書：/receipts
• エコシステム：x402scan · 402index

MIT © AmanChain