MoltPe

MoltPe Agent 支付

面向 AI Agent 的支付基础设施——包含 x402、MPP 和法币支付路径的参考实现。

免责声明： 这是一个使用模拟数据的参考实现。用于生产环境时，请实现真实的 PaymentProvider 适配器。MoltPe 的生产服务位于 moltpe.com/mcp。

项目简介

此仓库包含一个用于处理 AI Agent 系统中支付的参考实现。它支持三种支付路径：稳定币小额支付（x402）、基于会话的流式支付（MPP）以及传统法币支付渠道。其目标是展示 Agent 如何通过不同协议付款、收款和管理资金。

快速开始

# MCP Server — payment tools for AI agents
cd mcp-server && npm install && npm start
# Server runs on port 3000 with 11 MCP tools
# Connect Claude Desktop with config from examples/claude-desktop-config.json

# x402 Client — stablecoin micropayments
cd x402-client && npm install && npm run build
# Use in your project:
# import { pay } from '@moltpe/x402-client'

完整用法请参阅 mcp-server/README.md 和 x402-client/README.md。

演示

启动服务并打开 http://localhost:3000，即可交互式探索全部 11 个支付工具。

演示包含：

• 工具浏览器，可编辑每个 MCP 工具的输入
• 跨稳定币、会话和法币提供方的实时余额跟踪
• MPP 会话预算可视化工具，实时显示进度
• 发票生命周期：创建 → 发送 → 跟踪 → 收款
• 所有操作的交易时间线

使用模拟数据运行（默认），或连接到 MoltPe 的实时 MCP 服务。

请参阅 mcp-server/DEMO.md，了解分步操作指南。

实时模式

cd mcp-server
PROVIDER_MODE=live MOLTPE_AGENT_TOKEN=swai_... npm start

连接到 moltpe.com/mcp，以执行真实的链上交易。设置说明请参阅 mcp-server/README.md。

仓库内容

目录	描述
research/	市场调研、协议分析、竞争格局
mcp-server/	MCP 支付服务，包含 11 个工具、3 个模拟提供方（x402、MPP、法币）和 53 项测试
x402-client/	TypeScript x402 客户端 SDK，包含 facilitator 适配器和拦截器，以及 34 项测试
playbook/	构建指南：构建过程、模板和成果
docs/	架构文档、协议概况和市场分析

三轨架构

此实现支持三条并行支付路径：

• 路径 A — 稳定币（x402）： 按请求进行小额支付，并在链上以 USDC 结算
• 路径 B — 基于会话（MPP）： 授权预算，并在会话内流式支付
• 路径 C — 法币： 传统的卡片授权、扣款和结算

每条路径适用于不同的使用场景。三条路径之上设有收款层，用于处理 Agent 应收款项。

flowchart TD
    Agent[AI Agent] --> Collections[Collections Layer<br/>Invoicing · Billing · Receivables]

    Collections --> A[Stablecoin Path<br/>x402]
    Collections --> B[Session Path<br/>MPP]
    Collections --> C[Fiat Path<br/>Card / Bank]

    A --> A1[USDC Micropayments]
    A1 --> A2[On-chain Settlement<br/>Polygon · Base]

    B --> B1[Budget Sessions]
    B1 --> B2[Streaming Settlement<br/>Tempo Network]

    C --> C1[Card Authorization]
    C1 --> C2[Gateway Settlement<br/>Razorpay · Stripe]

    classDef agent fill:#0ea5e9,stroke:#0284c7,color:#fff
    classDef collections fill:#f59e0b,stroke:#d97706,color:#fff
    classDef x402 fill:#22d3ee,stroke:#06b6d4,color:#000
    classDef mpp fill:#a78bfa,stroke:#8b5cf6,color:#000
    classDef fiat fill:#34d399,stroke:#10b981,color:#000

    class Agent agent
    class Collections collections
    class A,A1,A2 x402
    class B,B1,B2 mpp
    class C,C1,C2 fiat

完整说明请参阅 docs/tri-rail-architecture.md。

研究亮点

• 经核实的 Agent 支付交易额为每月 $1.6M，而非自行报告的 $43M（其中 48-86% 为虚报）。详见 research/data/verified-volumes.md。
• Agent 收款／应收账款领域几乎完全是市场空白——只有 PayPal MCP，且受限于其生态系统。详见 docs/collections-gap.md。
• 四种协议（x402、MPP、ACP、AP2）正在融合为不同层，而非正面竞争。详见 docs/protocol-landscape.md。

质量与安全

指标	值
测试	87（53 个 mcp-server + 34 个 x402-client）
通过率	100%
语句覆盖率	86.2% / 95.9%
运行时依赖	0（两个软件包均为 0）
npm audit	0 个漏洞
密钥扫描	0 个发现

完整的覆盖率明细和扫描结果请参见 QUALITY.md。 漏洞报告方式和安全态势请参见 SECURITY.md。 64 项生产部署检查清单请参见 docs/production-security-checklist.md。

集成示例

想将 MoltPe Agent Payments 集成到你的 AI 框架中？以下问题追踪了计划中的集成，并提供示例代码：

• LangChain 工具封装 — 将 MCP 支付工具用作 LangChain 工具
• AutoGen Agent — 带预算防护的支付型 AutoGen Agent
• Base Sepolia 测试网 — 在测试网上进行真实的链上 x402 支付
• Webhook 通知 — 事件驱动的支付通知
• 安全加固文档 — 威胁模型和加固指南
• Eliza 插件 — 适用于 Eliza Agent 框架的支付插件

欢迎贡献——选择一个问题并提交 PR。

深入指南

涵盖 MoltPe 技术栈、AI Agent 支付模式以及印度特定集成的长篇指南：

面向正在评估 MoltPe 的开发者

• 开发者为何选择 MoltPe 来处理 AI Agent 支付 — 五个坦诚的理由，包括其中的权衡
• 5 分钟集成 MoltPe：开发者快速入门 — REST、MCP、x402、Python：四种集成方式，均附有真实代码
• MoltPe 与自建 AI 支付技术栈的比较 — 自建与购买的分析，附有真实的时间估算
• 深入了解 MoltPe 开发者体验 — 错误消息、文档、测试网、速率限制
• AI Agent 支付的 MCP 服务详解 — Claude Desktop / Cursor / Windsurf 配置 + 工具接口

面向印度开发者和 AI 初创公司

• 印度 AI Agent 支付：完整基础设施指南（2026） — 印度专题指南
• 印度 AI Agent 支付成本：2026 年基准测试 — 4 种场景的成本比较，相比 PayPal 可节省 15-28 倍
• 面向印度开发者的 USDC 支付 — USDC 与 Razorpay、Stripe India、PayPal 的比较
• 印度自由职业 AI 开发者的收款方式 — 避免外汇兑换的实用指南
• 印度 AI 初创公司的完整支付技术栈 — 三层技术栈：UPI + MoltPe + Agent 间支付
• 面向印度开发者的 x402 协议 — 使用 USDC 实现 API 变现

协议与基础知识

• 什么是 AI Agent 支付？
• x402 协议：完整指南
• 机器支付协议（MPP）指南
• AI Agent 支出策略详解

简短解答（问答形式）

• 什么是 AI Agent 钱包？
• AI Agent 如何进行支付？
• 什么是 AI Agent 支出策略？
• 如何使用 USDC 实现 API 变现

另请参阅：常见问题 · 术语表 · 用例 · 开发者文档

许可证

• 代码（research/、playbook/、docs/ 之外的所有内容）：Apache License 2.0
• 内容（research/、playbook/、docs/）：Creative Commons Attribution-ShareAlike 4.0

归属信息详见 NOTICE。

引用

@software{moltpe_agent_payments,
  author = {Gupta, Umang},
  title = {MoltPe Agent Payments},
  year = {2026},
  url = {https://github.com/umangbuilds/moltpe-agent-payments},
  license = {Apache-2.0}
}

作者

由 Umang Gupta 创建。MoltPe 为 AI Agent 构建支付基础设施。