{
  "markdown": "# peage-mcp — give your agent a wallet\n\nAn [MCP](https://modelcontextprotocol.io) server that puts a prepaid **fiat** wallet in\nany MCP-capable agent (Claude Code, Claude Desktop, anything speaking MCP stdio).\nThe agent can then **pay APIs per call** on the [peage rail](https://peage.intrane.fr)\n— cents at a time, no crypto, no subscriptions, with spending caps you control.\n\nOne ~120 KB static binary, pure [machin (MFL)](https://github.com/javimosch/machin). No Node, no Python.\n\n## Install\n\nGrab the binary (or `./build.sh` with machin on PATH), then register it:\n\n**Claude Code** (`.mcp.json` in your project, or `~/.claude.json` for user scope):\n```json\n{\"mcpServers\": {\"peage\": {\"command\": \"/path/to/peage-mcp\", \"args\": [\"serve\"]}}}\n```\n\n**Claude Desktop** (`claude_desktop_config.json`): same snippet under `mcpServers`.\n\n## What the agent gets (7 tools)\n\n| tool | what it does |\n|---|---|\n| `peage_setup` | mint the wallet once; token stored at `~/.peage-mcp.json` |\n| `peage_status` | balance, escrow, caps, recent charges |\n| `peage_topup` | Stripe Checkout URL → the agent hands it to you, you pay once |\n| `peage_paid_request` | call any peage-metered API with the wallet attached |\n| `peage_set_limits` | per-call + per-merchant daily spending caps |\n| `peage_verify_receipt` | publicly verify any signed charge receipt |\n| `peage_solvency` | audit the rail's live ledger invariant |\n\nThe human appears exactly once in the loop: paying the top-up link. Everything else is\nthe agent's business.\n\n## The 60-second demo\n\nAsk your agent: *\"set up a peage wallet, then fetch https://peage.intrane.fr/demo/fortune\nas a paid request\"* — it mints a wallet that comes with **free starter credit**, so it pays\nthe 1-cent toll and gets its fortune **on the first try, no human needed**. When the free\ncredit runs out, `peage_topup` hands you a Stripe link to fund more. That's the whole\nagent-payment loop — and the agent completes it before you touch your card.\n\n## Security model\n\n- The wallet token lives in `~/.peage-mcp.json` (or `PEAGE_WALLET_TOKEN`). Sharing it\n  with a merchant API is *how they charge you* — the caps bound the exposure: default\n  1€ per call / 10€ per merchant per day, adjustable via `peage_set_limits`.\n- The rail stores only a hash of the token; every charge returns an HMAC-signed receipt\n  anyone can verify; the ledger invariant is public (`peage_solvency`).\n- `PEAGE_URL` points the server at a different rail instance (self-hosted, staging).\n\nSibling repos: [peage](https://github.com/javimosch/peage) (the rail, docs, skills) ·\nx402: peage is a [live x402 facilitator](https://github.com/javimosch/peage/blob/master/specs/scheme-exact-peage.md).\nAn [intrane.fr](https://intrane.fr) product. Contact: javi@intrane.fr\n",
  "bytes": 2756,
  "sha": "6016b2eb6fa797a4997ad54d0b77ec809c5b5f07a830aac5db05fade1dfdc46c",
  "repo_slug": "javimosch/peage-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_fr_intrane_peage_mcp_58d0cec8/readme"
}