Circle Agent Stackとは？Agent Wallets・Nanopaymentsの仕組みとCLIでの使い方【CLI 1.3.0対応】

Circle Agent Stackは、USDCの発行元グループであるCircleが2026年5月11日に発表した、AIエージェント向けの製品群です。エージェントにUSDCを持たせるウォレット、1セントに満たない額を払える決済、それらを操作するCLI、有料APIを探すカタログでできています。Claude Code・Cursor・Codexなどのエージェントが、APIキーや月額契約なしに外部APIへ1リクエスト単位で支払えるようにするのが狙いです。

この記事は、Circleの開発者ドキュメント、Circle CLI 1.3.0（2026年11月10日UTC公開）の配布コードと実行結果、Agent Marketplaceの公開APIから取った全件の集計をもとに書いています。IBMのBeeAIから派生した同名のオープンソース「Agent Stack」とは別物です。

まとめ：Circle Agent Stackの要点

• 構成：Circle CLI・Agent Wallets・Agent Marketplace・Nanopayments（Circle Gateway基盤）の4製品に、既存のCircle Skillsを加えた5要素です。
• ウォレット：2-of-2 MPCで鍵を分け、エージェントは鍵の断片に触れません。メールのワンタイムパスワード（OTP）でログインし、セッションは28日で切れます。
• 支出の制御：1回・日・週・月の上限と、送金先・コントラクトの許可／拒否リストを設定できます。変更には毎回OTPが要り、メインネット専用です。
• 少額決済：Gatewayに預けたUSDCから、署名だけで最小0.000001ドルを払えます。オンチェーンへの反映はまとめて行われます。
• CLI 1.3.0の変更：circle wallet logout がサーバー側のセッションも失効させるようになり、--scope all で全端末をログアウトできます。端末を紛失したときの手当てができました。
• 実測：2026年11月13日時点のMarketplace掲載は2,650エンドポイント・44事業者で、10月8日の2,852件から202件減りました。価格の中央値は0.1 USDCのままです。
• 注意点：支払いコマンドは --max-amount を付けないと金額の上限判定をしません（1.3.0でも同じ）。エージェントにメール受信箱を読ませる構成も避けます。

Circle Agent Stackの構成と提供時期

2026年5月11日のプレスリリースが「初期製品」に挙げたのはCircle CLI、Agent Wallets、Agent Marketplace、Nanopayments powered by Circle Gatewayの4つです。Circle Skills（AIコーディングツール向けの手順書集）は2026年3月にリポジトリが作られた既存の取り組みで、Circleの発表ブログと製品ページでは5つ目の構成要素として並んでいます。

発表後のリリース履歴

Agent StackのリリースノートとGatewayのリリースノート、npmの公開日時から、発表後の主な追加を並べます。

11月の第3四半期決算説明資料は、2027年1〜3月期までに「AIエージェントが見つけられ、雇われ、支払われ、仕事ぶりで信頼される」状態にするという計画を示し、時期は変わりうると注記しています。

circle.com/agent-stack の製品ページは、11月13日時点でもFAQの対応チェーンに「Arc testnet（mainnet coming soon）」、告知帯に「1000+ curated endpoints」と書いています。Arcメインネットは9月16日にAgent Stackの対応チェーンに加わっており、掲載件数も下で示すとおり2,650件です。製品ページより開発者ドキュメントとリリースノートのほうが新しいので、仕様はそちらで確かめます。

Circle CLIの主な機能（1.3.0の主要コマンド）

Circle CLIはNode.js 20.18.2以上で動き、npm install -g @circle-fin/cli で入ります。circle --help が示すリソースは次のとおりです。

1.2.0と1.3.0のヘルプを並べると、トップレベルの構成は同じで、変わったのは wallet logout の説明だけでした。

Agent Walletsの鍵管理と支出ポリシー

Agent Walletsは、Circleのユーザー管理型ウォレットの上に作られています。2-of-2 MPCで秘密鍵を2つの断片に分け、エージェント側には渡しません。送金はブロックチェーンへ送る前に制裁リストと照合されます。利用規約は、Circleがブロックチェーン上の取引を代わりに取り消したり巻き戻したりできないと明記しています。

OTPログインとCLI 1.3.0のサーバー側ログアウト

ログインはメールアドレスとOTPで行い、成功すると対応する全チェーンにウォレットが作られます。セッションは28日で切れ、認証情報はOSのキーチェーンに保存されます。メインネットとテストネットのセッションは別々です。

npm install -g @circle-fin/[email protected]
circle wallet login [email protected]
circle wallet list --type agent --chain ARC

入力を待てないスクリプト向けには2段階ログインがあります。CIRCLE_ACCEPT_TERMS=1 circle wallet login [email protected] --init でOTPを送ってリクエストIDを受け取り、circle wallet login --request <ID> --otp <コード> で完了させます。リクエストIDは10分で失効します。先頭の環境変数はCLIの利用規約とプライバシーポリシーへの同意を表すので、利用者本人が内容を読んでから付けます。

ログアウトの挙動は1.3.0で変わりました。認証のドキュメントは11月13日時点でも「circle wallet logout は手元のセッションを消すだけで、Circle側のセッションやトークンは失効しない」と書いています。1.2.0の配布コードも、ログアウト時は手元のキーチェーンを消すだけでした。1.3.0のヘルプは「保存済みのメインネット・テストネットのセッションをサインアウトし、手元の認証情報を消す」に変わり、--scope オプションが加わっています。

# この端末のセッションをサーバー側でも失効させる（既定は --scope local）
circle wallet logout

# 同じアカウントの全端末をサインアウトする（確認なしで実行される）
circle wallet logout --scope all

ヘルプによると、サーバー側のログアウトにはネット接続が要り、失敗したときは再試行できるよう手元の認証情報を残します。端末を紛失したときは、別の信頼できる端末でログインし直してから --scope all を実行します。新しくOTPでログインしても古い端末のセッションは消えない、とヘルプは明記しています。1.2.x以前のCLIでログアウトしても、紛失した端末のセッションは期限の28日まで残ります。

もう1つの前提として、公式ドキュメントは、エージェントにメール受信箱を読ませないよう警告しています。OTPを読めればログインでき、支出ポリシーの変更まで含めて全操作ができるためです。OTPは人が入力する運用にします。

支出上限と許可リストの設定

支出ポリシーは circle wallet limit set で設定します。未設定でも既定の月間上限100 USDCが適用され、現在の上限は circle wallet limit で確認できます。次の2つは独立した設定例で、続けて実行する手順ではありません。同じウォレット・チェーンのstablecoinポリシーが未設定の状態で、どちらかを選びます。上限は1回・日・週・月の4種類で、日・週・月は暦ではなく直近の期間で数えます。1回 ≤ 日 ≤ 週 ≤ 月 を満たさないと受け付けられません。

circle wallet limit set \
  --address 0xYourWalletAddress \
  --chain ARC \
  --policy-type stablecoin \
  --per-tx 100 --daily 500 --weekly 2000 --monthly 5000

circle wallet limit set \
  --address 0xYourWalletAddress \
  --chain ARC \
  --policy-type stablecoin \
  --rule-type recipient-allowlist \
  --targets "[0xSELLER1,0xSELLER2]"

--rule-type には recipient-allowlist／recipient-blocklist（USDCの送金先）と contract-allowlist／contract-blocklist（判定対象はトークンのコントラクトアドレスで、spenderのアドレスではありません）を指定できます。設定のたびに2回目のOTPが届き、承認しないと反映されません。

つまずきやすい制約は2つです。ポリシーはメインネットのウォレットにしか設定できず、テストネットで上限の動きを試せません。また、同じウォレット・チェーン・種類のポリシーが既にあると set は失敗するので、値を変えるときは circle wallet limit reset で戻してから設定し直します。

対応チェーンと手数料

Agent Walletsはメインネット・テストネットとも9チェーンに対応します。Arbitrum・Arc・Avalanche・Base・Ethereum・Monad・Optimism・Polygon PoS・Unichainで、CLIでは --chain ARC のように識別子で指定します。

手数料のページによると、ガス代の肩代わりには上限があり、公正利用の範囲で将来変わりえます。同じチェーン内のx402支払いにはGatewayプロトコル料がかかりません。ブリッジは標準転送より高い高速転送だけを使います。仕組みはCCTPによるUSDCのクロスチェーン送金で解説しています。

Nanopaymentsのバッチ決済の仕組み

USDCを1回ずつブロックチェーンに書き込むと、手数料の安いチェーンでもガス代が支払額を上回ります。Agent Nanopaymentsのドキュメントは、個別決済で成り立つ最小額を「約0.01ドル以上（チェーンによる）」、バッチ決済では0.000001ドルとしています。流れは5段階です。

1. 買い手がUSDCをGatewayのウォレットコントラクトへ預ける（オンチェーン取引はこの1回）
2. 買い手が有料APIを呼ぶと、売り手が 402 Payment Required と支払い条件を返す
3. 買い手はEIP-3009の TransferWithAuthorization にオフチェーンで署名し、署名付きで再リクエストする
4. 売り手が署名をGatewayへ渡すと、Gatewayは買い手の残高を押さえ、売り手はすぐ応答を返す
5. Gatewayが溜まった署名から各参加者の差し引き額を計算し、1件の取引でまとめて反映する

差し引き計算はAWS Nitro Enclave（隔離されたハードウェア実行環境）の中で行われ、結果に付く署名をコントラクトが検証します。3段目の署名形式はEIP-3009（transferWithAuthorization）と同じです。

10月23日からは、USDCに加えてEURCとcirBTCもNanopaymentsで払えます。Gatewayの資産別ドキュメントによると、対象はEVMチェーンだけで、EURCはArc・Avalanche・Base・Ethereum・World Chain、cirBTCはArcとEthereumです。残高は資産ごとに別々に管理され、USDC以外はEIP-3009のバージョン2の署名が必要です。

Facilitator Serviceとの使い分け

Circleはx402の売り手向けに、もう1つの決済経路としてFacilitator Serviceを9月16日に公開しました。10月13日には、使った分だけ請求する upto 方式に対応しています。仕組みのドキュメントによると、uptoでは買い手が上限額に署名し、売り手は応答を返した後に0から上限までの実額を確定させます。

x402ファシリテーターの比較表では、Gateway Nanopaymentsの決済方式は exact だけです。uptoの決済はPermit2の PermitWitnessTransferFrom で行うため、買い手はUSDCにPermit2の承認を与えておくか、EIP-2612のpermitに署名する必要があり、売り手側の確定にはCircleのAPIキーが必須です。1回0.01ドルを下回る課金や高頻度の呼び出しならNanopayments、生成トークン数のように応答後に金額が決まる課金ならFacilitator Serviceのuptoが向きます。

入金するチェーンで変わる待ち時間

Gatewayへの入金は、入金元チェーンで取引が確定するまで残高に反映されません。Gatewayの対応表によると、Arcは約1ブロック（約0.5秒）、Avalancheは約8秒ですが、Ethereum・Base・Arbitrumなどは約13〜19分かかります。入金してすぐ支払わせるなら、Arcのように確定の速いチェーンに残高を置きます。Arcの仕組みはArcのL1としての仕組みとメインネットの実測値にまとめています。GatewayはSolanaにも対応していますが、Nanopaymentsは使えません。

Circle CLIで有料APIに支払う手順

ログインとウォレット作成を済ませてから、次の順に実行します。手順1は送金用QRコードの表示までなので、既存ウォレットからUSDCを送り、着金を確認してから手順2へ進みます。アドレスとAPIのURLは例示用なので、実際の値に置き換えます。

# 1. ウォレットへUSDCを入れる（QRコードとEIP-681のURIが出る）
circle wallet fund --address 0xYourWalletAddress --chain ARC --amount 10 --method crypto

# 2. 支払い用にGatewayへ5 USDCを預ける
circle gateway deposit --amount 5 --address 0xYourWalletAddress --chain ARC --method direct

# 3. Marketplaceを検索し、支払い条件を確かめる
circle services search "weather"
circle services inspect https://api.example.com/weather

# 4. 金額だけ確認してから、上限を付けて支払う
circle services pay https://api.example.com/weather --address 0xYourWalletAddress --chain ARC --estimate
circle services pay https://api.example.com/weather --address 0xYourWalletAddress --chain ARC --max-amount 0.01

# 5. 残高のうち1 USDCをウォレットへ戻す
circle gateway withdraw --amount 1 --address 0xYourWalletAddress --chain ARC

テストネットで試すときは、ログインに --testnet を付け、circle wallet fund --address 0xYourWalletAddress --chain ARC-TESTNET で金額と方法を省くとCircleのフォーセットから20 USDCが入ります。メインネットでのカード購入はTransakが担います。手作業を省くなら、エージェントに curl -sL https://agents.circle.com/skills/setup.md の手順を読ませると、CLIの導入から入金までを進めます。

services inspectの実行結果

検索と条件確認はログインなしで動きます。CLI 1.3.0を別のホームディレクトリに入れ、circle services inspect https://api.aisa.one/apis/v2/openmeteo/forecast -o json を実行した結果の一部です（2026年11月13日）。

"status": "payable",
"httpStatus": 402,
"paymentOptions": [
  { "scheme": "exact", "assetTransferMethod": "gateway",
    "network": "eip155:8453", "amount": "100000",
    "clientSupport": "supported", "prerequisites": "not_checked" },
  ...
  { "network": "eip155:146", "clientSupport": "unsupported", ... }
]

amountはUSDCの最小単位（小数6桁）なので、100000は0.1 USDCです。1.2.0では支払い候補がチェーンの一覧で返るだけでしたが、1.3.0では候補ごとに clientSupport が付きます。このAPIは12チェーンで払えると掲げていますが、Sonic・World Chain・Sei・HyperEVMの4つは unsupported で、Agent Walletsから払えるのは残る8チェーンでした。売り手の掲載チェーン数と、自分のウォレットで払えるチェーン数は別物です。

–max-amountの省略と–payment-idによる再試行

circle services pay は、--max-amount を指定しないと金額の上限判定をしません。1.3.0の配布コードでも、未指定時の上限値は null で、判定は「null でないときだけ」実行されます。売り手が402で返した金額をそのまま払う動きです。ウォレットの支出上限も万能ではありません。1回の上限を100 USDCにしていれば、0.01ドルのつもりのAPIに数十ドル払うことは防げず、トークンの approve() と承認先によるその後の transferFrom は上限に算入されません。承認額は必要最小限にします。エージェントに支払いを任せるなら、指示文やラッパーで --max-amount を必ず付けさせ、初回は --estimate で金額だけを確かめます。

1.2.0以降の更新では --payment-id も加わりました。16〜128文字の固定IDを付けて送り、タイムアウトなどで結果が分からなかったときに同じIDで再送する手動リトライ用のオプションです。配布コードを見ると、x402のバージョン2で、売り手が payment-identifier 拡張を提示している場合にしか使えません。11月13日に取得したMarketplaceの全件の掲載情報には、この拡張は1件も含まれていませんでした。掲載情報だけでは利用可否を判断できないため、実際の402応答がpayment-identifier拡張を提示することを確認したうえで利用します。

Agent Marketplaceの掲載状況（2026年11月の実測）

掲載は、Discovery APIというキー不要の公開API GET https://api.circle.com/v2/x402/discovery/resources で全件を取得できます。2026年10月8日と11月13日に、1回100件ずつ全件を取得して同じ方法で集計しました。価格は支払い候補の最安値で、価格情報のない掲載は除いています。テストネットの候補も含む掲載情報の集計で、実際の支払額の分布ではありません。

同じ決算説明資料は、10月25日時点の掲載を約2,800エンドポイントとしており、2回の実測の間に収まります。件数が減ったのは、死活監視で応答しなくなった掲載が外れる仕組みと矛盾しません。ただし個々の掲載が外れた理由はAPIからは分かりません。カテゴリは、ドキュメントの一覧（6種）に無い通信・推論・地図と天気・旅行と買い物が加わり、予測市場は0件になりました。決済方式は exact が大半で、upto に対応する掲載が5件、batch-settlement が10件ありました。

0.000001ドルまで払える仕組みに対して値付けは0.1 USDC前後が中心で、半分以上が1事業者に集中する構図も変わっていません。公式の「600+ services」「1000+ curated endpoints」は下限を示す表現で実測と矛盾しませんが、件数の多さを選択肢の多さと読み替えないほうが安全です。

売り手として掲載する条件

掲載はフォームでの申請を人が審査する方式です。未払いのリクエストに402を返すこと、OpenAPI仕様を公開していること、受取用ウォレットのアドレスを申告することが前提で、受取アドレスは審査時と掲載後も継続して制裁リストと照合されます。掲載後は死活監視が続き、応答しなくなったエンドポイントは自動で外れます。

x402・MPP・AgentCore paymentsとの関係

Agent Stackは独自の決済規格ではありません。支払いのやり取りはx402（HTTP 402で支払い条件を返す規格）に従い、Circleはウォレット・決済処理・カタログを提供する立場です。

別規格のMPPはMPP（Machine Payments Protocol）の仕組みとx402との違い、AWSのマネージド版はAgentCore paymentsの仕組みと料金、購入指示の証明はAP2（Agent Payments Protocol）のマンデートで扱っています。AWSのIAMで支払い権限を管理したいならAgentCore payments、実行基盤を問わずCLI1つで済ませたいならAgent Stackが合います。自社のエージェントに決済を組み込む設計から相談したい場合は、AIエージェント開発の支援でも承っています。

採用を見送るべきケースと運用上の注意

次の条件に当てはまるなら、導入は見送るか範囲を絞ります。

• メール受信箱をエージェントと共有している：前述のとおりOTPを読めればポリシーまで書き換えられます。人だけが読む専用アドレスを用意します。
• CLIを1.2.x以前のまま複数の端末で使っている：ログアウトしてもサーバー側のセッションは残ります。1.3.0へ上げ、使わない端末は circle wallet logout で失効させます。
• テストネットで上限の挙動を確かめてから本番に出したい：ポリシーはメインネット専用です。本番で少額から始めるしかありません。
• 誤送金を取り消せる前提の業務：規約上、Circleは取引を巻き戻せず、自動実行の取引は確認画面なしに即時実行されえます。
• 日本の法人として会計・法務の整理が済んでいない：国内でUSDCは電子決済手段に当たり、扱える電子決済手段等取引業者は令和8年8月27日時点で2社です。区分は電子決済手段の4区分と決済システムに載せる要件で整理しています。

Agent Platformの利用規約（2026年5月11日付、Circle Technology Services, LLC）が利用を禁じる地域は制裁対象の国・地域で、利用者は18歳以上である必要があります。日本は禁止地域に含まれませんが、規約上使えることと国内で扱いを整理できていることは別の問題です。制度の全体像はステーブルコインの仕組みと日米欧の規制にあります。

Circle Agent Stackのよくある質問

Circle Agent Stackの利用は無料ですか？

ウォレットの作成とCLIの利用に料金はかかりません。ガス代はCircleが負担し、ブリッジ（転送サービス料0.05ドルほか）、スワップ（2bps）、チェーンをまたぐx402支払い（0.5bps）に手数料がかかります。

テストネットで試せますか？

試せます。circle wallet login --testnet でログインし、circle wallet fund --address 0xYourWalletAddress --chain ARC-TESTNET で、自分のテストネットウォレットのアドレスを指定すると、フォーセットから20 USDCを受け取れます。ただし支出ポリシーはテストネットでは設定できません。

Solanaで使えますか？

Agent Walletsの対応9チェーンにSolanaは含まれません。GatewayはSolanaのUSDCとEURCに対応していますが、Nanopaymentsは使えません。Marketplaceの掲載にはSolanaで払えるものもありますが、Solana対応の別のウォレットで通常のx402の経路を使う形になります。

Claude CodeやCursorから使えますか？

使えます。公式ドキュメントはClaude Code・Cursor・Codex・OpenClawを例に挙げています。curl -sL https://agents.circle.com/skills/setup.md の手順を読ませるか、circle skill install でCircle Skillsを入れると、エージェントがCLIの使い方を把握します。

x402とCircle Agent Stackは何が違いますか？

x402はHTTP 402で支払い条件を伝え、署名付きで再リクエストする手順を決めた規格です。Agent Stackはその手順で支払うためのウォレット、少額をまとめて処理するGateway、x402対応APIのカタログを提供する製品群で、x402の上で動きます。

関連記事

• Arc（Circle）とは？USDCをガス代にするL1の仕組みとメインネットの実測値【2026年10月】
• MPP（Machine Payments Protocol）とは？HTTP 402の仕組みとx402との違い・Stripeでの実装【2026年10月】
• AgentCore paymentsとは？x402・MPP対応の仕組みと料金・実装手順【2026年8月GA】
• EIP-3009（ERC-3009）とは？transferWithAuthorizationの仕組みと署名実装・対応トークン
• AP2（Agent Payments Protocol）とは？v0.2のマンデートとx402・ACPとの違い