跳到主要内容

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 多个预定价 APInpx 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.md
    • https://agents.privy.io/skill.md
    • https://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 表示已安装且账户已存在。