{/* This page is auto-generated from the skill's SKILL.md by website/scripts/generate-skill-docs.py. Edit the source SKILL.md, not this page. */}

Mpp Agent

通过机器支付协议（MPP）支付 HTTP 402 API。

Skill 元数据
来源可选——使用 hermes skills install official/payments/mpp-agent 安装
路径optional-skills/payments/mpp-agent
版本0.1.0
作者Teknium (teknium1), Hermes Agent
许可证MIT
平台linux, macos
标签Payments, MPP, HTTP-402, Tempo, Stripe
相关 skillstripe-link-cli、stripe-projects

参考：完整 SKILL.md

INFO

以下是 Hermes 在触发此 skill 时加载的完整 skill 定义。这是 skill 激活时 agent 所看到的指令内容。

MPP Agent Skill

封装机器支付协议（MPP，https://mpp.dev）客户端，让 Hermes 能对那些以 HTTP 402 Payment Required 响应的服务器按请求付费访问 API。

三个客户端选项，都通过 npm 分发。选能满足用户需求的最轻量那个。在 Windows 上更广泛的支付工具成熟之前，本 skill 限定 [linux, macos]。

使用时机

  • 某商户 API 返回 HTTP 402，带 www-authenticate 头——而用户是想真正付费，而不只是记录响应。
  • 用户要求"按请求付费"、"搭一个 agent 钱包"、"用 Tempo / Privy / AgentCash"，或想发现 MPP 定价的服务。
  • 一笔 Stripe Link 消费产生了共享支付令牌（SPT），agent 需要把它附到 402 挑战上——在那个流程里优先用 link-cli mpp pay（见 stripe-link-cli skill）。

选择客户端

工具何时用配置
link-cli用户已配好 Stripe Link，或 402 挑战公布 method="stripe"见 stripe-link-cli skill
Tempo Wallet有消费额度控制、服务发现的 MPP 服务tempo wallet login
Privy Agent CLI多链钱包、基于浏览器的注资privy-agent-wallets login
AgentCash300+ 个预定价 API，一个 USDC.e 余额打通npx agentcash onboard
mppx开发 + 调试，依赖面最小npm install -g mppx 然后 mppx account create

默认：如果用户已配好 Stripe Link 或 402 挑战指定 method="stripe"，用 link-cli mpp pay（stripe-link-cli skill）。否则一次性付费调用和调试用 mppx，用户想要持久消费额度控制时用 Tempo Wallet。

前提条件

  • PATH 上有 Node.js 20+
  • 一个已注资的钱包（Tempo / Privy / AgentCash）或一个 mppx 账户
  • 对于 Tempo / Privy / AgentCash：遵循各自的上手 skill：
    • 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 挑战

如果用户给你一个 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 挑战/凭据流程，成功时打印商户的真实响应。

4. 验证收据

mppx 自动附上收据头。查看：

mppx <url> -v

流程（Tempo Wallet）

https://tempo.xyz/SKILL.md 上的 Tempo Wallet skill 是权威参考；用 web_extract 拉取并遵循它。概要：

tempo wallet login
tempo wallet pay <url>

消费额度控制和服务发现位于 https://wallet.tempo.xyz 的钱包 UI。

常见陷阱

  • 不带 method="stripe" 的 HTTP 402 无法用 Stripe Link 支付。 如果挑战只公布 Tempo / 其他方法，用 mppx（或匹配的钱包）——Link 会拒绝它。反之，如果公布 method="stripe"，优先通过 stripe-link-cli skill 用 Link，让消费走用户已批准的卡。
  • 一个头里有多个挑战。 www-authenticate 可能列出好几种方法（例如 tempo, stripe）。Link CLI 的 mpp decode 会选 Stripe 那个；mppx 会选 Tempo。没有唯一"正确"的客户端——按用户注资了哪个钱包来选。
  • 零金额挑战。 有些 MPP 端点收 $0.00，只想要一个凭据证明。这些不需要已注资的钱包也能工作。不要把它们当成"坏了"而拒绝。
  • 钱包密钥永不进入 agent 上下文。 四个客户端都把密钥存在各自的配置目录下（Privy 则是生成每次会话的临时密钥对）。不要 cat/read_file 它们。
  • 服务端 MPP 是另一个 skill。 如果用户想给自己的 API加 402，本 skill 不对——指向 https://mpp.dev/quickstart/server 和 mppx/nextjs / mppx/hono / mppx/express / mppx/elysia 中间件。专门的 mpp-server skill 可能稍后推出。

验证

mppx --version && mppx account list

退出码 0 表示已安装且账户存在。