MPP Agent
通过 Machine Payments Protocol(MPP,机器支付协议)支付返回 HTTP 402 的 API。
技能元数据
| 来源 | 可选 — 使用 kopi skills install official/payments/mpp-agent 安装 |
| 路径 | optional-skills/payments/mpp-agent |
| 版本 | 0.1.0 |
| 作者 | Teknium (teknium1), KOPI AI AGENT |
| 许可证 | MIT |
| 平台 | linux, macos |
| 标签 | Payments, MPP, HTTP-402, Tempo, Stripe |
| 相关技能 | stripe-link-cli, stripe-projects |
参考:完整 SKILL.md
以下是当此技能被触发时 Kopi Agent 加载的完整技能定义。这就是技能处于激活状态时 agent 所看到的指令。
MPP Agent 技能
封装 Machine Payments Protocol(MPP,https://mpp.dev)客户端,使 Kopi Agent 能够针对返回 HTTP 402 Payment Required 的服务器按请求付费访问 API。
共有三种客户端选项,均通过 npm 分发。选择能满足用户需求的最轻量的那一个。在 Windows 上,[linux, macos] 处于受控(gated)状态,直到更广泛的支付工具成熟。
何时使用
- 某个商户 API 返回
HTTP 402并带有一个www-authenticate头 —— 而用户确实想要支付它,而不只是记录响应。 - 用户要求"按请求付费"、"设置 agent 钱包"、"使用 Tempo / Privy / AgentCash",或者想发现按 MPP 定价的服务。
- 某次 Stripe Link 支出已生成 Shared Payment Token(SPT,共享支付令牌),而 agent 需要将其附加到 402 challenge 上 —— 在该流程中,优先使用
link-cli mpp pay(参见stripe-link-cli技能)。
选择客户端
| 工具 | 适用场景 | 安装配置 |
|---|---|---|
link-cli | 用户已配置 Stripe Link,或 402 challenge 中声明了 method="stripe" | 参见 stripe-link-cli 技能 |
| Tempo Wallet | 需要支出控制、服务发现的 MPP 服务 | tempo wallet login |
| Privy Agent CLI | 多链钱包、基于浏览器的充值 | privy-agent-wallets login |
| AgentCash | 通过单一 USDC.e 余额访问 300 多个预定价 API | npx agentcash onboard |
mppx | 开发 + 调试,依赖面最小 | 先 npm install -g mppx,再 mppx account create |
默认选择:如果用户已配置 Stripe Link,或 402 challenge 指定了 method="stripe",则使用 link-cli mpp pay(即 stripe-link-cli 技能)。否则,一次性付费调用和调试用 mppx;当用户需要持久的支出控制时使用 Tempo Wallet。
前提条件
- 在
PATH上安装 Node.js 20+ - 一个已充值的钱包(Tempo / Privy / AgentCash),或者一个
mppx账户 - 对于 Tempo / Privy / AgentCash:遵循各自的接入技能:
https://tempo.xyz/SKILL.mdhttps://agents.privy.io/skill.mdhttps://agentcash.dev/skill.md
如果用户选择了其中之一,使用 web_extract 获取对应的 SKILL.md 文件。
操作步骤(mppx,最快路径)
所有命令都通过 terminal 工具运行。
1. 安装并创建账户
npm install -g mppx
mppx account create
将生成的账户凭据保存到 CLI 指示的位置(CLI 会把它们写入自己的配置目录 —— 不要把它们粘贴到 agent 的对话记录中)。
2. 查看商户的 402 challenge
如果用户给了你一个 URL,先探测它以确认它确实使用 MPP:
curl -i <url>
一个真实的 MPP 402 长这样:
HTTP/1.1 402 Payment Required
www-authenticate: tempo amount=0.1 currency=...
3. 支付该请求
mppx <url>
对于非 GET 方法或带请求体的情况:
mppx <url> --method POST --data '<json>'
mppx 会自动处理 402 challenge/凭据交互流程,并在成功时打印商户的实际响应。
4. 验证收据
mppx 会自动附上收据头。如需查看:
mppx <url> -v
操作步骤(Tempo Wallet)
https://tempo.xyz/SKILL.md 上的 Tempo Wallet 技能是权威参考;用 web_extract 获取并照它执行。要点:
tempo wallet login
tempo wallet pay <url>
支出控制和服务发现位于 https://wallet.tempo.xyz 的钱包 UI 中。
常见陷阱
- 仅提供
HTTP 402而没有method="stripe"的 challenge 无法用 Stripe Link 支付。 如果 challenge 只声明了 Tempo / 其他方式,请使用mppx(或与之匹配的钱包)—— Link 会拒绝它。反过来,如果它声明了method="stripe",则优先通过stripe-link-cli技能使用 Link,这样支出会走用户已批准的卡。 - 一个头里出现多个 challenge。
www-authenticate可能列出多种方式(例如tempo, stripe)。Link CLI 的mpp decode会选择 Stripe 那一种;mppx会选择 Tempo。不存在唯一"正确"的客户端 —— 根据用户已充值的钱包来选择。 - 零金额 challenge。 有些 MPP 端点收取
$0.00,只想要一个证明凭据。这些无需已充值的钱包即可使用。不要因为它们"坏了"而拒绝。 - 钱包密钥绝不能进入 agent 的上下文。 这四个客户端都把密钥存放在各自的配置目录下(在 Privy 的情况下是生成每次会话的临时密钥对)。不要
cat/read_file它们。 - 服务端 MPP 属于另一个技能。 如果用户想给自己的 API 添加 402,这个技能就不对 —— 请引导他们去 https://mpp.dev/quickstart/server 以及
mppx/nextjs/mppx/hono/mppx/express/mppx/elysia中间件。以后可能会有一个专门的mpp-server技能。
验证
mppx --version && mppx account list
退出码 0 表示已安装且账户已存在。