用途
agenticpay 提供 MCP（Model Context Protocol）生态的按工具调用付费（pay-per-tool-call）微支付基础设施。当前 AI 智能体栈默认由人类持有信用卡，一旦智能体自主调用 API、雇佣子智能体或为算力付费，这一模式就会失效。项目主张用基于 HTTP 的稳定币微支付来解决：任何 MCP 工具可声明价格，任何智能体可自主支付，结算在 Solana 上约 1.5 秒完成。
主要能力
- 为任意 MCP 工具声明价格，智能体以 USDC 通过 x402 协议付款，在 Solana 上结算。
- 提供完整技术栈：SDK、CLI、付费墙中间件（paywall middleware）、可自托管的 x402 facilitator，以及一个实时 LLM 智能体演示。
- 可指向公共测试网 facilitator：将 mcp-server 的 FACILITATOR_URL 设为 https://agentpay-facilitator-e9b20a5fee6a.herokuapp.com 即可在 devnet 上测试，无需自行部署。
- 随仓库提供 Anthropic Skill（.claude/skills/agenticpay/SKILL.md），复制到 ~/.claude/skills/ 后，Claude Code 可获得 agenticpay 的上下文，引导完成 MCP 服务器变现、生成工具路由，以及验证链上结算。
- 展示一个真实 Claude Opus 智能体接收任务、决定使用哪些付费工具、通过 Solana 上的 x402 微支付自主付款并回答用户。仓库给出 Solana devnet 链上证明（由自托管 facilitator 及 x402.org 结算的交易签名）。
使用方式
- 快速开始（devnet，约 5 分钟，免费）：仓库说明中提供快速开始流程，并推荐首次运行时克隆 monorepo 以获取双智能体实时演示和便于编辑的模板。
- 框架集成：examples/ 目录下提供常见 AI 智能体栈的即用模板，集成矩阵见 examples/README.md。
- facilitator 选择：可指向公共 x402.org/facilitator 用于测试网/devnet，或指向 Coinbase CDP 用于主网；也可自托管仓库提供的完整 facilitator 实现，进行 fork、审计或作为服务部署。
适用场景
适用于需要为 MCP 工具按次收费的开发者，以及希望智能体自主完成微支付的 AI 智能体栈。典型用途包括：给 MCP 服务器增加付费能力、在示例模板基础上集成到常见智能体框架、运行双智能体演示、以及测试 Solana 上的 USDC 微支付结算流程。
关于 facilitator
如果此前未接触 x402：facilitator 是可信中间方，负责（1）验证智能体签名的支付载荷，（2）提交链上 USDC 转账，（3）支付 SOL gas 费，使智能体无需持有 SOL，只需 USDC。多数 MCP 开发者不需要自建 facilitator，可指向托管服务；本仓库提供完整实现，支持自托管、fork、审计或部署为服务。
付费调用失败时的处理
失败的工调用不会被收费。x402 结算是不可逆的推送，中间件对结算时机做了约束：
- 执行前验证：在工具处理器运行前验证支付载荷（签名、资金、要求匹配）。支付无效则返回 HTTP 402，工具不会执行。
- 带缓冲响应执行：处理器运行，但其响应被暂存，暂不发送给智能体。
- 仅在成功时结算：若处理器返回状态码 ≥ 400，中间件完全跳过结算并直接返回错误，失败调用不收费。
- 无付款则不交付结果：若链上结算本身失败，缓冲的工具结果被丢弃，智能体收到支付错误，服务器不会泄露未付款的结果。
需要说明的限制：若工具返回 200 OK 但内容是垃圾答案，仍会被收费——协议无法判断响应质量。这也是演示中单次价格保持微额（$0.0005–$0.001）的原因：最坏情况被限制在一次调用的价格内，质量约束应归入信誉层（见路线图）而非支付协议。
当前状态与待办
项目标注为 pre-alpha，已在 devnet 端到端验证。主网配置受支持，但需要用真实 SOL 为 facilitator 注资，并指向支持主网的 RPC（如 Helius、QuickNode 等）。
路线图/待办包括：devnet 端到端演示（smoke + LLM 智能体）、自托管 x402 facilitator（验证 + 结算，fee_payer 抽象）、真实 MCP 服务器模板（搜索、获取、摘要、抽取，而非玩具化的 reverse_string）、面向长时间运行任务的链上托管（Anchor 程序）、链上智能体信誉注册表、托管 facilitator 服务（agenticpay.com）。以上各项的具体完成状态和可用性暂未提供。
其他信息
仓库名在标题与路径中不一致（标题为 agenticpay-dev/agenticpay，URL 为 github.com/krystiangw/agenticpay），实际对应关系暂未提供。项目以 MIT 许可发布，全部为 TypeScript。关于网站、支出上限（Spend caps）、npm 等栏目标注的具体内容，资料中仅列出标题，详细说明暂未提供。
