Tools · Wallets & toolkits

Minibits Ippon

A Cashu wallet built from the ground up for AI agents — create and fund a short-lived, single-purpose wallet in one HTTP call or CLI command.

software minibits-cash Links verified 2026-08-07

What it is

Ippon is a minimalistic Cashu (ecash + Lightning) wallet designed from the ground up for autonomous agents, from the team behind the Minibits mobile wallet. An agent creates a wallet via a single HTTP call or CLI command, funds it over Lightning, and transacts in seconds — no channel management at the agent layer, because the mint handles Lightning and the agent just holds bearer ecash. It runs as a hosted REST API server or a local CLI, and a companion minibits_ippon_mcp wraps the API for MCP clients.

It is the canonical agent-native Cashu wallet: the lightest path to giving an agent a spendable balance.

When to use it

  • Spinning up short-lived, single-purpose, low-balance wallets for individual agents or tasks.
  • Cashu-based agent payments where you want an HTTP/CLI interface, not a mobile app.
  • Wiring ecash payments into an MCP-capable agent via minibits_ippon_mcp.

Dependencies

A Cashu mint to back the wallet (it handles Lightning) and a single HTTP call or CLI command to create and fund it; the agent just holds bearer ecash, no channel management. Add minibits_ippon_mcp for MCP clients. Alpha and custodial — keep wallets disposable and small.

Quick start

There is a live public instance, and the README leads with it: ippon.minibits.cash — Swagger UI at /v1/, the OpenAPI 3.0 spec at /v1/json, service info at /v1/info, and an MCP server at /mcp (POST). It is also reachable as a Tor hidden service at eaqmg2oqhay5btz5v75bgknfb3x4q4vesfijjzvgkbgocn5fvhkntwad.onion. All four HTTP routes verified live 2026-08-07.

That instance is for evaluation, not for money you mind losing. Minibits labels it plainly: “provided for research, development and testing and evaluation purposes only. It is an alpha software, use it at your own risk, with small amounts only.” For anything beyond a trial, run your own — the server is the same code either way.

Otherwise: run the Ippon API server yourself and create a wallet with a single HTTP call or the CLI, per the repo README at github.com/minibits-cash/minibits_ippon; add minibits_ippon_mcp to expose it to MCP clients, or run Ippon in CLI mode (INTERACTION_MODE=cli) for an agent that would rather spawn a local process than call a host. The Minibits mobile wallet (Android) is a separate, human-facing product.

Gotchas

  • Ippon is alpha and fully custodial — the project’s own guidance is “use at your own risk, small amounts only.” Treat wallets as disposable and single-purpose.
  • Security is intentionally minimal (simple access keys, no token refresh); the real safeguards are rate limits, max-balance caps, and per-transaction thresholds.
  • Standard Cashu custodial-mint trust applies — the backing mint can fail or rug. See Cashu.

For agents — connect

Reach this programmatically — facts, not endorsements; verify before you depend on them.

Prerequisite
A hosted account (no identity check, but a human signs up first) account
Connect to act
http payment MCP · https://ippon.minibits.cash/mcp · repo EVALUATION ONLY - do not fund this endpoint with money you mind losing. It is the operator's own public instance of Ippon, an agent-native Cashu (ecash + Lightning) wallet, and the operator labels it 'provided for research, development and testing and evaluation purposes only. It is an alpha software, use it at your own risk, with small amounts only.' Registered anyway because it is the one live, agent-reachable ecash wallet endpoint in the catalog and an agent should be able to find it - but the endpoint is a trial surface, not a production wallet. For production, run your own Ippon server (same code) and point here for the shape. Verified live 2026-08-07: POST /mcp answers initialize as serverInfo minibits-ippon 1.0.0; the same host serves Swagger UI at /v1/ and an OpenAPI 3.0 spec at /v1/json, plus a Tor hidden service. Custodial by design: the backing Cashu mint holds the value, so standard mint-failure risk applies on top of the alpha label. Tool names are not enumerated here - read them from the server.

In the marketplace directory: call get_tool with slug minibits-ippon at /mcp · this card as markdown.