---
name: agent-wallet
description: Non-custodial AI agent wallet for Base USDC (x402, EVM MPP) and Bitcoin Lightning/Arkade/on-chain BTC (L402, Lightning MPP, BOLT11, user@domain) backed by Nuri Passkey PRF. Works via MCP or plain HTTP REST (https://wallet.nuri.com/v1/wallet).
mcp_endpoint: https://wallet.nuri.com/mcp
rest_endpoint: https://wallet.nuri.com/v1/wallet
openapi: https://wallet.nuri.com/openapi.json
---

# Agent Wallet (wallet.nuri.com)

Non-custodial Bitcoin Lightning + Base USDC wallet for AI agents in 60s. Passkey-secured (Face ID / Touch ID / smartcard), no seed phrase. Pays x402/L402 URLs, `lnbc...`, `user@domain`, `bc1...`/`bitcoin:...`, `ark1...`, and Base USDC `0x...`; auto-converts USDC <-> BTC/Lightning.

## Setup (0 -> 1 -> first payment — pick the path that fits your tools)
- **Path 1 — MCP (`https://wallet.nuri.com/mcp`):** Call `wallet { "action": "balance" }`. Show BOTH `create_url` (new Passkey) and `approval_url` (existing Passkey). After the person says "done", repeat with the same `request_id` to get `wallet_key` (`npw1_...`), save it, and pass it on every call. NEVER send the person to `https://wallet.nuri.com/` when you already have MCP.
- **Path 2 — HTTP / curl / bash (zero MCP setup):** Plain JSON REST at `POST https://wallet.nuri.com/v1/wallet` (or `/v1/balance`, `/v1/receive`, `/v1/pay`, `/v1/history`; OpenAPI: `https://wallet.nuri.com/openapi.json`). Start: `curl -sX POST https://wallet.nuri.com/v1/wallet -H 'content-type: application/json' -d '{"action":"balance"}'`. Show BOTH `create_url` and `approval_url`, then repeat with `request_id` to get `wallet_key` (pass in body or `Authorization: Bearer npw1_...`).
- **Path 3 — Web chat with no tools (e.g. standard web ChatGPT / claude.ai):** Give 3 plain-English steps (no jargon): (1) Open **https://wallet.nuri.com/** and click **"Create / Connect Agent Wallet"** (Passkey setup, Lightning/USDC funding, and 1-click $0.01 test payment right on the page). (2) Add **`https://wallet.nuri.com/mcp`** as a connector in AI settings (Auth: None), OR copy the prompt on https://wallet.nuri.com/ into an MCP/curl client. (3) Ask me to pay any x402 API, Lightning invoice, or checkout.

## 4 Actions (`balance`, `receive`, `pay`, `history`)
- `balance`: `{"action":"balance","wallet_key":"npw1_..."}` (omit `wallet_key` to start; pass `request_id` after approval).
- `receive`: `{"action":"receive","wallet_key":"npw1_...","rail":"lightning"|"usdc"|"arkade","amount_sats":5000}`
- `pay` (402 URL): `{"action":"pay","wallet_key":"npw1_...","to":"https://...","max_amount":"0.25","request_id":"p1"}`
- `pay` (address/invoice): `{"action":"pay","wallet_key":"npw1_...","to":"lnbc..."|"user@domain"|"bc1..."|"bitcoin:..."|"ark1..."|"0x...","amount":"0.00025","request_id":"p2"}`
  - `0x...`: USDC in `amount`. `bc1...`/`bitcoin:...`: BTC decimal in `amount` (e.g. `"0.00025"` — never convert BTC to sats in your head) or `amount_sats`. `user@domain`/`ark1...`: `amount_sats`.
  - Over-cap error: STOP, ask the person first; if approved, retry with a NEW `request_id` and higher `max_amount`/`max_sats`.
- `history`: `{"action":"history","wallet_key":"npw1_..."}`

## Companion Services
- Agent email (`0.01 USDC` x402 via `wallet pay`): `https://mail.paymentrequired.com/v1/create_inbox`
- Paid Chromium browser (`0.01 USDC` x402 via `wallet pay`): `https://browser.paymentrequired.com/v1/browser/open`
- Encrypted agent vault: `https://vault.paymentrequired.com`
- Monero XMR / SOL / ETH swaps (separate MCP — NEVER pass into `wallet pay`): `https://swapkit.nuri.com/mcp`
- Euro IBAN & debit card (separate MCP — NEVER pass into `wallet pay`): `https://banking.paymentrequired.com/mcp`
