mpp

HTTP 402机器支付协议SDK合集

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:mpp。
它的用途是:HTTP 402机器支付协议SDK合集
完整的 Skill 内容见:https://321skill.com/skills/mpp-x-2/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

'使用mppx为我的Next.js API端点添加支付墙,当用户调用/generate时返回402并提示支付0.01美元,支付成功后返回结果。' 它会自动集成mppx中间件,配置Tempo稳定币支付,并处理charge意图,在API路由中插入支付验证逻辑,返回402响应并监听支付完成回调。

介绍

MPP(Machine Payments Protocol)是专为机器对机器支付设计的开放协议,基于HTTP 402 Payment Required状态码,解决AI Agent、MCP工具、付费API等场景中自动化的微支付问题。它支持一次性支付(charge)和流式按量付费(session)两种意图,并集成了Tempo稳定币、Stripe信用卡、Lightning Bitcoin等多种支付方式,让开发者无需自建支付系统即可实现按token计费、按调用收费等需求。

使用该仓库的SDK(mppx TypeScript、pympp Python、mpp Rust),您可以快速为现有服务添加支付墙。只需在HTTP响应中返回402状态码,SDK会自动处理支付流程。mppx还提供了Hono/Express/Next.js/Elysia中间件,方便集成到主流框架中。通过定义charge(一次性)或session(流式)意图,服务端即可控制访问权限,客户端完成支付后获得资源。

适合需要为AI Agent支付流、MCP工具付费、付费API端点、按token流式服务等场景的开发者,尤其是构建智能体平台、SaaS API服务或去中心化支付系统的团队。后端开发者、全栈工程师和智能体开发者都能快速上手。

使用前建议先阅读MPP协议文档,理解402语义。支付方式需提前配置(如Tempo节点或Stripe密钥)。高并发场景下建议测试session会话支付的性能,并注意客户端和服务端需同时支持HTTP 402协议。

核心特点

与通用支付SDK不同,MPP原生基于HTTP 402规范,专为机器对机器自动支付设计,无需人工干预,且内置charge(一次性)和session(流式)两种意图,适合AI Agent间的微支付和按token计费场景。

注意事项

不适用于传统B2C或C2C支付场景,且需要服务端和客户端都支持HTTP 402协议。

常见问题

MPP支持哪些支付方式?

支持Tempo稳定币、Stripe信用卡、Lightning Bitcoin及自定义支付方法。

什么是charge和session意图?

charge是一次性支付,session是流式按量付费,适合按token计费或时长计费。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/mpp-x-2/raw/index.md 读取 mpp 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。