Mpp Agent

通过机器支付协议 (MPP) 支付 HTTP 402 API。

技能元数据

来源	可选 — 使用 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
相关技能	stripe-link-cli, stripe-projects

参考：完整 SKILL.md

信息

以下是 Hermes 在触发此技能时加载的完整技能定义。这是技能激活时代理看到的指令。

MPP Agent 技能

封装机器支付协议 (MPP, https://mpp.dev) 客户端，使 Hermes 能够针对响应 HTTP 402 Payment Required 的服务器支付按请求访问的 API 费用。

提供三种客户端选项，均通过 npm 分发。选择能解决用户需求的最轻量级选项。在 Windows 上更广泛的支付工具成熟之前，仅限 [linux, macos]。

何时使用

• 商家 API 返回带有 www-authenticate 标头的 HTTP 402 — 且用户希望实际支付，而不仅仅是记录响应。
• 用户要求“按请求支付”、“设置代理钱包”、“使用 Tempo / Privy / AgentCash”，或希望发现 MPP 定价的服务。
• Stripe Link 支出已产生共享支付令牌 (SPT)，且代理需要将其附加到 402 质询中 — 在该流程中，优先使用 link-cli mpp pay（参见 stripe-link-cli 技能）。

选择客户端

工具	适用场景	设置
link-cli	用户已设置 Stripe Link，或 402 质询通告 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 质询指定 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 会将其写入自己的配置下 — 不要将它们粘贴到代理转录中）。

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 技能是规范参考；使用 web_extract 获取并遵循它。标题：

tempo wallet login
tempo wallet pay <url>

支出控制和服务发现位于钱包 UI https://wallet.tempo.xyz 中。

陷阱

• 不带 method="stripe" 的 HTTP 402 无法通过 Stripe Link 支付。 如果质询（challenge）仅通告 Tempo / 其他方法，请使用 mppx（或任何匹配的钱包）—— Link 会拒绝它。相反，如果它通告了 method="stripe"，则应通过 stripe-link-cli skill 优先使用 Link，以便支出通过用户已批准的卡片进行。
• 一个 header 中包含多个质询。 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 表示已安装且存在账户。