CRA AGENT

@cra-agent/mcp

AI エージェントが API 呼び出しの料金を支払えるようにする MCP サーバーです。エージェントがツールを 1 つ呼び出すと、決済レールが x402 の価格を読み取り、支出ポリシーを確認し、Circle Gateway 経由で Arc 上の USDC をガス代なしで支払います。購入者にはガス代がかからず、領収書も保存されます。

モデルがキーを見ることはなく、モデル自身が上限を引き上げることもできません。キーと上限は、会話を始める前に環境から読み込まれます。

インストール

npm i -g @cra-agent/mcp

1 つのコマンドでセットアップ

cra-agent init --client claude-desktop

エージェントのキーを ~/.cra-agent/agent.key に作成します（読み取れるのはユーザー本人のみで、上書きされることはありません）。上限を確認し、元の設定ファイルのコピーを保存したうえで、クライアントの設定ファイルにエントリを書き込み、入金先のアドレスを表示します。--client には claude-desktop、cursor、claude-code、terminal を指定します。--policy、--network、--key-file、--dry-run は、それぞれの名前のとおりに動作します。CRA Factory では、4 つの質問に答えるだけでコマンドを作成できます。

または、任意の MCP クライアントから手動で設定

{ "mcpServers": { "cra-agent": {
    "command": "cra-agent-mcp",
    "env": {
      "CRA_NETWORK": "arc",
      "CRA_KEY_FILE": "/path/to/agent.key",
      "CRA_POLICY": "daily=5,per_seller=0.5,per_payment=0.05"
    }
} } }

CRA_KEY_FILE には秘密鍵を格納したファイルを指定し、chmod 600 を設定してください。キーをプロンプトに絶対に含めないでください。

ツール

ツール	機能
arc_search	少数のキーワード（「bitcoin price」、「web search」など）から、Arc 上で購入できるものを探します。対象は CRA AGENT 独自のデータ、CRA マーケット、Circle の x402 カタログに Arc 上で支払い可能なものとして掲載されているエンドポイント（Exa、Goldsky、BlockRun など）です。各検索結果には、メソッドとパラメーターの例を含む URL、各パラメーターの指定先（クエリ、パス、または JSON 本文）、価格、販売者、掲載者、現在のポリシーで支払いが許可されるかどうかが含まれます。無料です。
arc_quote	URL の価格を読み取り、ポリシーで支払いが許可されるかどうかを示します。支払いは行いません。POST の場合は、支払い時に送信する本文を渡してください。販売者によっては、価格を提示する前に本文を確認します。
arc_pay	URL の料金を支払い、領収書とともに応答を返します。lightning: true を指定すると、販売者が 402 で提示している場合、CRA_NWC_PAY_FILE のウォレットから Lightning 経由でビットコインを支払います（lnbtc 上の x402 exact）。ドル建ての同じ上限が適用されます。上限の確認は、支払い時に 402 が要求する金額に対して、署名の前に行われます。maxUsdc を指定すると、その呼び出しに限り上限を追加できます。arc_search に表示された価格を渡してください。それ以降に販売者が価格を引き上げていた場合、指定した上限内であっても支払いは拒否されます。
arc_balance	ウォレットと Circle Gateway の残高を表示します。
arc_deposit	ウォレットの USDC を Gateway 残高に移動します。初回の支払い前に一度実行する必要があります。
arc_ledger	すべての試行を表示します：見積もり、拒否、署名、決済、失敗。
arc_proof	決済済みの支払いと、それを実行したオンチェーン送金を照合します。
arc_verify_receipt	別のエージェントから受け取った署名済み領収書を確認します。署名者と、記載された上限内で支払いが行われたかどうかを検証します。
arc_policy	適用中の上限を表示します。
arc_job_*	ERC-8183 エスクロージョブです。コントラクトが Arc メインネットにデプロイされるまでは、テストネットのみで利用できます。

自分の思考に料金を支払うエージェント

cra-agent think "<task>" を実行すると、小規模な自律エージェントが動作します。その頭脳は Arc 上の従量課金型 LLM で、バザールで見つかる BlockRun のチャット補完機能を使います。デフォルトは Claude Haiku 4.5 です。思考するたびに料金が発生し、頭脳が要求するツールにもその都度料金がかかります。まずバザールを無料で検索し、必要なものを表示価格で購入します。API キーはどこにもなく、あるのはエージェントのウォレットだけです。セッション予算（--budget、デフォルトは $0.10）と支出ポリシーは、思考とツールの両方に適用されます。1 回の思考には上限（--ceiling、デフォルトは $0.01）があり、頭脳が購入できるのは、検索結果として返された URL に限られます。各ステップとその費用が表示され、最後に思考にかかった費用とツールにかかった費用が明細として表示されます。短いタスクなら数セントで済みます。cra-agent.tech/think で Arc メインネットの稼働開始時期とバリデーターを調べた実行では、Exa の思考 4 回とウェブ検索 1 回で、費用は $0.023648 でした。

無料で呼び出せる公開 API もいくつか把握しており、料金がかからないものとして表示します。DexScreener のペア、ブースト中のトークン、新しいトークンのプロフィールを、質問に答えるのに必要な情報（24 時間の取引高別のペアなど）に整理します。--tools <file> を指定すると、URL プレフィックスのリストに制限できます。それ以外のものはエージェントに表示されないため、購入されることもありません。

--record と DATABASE_URL を指定すると、実行内容がステップごとに Postgres にリアルタイムで保存されます。ページでライブ表示し、後から再生できるのはこのためです。質問が指定されていない場合は、--questions <file> で質問を選びます。これは、サーバーがタイマーで実行する際に使われます。このファイルにはテンプレート（What is the price of {coin} right now?）とリスト（@coin = bitcoin (BTC) | ether (ETH)）を組み合わせて記述します。記録された実行では、直近 100 件の質問が繰り返されることはありません。

このエージェントは x402 upto を介して、誰でも利用できるように依頼できます。GET https://api.cra-agent.tech/v1/upto/think?task=… を呼び出すと、最大 $0.10 までの署名を求められ、実行で使った金額に $0.005 を加えた額が請求されます。arc_pay と cra-agent pay は、このようなルートで支払いを行います。支払い額全体が引き落とされる可能性があるため、ポリシーは上限額に対して検証され、台帳には実際の金額が記録されます。デフォルトのポリシーでは 1 回の支払いにつき $0.05 まで許可されるため、この支払いには per_payment=0.10 を指定してください。

Base または Solana からエージェントに資金を追加する

Arc で支払うには、Circle Gateway の Arc 上に USDC が必要です。一方、ほとんどのエージェントは Base または Solana 上に USDC を保有しています。1 つのコマンドで資金を移動し、入金できます。

cra-agent fund 5 --from base                                    # from this agent's own wallet on Base, same key and address
cra-agent fund 5 --from solana --solana-key-file ~/sol.json     # from a Solana wallet: our hex seed or solana-keygen's JSON
cra-agent fund 5 --from base --dry-run                          # everything checked, nothing signed

Eco にルートを問い合わせ、署名する前にトランザクション自身の calldata から見積もりを検証します。検証内容は、正確にその額を Arc のドメインに送る CCTP のバーン、このエージェントへのミント、上限未満の手数料（--max-fee、デフォルトは 0.5% または $0.01）、同じウォレットへの返金です。Base から送る場合、USDC の送金先となる Vault は、Eco の Portal がそのインテントに対して導出したものと一致する必要があります。その後、Arc 上に USDC が届くのを待ちます。通常は数秒です。届いたら Gateway に入金し、Arc のガス代としてウォレットに $0.01 を残します（--keep を指定するか、すべてウォレットに残す場合は --no-deposit を指定します）。Base からの場合、ウォレットには 2 件のトランザクション用に少量の ETH（約 1 セント）が必要です。Solana からの場合は、少量の SOL が必要です。モデルにはこれを行うツールがありません。チェーン間の資金移動は、所有者がターミナルから行います。

ターミナルから同じことを行う

cra-agent find bitcoin price    # what is for sale on Arc; needs no key (in a browser: cra-agent.tech/bazaar)
cra-agent balance
cra-agent quote https://api.cra-agent.tech/v1/paid/rpc/health
cra-agent quote https://api.exa.ai/search --body '{"query":"x402 on Arc"}'           # the price of a POST, with its body
cra-agent fund 5 --from base   # USDC from Base to this agent on Arc, into Gateway
cra-agent deposit 1
cra-agent withdraw 1            # Gateway balance back to the wallet; how a seller collects
cra-agent pay   https://api.cra-agent.tech/v1/paid/rpc/health
cra-agent pay   https://api.exa.ai/search 0.007 --body '{"query":"x402 on Arc"}'   # a POST, refused above the listed price
cra-agent think "What is x402, in two sentences?" --budget 0.10              # an agent that pays for its own thinking
cra-agent proof
cra-agent verify receipt.json      # needs no key and no network
cra-agent pq-key ~/.cra-agent/pq.key           # a post-quantum key for receipts; prints only its public half
cra-agent verify receipt.json --require-pq --on-arc   # the second signature too, and Arc's own verdict on it

すべてのレシートには、支払いがどの上限のもとで行われたかが記載され、エージェントのキーで署名されています。そのため、その場にいなかった人でも検証できます。署名は、エージェントがその内容を発行し、誰も改ざんしていないことを証明します。オンチェーンでの決済が、その独立した裏付けとなります。

環境

変数	意味
CRA_NETWORK	arc（メインネット）または arcTestnet。デフォルトは arcTestnet です。
CRA_KEY_FILE / CRA_PRIVATE_KEY	エージェントのキーです。ファイルの使用を推奨します。
CRA_POLICY	daily=5,per_seller=0.5,per_payment=0.05,rate=120/60s,allow=a.com|b.com,deny=c.com
CRA_RPC_URL	任意。優先順位順に、カンマ区切りで1つ以上指定できます。Arc のパブリックエンドポイントより先に試されます。
CRA_RPC_STRICT	1 にすると、パブリックエンドポイントにはフォールバックしません。
CRA_BASE_RPC_URL / SOLANA_RPC_URL	任意。fund 用の Base と Solana のエンドポイントです。デフォルトではパブリックエンドポイントが使われます。
DATABASE_URL	任意。台帳用の Postgres です。指定しない場合、台帳はメモリ上に保存されます。
CRA_PQ_KEY_FILE	任意。cra-agent pq-key で作成したファイルです。指定すると、各レシートは Arc がオンチェーンで検証する耐量子方式 SLH-DSA-SHA2-128s でも署名されます。署名の対象はレシートであり、支払いではありません。また、レシートごとに約1秒追加されます。

知っておくとよい点が2つあります。支払いが確定するのは販売者のハンドラーが成功した後だけなので、エンドポイントが失敗しても費用はかかりません。確認には、常に 500 を返す https://api.cra-agent.tech/v1/paid/selftest/fail を利用できます。また、identity=required を指定すると、Arc 上で ERC-8004 ID を持つ販売者にのみ支払われます。支払いを受け取るアドレスは、レジストリに登録されたエージェントを所有するか、エージェントが支払い用に申告したウォレットである必要があります。これは ID の存在を証明するものであり、販売者が誠実であることを証明するものではありません。登録にかかるのはガス代のみです。

CRA AGENT の一部

Arc（Circle の USDC ネイティブ L1）上の AI エージェント向け支払いです。サイト：cra-agent.tech · ソース：github.com/giupy997/arcagentx402 · MIT