agenticpay

agenticpay

网站 · 支出上限 · npm

让 AI Agent 为你付费。 面向 MCP 生态系统的开源支付基础设施——为任意工具设定价格，Agent 通过 x402 使用 USDC 付款， 并在 Solana 上约 1.5 秒内完成结算。

无需 Stripe。无需账户。无需 API 密钥。

完整技术栈一应俱全——SDK、CLI、付费墙中间件、可自托管的 x402 facilitator，以及实时大模型 Agent 演示。全部使用 TypeScript，采用 MIT 许可证。

只想试用？ 将你的 mcp-server 指向我们托管的 devnet facilitator：FACILITATOR_URL=https://agentpay-facilitator-e9b20a5fee6a.herokuapp.com 无需任何设置。

实时演示

一个真实的 Claude Opus Agent 接收任务，决定使用哪些付费工具， 通过 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）：

• 由我们的可自托管 facilitator 完成结算：EsqzTG8id...Bnku
• 更早的一笔结算通过 x402.org 完成：2d2HcefgJ...vkqY

为什么

当前的 AI Agent 技术栈假设由人类持有信用卡。Agent 一旦自主行动——调用 API、雇用 子 Agent、支付算力费用——这一假设就会失效。你无法靠 OAuth 解决这个问题。

通过 HTTP 进行稳定币小额支付可以解决这一问题。agenticpay 专门为 MCP 生态系统打包了缺失的易用性：任意工具都可以设定价格，任意 Agent 都可以付款；整个流程——包括 实际提交链上结算的 facilitator——都开源且可自托管。

架构

┌──────────────┐     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 指向用于 testnet/devnet 的公共 x402.org/facilitator，或指向用于主网的 Coinbase CDP。我们只是让可自托管的方案更容易上手。

软件包

软件包	功能
packages/sdk	TypeScript 基础组件：USDC 转账、钱包管理、网络配置
packages/cli	agenticpay 命令：钱包、余额、发送
packages/mcp-server	带有 x402 付费墙中间件的 HTTP 服务。每个工具都有定价。
packages/facilitator	可自托管的 x402 facilitator——在 Solana 上验证并结算 USDC 付款。代 Agent 支付 SOL 费用。
packages/eliza-plugin	Eliza 插件——将付费 HTTP 端点封装为原生 Eliza Actions。基于 Solana 的 AI Agent 按工具调用付费。
packages/ai-sdk	Vercel AI SDK 辅助工具——将付费工具直接接入 generateText / streamText。
packages/mcp-bridge	真正的 MCP 服务（stdio + @modelcontextprotocol/sdk），封装 x402 付费工具。可直接用于 Claude Desktop / Cursor。
examples/two-agent-demo	真实的 Claude Opus Agent，为工具调用付费

安装

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

也可以克隆此单体仓库，获取可运行的双 Agent 演示和便于编辑的 模板（建议首次运行时使用——请参阅下方的快速入门）。

与 Claude Code 搭配使用

此仓库附带一个 Anthropic Skill， 位于 .claude/skills/agenticpay/SKILL.md。将它复制到 ~/.claude/skills/ 中，即可让 Claude Code 获得关于 agenticpay 的一流上下文——之后，它会引导你 为 MCP 服务添加收费功能、生成工具路由，并验证链上结算，无需每次都重新阅读 README。

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 Agent 技术栈的即用型模板位于 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。

状态

预 Alpha 阶段。已在 devnet 上完成端到端验证。支持 Mainnet 配置，但需要 为 facilitator 充值真实 SOL，并使用支持 Mainnet 的 RPC （Helius、QuickNode 等）。

路线图

• Devnet 端到端演示（冒烟测试 + LLM Agent）
• 可自托管的 x402 facilitator（验证 + 结算、fee_payer 抽象）
• 真实 MCP 服务模板（搜索、获取、摘要、提取——取代玩具示例 reverse_string）
• 长时间运行任务的链上托管（Anchor 程序）
• 链上 Agent 声誉注册表
• 托管式 facilitator 服务（agenticpay.com）

什么是 facilitator？

如果你此前没接触过 x402：facilitator 是一个可信的中间方， 负责（1）验证 Agent 签名的支付载荷，（2）在链上提交 USDC 转账，以及（3）支付 SOL Gas 费用，因此 Agent 无需持有任何 SOL ——只需 USDC。大多数 MCP 开发者不想自己运行 facilitator；他们会指向 一个托管式服务。

此仓库附带完整的 facilitator 实现。你可以自行托管、 分叉、审计，或将其部署为面向自己用户的服务。

付费工具调用失败时会发生什么？

简而言之：工具调用失败不会收费。 x402 结算是不可逆的推送，因此中间件会谨慎控制结算时机：

1. 先验证，再执行。 在工具处理程序运行前，会验证付款载荷（签名、资金和要求是否匹配）。付款无效 → HTTP 402，工具不会执行。
2. 执行并暂存响应。 处理程序会运行，但其响应会被暂扣——暂时不会发送给 Agent。
3. 仅在成功时结算。 如果处理程序返回的状态码 ≥ 400，中间件会完全跳过结算，只返回错误。Agent 不会为失败的调用付费。
4. 未付款则不返回结果。 如果链上结算本身失败，暂存的工具结果会被丢弃，Agent 会收到付款错误——服务端绝不会泄露未收到款项的结果。

以下情况不在此列：工具返回 200 OK，但答案毫无价值，仍然会收费——协议无法判断响应质量。这正是每次调用的价格保持在微额水平（演示中为 $0.0005–$0.001）的原因：最坏情况下，损失上限为一次调用的价格；质量保障应由信誉层（参见 Roadmap）负责，而非付款协议。

许可证

MIT