Skip to main content
Glama
deenesjakoruzh
krystiangw

agenticpay

by krystiangw
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

agenticpay

CI CodeQL gitleaks License: MIT GitHub stars npm: @agenticpay/sdk npm downloads

获取 AI 代理的付费。 为 MCP 生态系统提供的开源支付基础设施 —— 为任何工具声明价格，代理通过 x402 以 USDC 支付，并在 Solana 上约 1.5 秒内完成结算。

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

全栈内容都在这里 —— SDK、CLI、支付墙中间件、自托管 x402 协调器 (facilitator) 以及一个实时 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)：

为什么

当前的 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 指向公共的 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 Actions。Solana 原生 AI 代理按工具调用付费。

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 代理为工具调用付费

安装

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

或者克隆 monorepo 以获取实时双代理演示和易于编辑的模板（建议首次运行时使用 —— 请参阅下方的快速入门）。

与 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 代理栈的即插即用模板位于 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 已完成端到端验证。支持主网配置，但需要为协调器充值真实的 SOL，并指向支持主网的 RPC（Helius、QuickNode 等）。

路线图

  • [x] Devnet 端到端演示 (冒烟测试 + LLM 代理)

  • [x] 自托管 x402 协调器 (验证 + 结算，fee_payer 抽象)

  • [ ] 真实世界的 MCP 服务器模板 (搜索、获取、总结、提取 —— 而不是玩具般的 reverse_string)

  • [ ] 用于长期运行任务的链上托管 (Anchor 程序)

  • [ ] 链上代理声誉注册表

  • [ ] 托管协调器服务 (agenticpay.com)

什么是协调器？

如果你以前从未见过 x402：协调器是受信任的中间人，它 (1) 验证代理已签名的支付载荷，(2) 在链上提交 USDC 转账，以及 (3) 支付 SOL Gas 费用，这样代理就不需要任何 SOL —— 只需要 USDC。大多数 MCP 开发者不想运行自己的协调器；他们会指向一个托管的协调器。

本仓库提供了一个完整的协调器实现。你可以自托管、分叉、审计它，或者将其作为服务部署给你的用户。

许可

MIT

Install Server
A
license - permissive license
B
quality
D
maintenance

How are these scores calculated?

Resources

Tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/krystiangw/agenticpay'

If you have feedback or need assistance with the MCP directory API, please join our Discord server