agenticpay

agenticpay

ウェブサイト · 支出上限 · npm

AI エージェントから支払いを受け取りましょう。 MCP エコシステム向けのオープンソース決済インフラストラクチャです。任意のツールに価格を設定でき、エージェントは x402経由でUSDCを支払い、Solanaで約1.5秒で決済されます。

StripeもアカウントもAPIキーも不要です。

SDK、CLI、ペイウォールミドルウェア、セルフホスト可能なx402 ファシリテーター、稼働中のLLMエージェントデモまで、スタック全体が揃っています。すべてTypeScript製で、MITライセンスです。

まずは試してみたいですか？ mcp-server をホスト済みのdevnet ファシリテーターに接続してください：FACILITATOR_URL=https://agentpay-facilitator-e9b20a5fee6a.herokuapp.com セットアップは不要です。

ライブデモ

実際のClaude Opusエージェントがタスクを受け取り、利用する有料ツールを判断し、 Solana上でx402のマイクロペイメントを使って自律的に支払い、ユーザーに回答します。

$ pnpm --filter @agenticpay/two-agent-demo agent

Agent wallet: 3rHoEumCpH8EGrr6Lq2vBKeyec6h3yPRGj2nGG2FzEfX
Server:       http://localhost:4021
Facilitator:  http://localhost:4022   ← our own
Model:        claude-opus-4-7
Task:         Reverse the string 'agentpay rocks' and tell me how many words
              are in 'The quick brown fox jumps over the lazy dog'.

[turn 1] tool_use: reverse_string({"text":"agenticpay rocks"})  →  paying $0.001 USDC ...
  ✓ paid + got result in 1596ms: {"result":"skcor yaptnega"}
[turn 1] tool_use: word_count({"text":"The quick..."})  →  paying $0.0005 USDC ...
  ✓ paid + got result in 1286ms: {"count":9}

Agent final answer:
  1. Reversed string: skcor yaptnega
  2. Word count: 9 words

=== payments summary ===
  reverse_string   $0.0010 USDC   1596ms
  word_count       $0.0005 USDC   1286ms
  TOTAL            $0.0015 USDC   2 calls

オンチェーン証明（Solana devnet）：

• セルフホスト型ファシリテーターによる決済：EsqzTG8id...Bnku
• x402.org経由で先に行われた決済：2d2HcefgJ...vkqY

理由

現在のAIエージェントスタックは、人間がクレジットカードを持つことを前提としています。エージェントが自らの判断でAPIを呼び出したり、 サブエージェントを雇ったり、コンピューティングに支払ったりした途端に、その前提は崩れます。OAuthでは解決できません。

HTTP経由のステーブルコインによるマイクロペイメントが、この問題を解決します。agenticpayは、特にMCPエコシステム向けに不足していた使いやすさを補います。任意のツールに価格を設定でき、 任意のエージェントがその料金を支払えます。また、実際にオンチェーン決済を送信するファシリテーターを含め、パイプライン全体がオープンソースでセルフホスト可能です。

アーキテクチャ

┌──────────────┐     1) HTTP request                    ┌─────────────┐
│   Claude /   │ ────────────────────────────────────▶ │  mcp-server │
│   GPT agent  │     2) HTTP 402 + payment requirements │  (yours)    │
│              │ ◀──────────────────────────────────── │             │
│              │     3) signed USDC payload             │             │
│              │ ────────────────────────────────────▶ │             │
└──────────────┘                                        └─────┬───────┘
                                                              │ verify+settle
                                                              ▼
                                                   ┌──────────────────────┐
                                                   │ agenticpay facilitator │
                                                   │   (also yours, this  │
                                                   │    repo, port 4022)  │
                                                   └──────────┬───────────┘
                                                              │ submit
                                                              ▼
                                                          Solana
                                                       (USDC SPL,
                                                       sub-cent fees)

mcp-server を、テストネット／devnet向けの公開 x402.org/facilitator、またはメインネット向けのCoinbase CDPに接続することもできます。セルフホストの方法を簡単にしました。

パッケージ

パッケージ	機能
packages/sdk	TypeScript プリミティブ：USDC の送金、ウォレット管理、ネットワーク設定
packages/cli	agenticpay コマンド：ウォレット、残高、送金
packages/mcp-server	x402 のペイウォールミドルウェアを備えた HTTP サーバー。各ツールに価格が設定されています。
packages/facilitator	セルフホスト可能な x402 ファシリテーター - Solana 上で USDC の支払いを検証して決済します。エージェントに代わって SOL の手数料を支払います。
packages/eliza-plugin	Eliza プラグイン - 有料の HTTP エンドポイントをネイティブの Eliza アクションとしてラップします。Solana ネイティブの AI エージェントがツール呼び出しごとに支払います。
packages/ai-sdk	Vercel AI SDK ヘルパー - 有料ツールをそのまま generateText / streamText に組み込めます。
packages/mcp-bridge	x402 の有料ツールをラップする実際の MCP サーバー（stdio + @modelcontextprotocol/sdk）。Claude Desktop / Cursor に追加できます。
examples/two-agent-demo	ツール呼び出しに実際に支払う Claude Opus エージェント

インストール

npm install @agenticpay/sdk           # Solana + USDC primitives
npm install -g @agenticpay/cli        # `agenticpay` command
npm install @agenticpay/mcp-server    # paywalled HTTP server
npm install @agenticpay/facilitator   # self-hosted x402 facilitator
npm install @agenticpay/eliza-plugin  # Eliza plugin (Solana-native agents)
npm install @agenticpay/ai-sdk        # Vercel AI SDK paid tools
npm install -g @agenticpay/mcp-bridge # MCP server for Claude Desktop / Cursor

または、ライブの 2 エージェントデモと編集しやすいテンプレートを利用するために、モノレポをクローンしてください（初回実行時に推奨。下記のクイックスタートを参照）。

Claude Code での使用

このリポジトリには、.claude/skills/agenticpay/SKILL.md に Anthropic Skill が含まれています。これを ~/.claude/skills/ にコピーすると、Claude Code が agenticpay に関する詳細なコンテキストを利用できるようになります。以降は、毎回 README を読み直さなくても、MCP サーバーの収益化、ツールルートの生成、オンチェーン決済の検証を案内してくれます。

mkdir -p ~/.claude/skills
cp -r .claude/skills/agenticpay ~/.claude/skills/

クイックスタート（devnet、約 5 分、無料）

# 1. Install
pnpm install
pnpm -r build

# 2. Generate a payer wallet, fund it on devnet
node packages/cli/dist/index.js wallet new
node packages/cli/dist/index.js wallet show
# → fund SOL at https://faucet.solana.com  (paste pubkey)
# → fund USDC at https://faucet.circle.com (Solana Devnet, same pubkey)

# 3. (option A - fastest) Use our hosted devnet facilitator. Skip step 4.
export FACILITATOR_URL=https://agentpay-facilitator-e9b20a5fee6a.herokuapp.com

# 3. (option B - fully self-hosted) Start your own facilitator (terminal 1)
pnpm --filter @agenticpay/facilitator dev
# Note the printed feePayer address. It needs ~0.05 SOL devnet to cover fees.
# Either airdrop or use the helper:
pnpm --filter @agenticpay/facilitator fund
export FACILITATOR_URL=http://localhost:4022

# 4. Start the paywalled mcp-server (terminal 2)
PAY_TO=<recipient pubkey> pnpm --filter @agenticpay/mcp-server dev

# 5. Run the live LLM agent demo (terminal 3, needs ANTHROPIC_API_KEY in .env)
pnpm --filter @agenticpay/two-agent-demo agent

フレームワークとの統合

よく使われる AI エージェントスタック向けの、そのまま使えるテンプレートは examples/ にあります。

フレームワーク	ファイル
Anthropic SDK（標準）	examples/two-agent-demo/src/agent-llm.ts
実用的な有料サーバーテンプレート（Claude を利用するツール）	examples/research-server/
LangChain.js	examples/langchain-js/agent-with-paid-tools.ts
LangChain Python	examples/langchain-python/agent_with_paid_tools.py
Eliza（Solana ネイティブ）	examples/eliza/plugin-agenticpay.ts
Mastra	examples/mastra/paid-tool.ts
Vercel AI SDK	examples/vercel-ai-sdk/paid-tool.ts
OpenAI Custom GPT	examples/openai-gpt/action-schema.json

統合の一覧については、examples/README.md を参照してください。

ステータス

プレアルファ版です。devnet でエンドツーエンドの動作を検証済みです。mainnet の設定にも対応していますが、ファシリテーターに実際の SOL を入金し、mainnet に対応した RPC（Helius、QuickNode など）を指定する必要があります。

ロードマップ

• devnet でのエンドツーエンドデモ（スモークテスト + LLM エージェント）
• セルフホスト可能な x402 ファシリテーター（検証 + 決済、fee_payer 抽象化）
• 実用的な MCP サーバーテンプレート（おもちゃの reverse_string ではなく、検索、取得、要約、抽出）
• 長時間実行タスク向けのオンチェーンエスクロー（Anchor プログラム）
• オンチェーンのエージェント評判レジストリ
• ホスト型ファシリテーターサービス（agenticpay.com）

ファシリテーターとは？

x402 を初めて使う方向けに説明すると、ファシリテーターは信頼できる仲介役であり、（1）エージェントの署名済み支払いペイロードを検証し、（2）オンチェーンで USDC の送金を送信し、（3）SOL がなくてもエージェントが USDC だけで利用できるよう、SOL のガス代を支払います。多くの MCP 開発者は自分で運用したくないため、ホスト型のものを指定します。

このリポジトリには、ファシリテーターの完全な実装が含まれています。セルフホスト、フォーク、監査、または独自ユーザー向けサービスとしてのデプロイが可能です。

有料ツールの呼び出しに失敗するとどうなりますか？

簡単に言うと、失敗したツール呼び出しに料金が請求されることはありません。 x402 の決済は取り消せないプッシュ型の処理であるため、ミドルウェアは決済のタイミングを慎重に管理します。

1. 実行前に検証します。 ツールハンドラーが実行される前に、決済ペイロード（署名、資金、要件との一致）が検証されます。決済が無効な場合は HTTP 402 が返され、ツールは実行されません。
2. レスポンスをバッファーに保持して実行します。 ハンドラーは実行されますが、そのレスポンスは保留され、エージェントにはまだ送信されません。
3. 成功した場合のみ決済します。 ハンドラーが 400 以上のステータスを返した場合、ミドルウェアは決済を完全にスキップし、エラーを返します。呼び出しに失敗しても、エージェントに料金が請求されることはありません。
4. 決済なしでは結果を返しません。 オンチェーン決済自体に失敗した場合、バッファーに保持されたツールの結果は破棄され、代わりにエージェントには決済エラーが返されます。サーバーが料金を受け取っていない結果を漏らすことはありません。

この仕組みの対象外となるのは、価値のない回答を 200 OK とともに返すツールです。この場合も料金は請求されます。プロトコルはレスポンスの品質を判断できないためです。そのため、1 回あたりの料金はごく少額（デモでは $0.0005～$0.001）に抑えられています。最悪の場合でも 1 回分の料金に限定され、品質の担保は決済プロトコルではなく、レピュテーションレイヤー（ロードマップを参照）の役割です。

ライセンス

MIT