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 表示已安裝且存在賬戶。