A client for the Machine Payments Protocol, which lets software pay APIs that respond with HTTP 402 Payment Required.

Use it to pay metered APIs, set up an agent wallet, attach payment details to a 402 response, or discover services priced per request.

It handles per-request API payments so an agent can access services that require payment instead of a subscription or checkout page.

mpp-agent — Skill for Claude Code and Codex by aivrar

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent

npx skills add aivrar/portable-hermes-agent --skill mpp-agent

Clone the repo

git clone --depth 1 https://github.com/aivrar/portable-hermes-agent

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/skills/aivrar/portable-hermes-agent/mpp-agent/github.svg)](https://agentmods.dev/skills/aivrar/portable-hermes-agent/mpp-agent)

Your own site

<a href="https://agentmods.dev/skills/aivrar/portable-hermes-agent/mpp-agent"><img src="https://agentmods.dev/badge/skills/aivrar/portable-hermes-agent/mpp-agent/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/skills/aivrar/portable-hermes-agent/mpp-agent"><img src="https://agentmods.dev/badge/skills/aivrar/portable-hermes-agent/mpp-agent.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 16 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 1,320 The whole file, excluding the scripts and references it only reads on demand.

Security scan C 2 findings. A grade says what 26 rules found in the file — not that it is safe.

Origin 100% copy Near-identical to another mod in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.00016	$0.01320
Opus 5	$0.00008	$0.00660
Sonnet 5	$0.00003	$0.00264
Haiku 4.5	$0.00002	$0.00132

Measured 6d ago against content hash f44db1c9d2d0, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-09, from the pricing page.

Security

Grade C, and why

mpp-agent scanned grade C with 2 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 6d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Tells the agent never to refusehighAnti-refusal

Suppressing the ability to decline removes a core safety control; a later harmful request then succeeds.

- **Zero-amount challenges.** Some MPP endpoints charge `$0.00` and just want a proof credential. These work without a funded wallet. Don't refuse them as "broken."

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

curl -i <url>

Origin

This is a copy

100% identical to mpp-agent — 0 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

optional-skills/payments/mpp-agent/SKILL.md · 125 lines

How it starts

The opening of the file, as written. The whole thing — 125 lines — stays where its author put it; the contents beside it link to each section on GitHub.

MPP Agent Skill

Wraps the Machine Payments Protocol (MPP, https://mpp.dev) clients so Hermes can pay for per-request API access against servers that respond with HTTP 402 Payment Required.

Three client options, all distributed via npm. Pick the lightest one that solves the user's need. Gated [linux, macos] while the broader payments tooling matures on Windows.

When to Use

A merchant API returns HTTP 402 with a www-authenticate header — and the user wants to actually pay it, not just log the response.
The user asks to "pay per request", "set up an agent wallet", "use Tempo / Privy / AgentCash", or wants to discover MPP-priced services.
A Stripe Link spend has produced a Shared Payment Token (SPT) and the agent needs to attach it to the 402 challenge — in that flow, prefer link-cli mpp pay (see the stripe-link-cli skill).

Choosing a client

Tool	When	Setup
`link-cli`	User already has Stripe Link set up, or the 402 challenge advertises `method="stripe"`	see the `stripe-link-cli` skill
Tempo Wallet	MPP services with spend controls, service discovery	`tempo wallet login`
Privy Agent CLI	Multi-chain wallets, browser-based funding	`privy-agent-wallets login`
AgentCash	300+ pre-priced APIs via one USDC.e balance	`npx agentcash onboard`
`mppx`	Dev + debugging, smallest dep surface	`npm install -g mppx` then `mppx account create`

Default: if the user already has Stripe Link configured or the 402 challenge specifies method="stripe", use link-cli mpp pay (the stripe-link-cli skill). Otherwise mppx for one-off paid calls and debugging, and Tempo Wallet when the user wants persistent spend controls.

Prerequisites

Node.js 20+ on PATH
A funded wallet (Tempo / Privy / AgentCash) OR an mppx account
For Tempo / Privy / AgentCash: follow their respective onboarding skills:
- https://tempo.xyz/SKILL.md
- https://agents.privy.io/skill.md
- https://agentcash.dev/skill.md

Read the full file on GitHub · 125 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

6d ago First seen · 125 lines · 16 tokens per session scan C f44db1c9d2d0

Subscribe to this mod's changes

mpp-agent is a skill published in the GitHub repository aivrar/portable-hermes-agent (217 stars, last pushed today), licensed MIT. It adds 16 tokens to every session and 1,320 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it C with 2 findings (tells the agent never to refuse, makes network calls). It is 100% identical to mpp-agent, differing in 0 lines, and is treated as a copy.

Backend and APIs Finance and fintech ai ai-agents desktop-app hermes lm-studio local-ai

tushare

A Python interface for Tushare, a financial data service that provides market and company information for stocks, funds, futures, and digital assets. It returns queried data as pandas tables.

HKUDS/Vibe-Trading · 79 tokens

service-app-creator

Create or update the Service component of a NextClaw Mini App, choosing between Portable Rust/WASI Components and native-process MCP services. Use after nextclaw-app-creator selects a Service-backed app, or when the user explicitly asks for Service Actions, portable components, local files, external APIs, commands…

Peiiii/nextclaw · 74 tokens

mpp-agent