> Feedback: If these docs are stale, missing, or confusing, post sanitized feedback to `https://tempo.xyz/developers/api/feedback` with `source: "mcp"`, a short `message`, and any relevant `toolName`, `relatedResource`, or `client`.
> **Can't find what you're looking for?** Use `search_docs` on the docs MCP server at `https://tempo.xyz/developers/api/mcp` to find what you need.
>
> **Have feedback?** Use `submit_feedback` on the same MCP server.

# Tempo Wallet CLI Reference

## `tempo wallet`

Manages your onchain identity and provides service discovery for [MPP](https://mpp.dev) endpoints.

### Wallet auth commands

| Command | Description |
| --- | --- |
| `tempo wallet login` | Connect or create wallet via browser auth |
| `tempo wallet login --no-browser` | Print an auth URL for remote-host login |
| `tempo wallet refresh` | Refresh your access key without logging out |
| `tempo wallet logout` | Disconnect wallet and clear local credentials |
| `tempo wallet whoami` | Print readiness, address, balances, and key state |
| `tempo wallet whoami --credits` | Show MPP Credits balance |

### Wallet key commands

Each wallet can have multiple access keys with independent spending limits. This is how you constrain what an agent or script can spend.

| Command | Description |
| --- | --- |
| `tempo wallet keys` | List keys and their spending limits |
| `tempo wallet revoke <access-key> --dry-run` | Preview access-key revocation |
| `tempo wallet revoke <access-key>` | Revoke an access key |

### Wallet funding commands

| Command | Description |
| --- | --- |
| `tempo wallet fund` | Fund wallet (faucet on testnet, bridge on mainnet) |
| `tempo wallet fund --crypto` | Open direct crypto funding |
| `tempo wallet fund --credits` | Buy credits for eligible one-time MPP charges |
| `tempo wallet transfer <amount> <token> <to>` | Transfer tokens to another address |
| `tempo wallet transfer <amount> <token> <to> --dry-run` | Preview a token transfer |
| `tempo wallet transfer --credits --mpp-challenge-file <file>` | Pay a captured MPP challenge with credits |

### Wallet service commands

The service directory indexes [MPP](https://mpp.dev)-registered providers. Each service entry includes endpoint URLs, HTTP methods, pricing, request schemas, payment mode, and credit support when available.

| Command | Description |
| --- | --- |
| `tempo wallet services` | List all registered services |
| `tempo wallet services --search <query>` | Filter services by keyword |
| `tempo wallet services <id>` | Show a service's endpoints, methods, and request schemas |

### Wallet session commands

Sessions are the local state for [pay-as-you-go](/docs/guide/machine-payments/pay-as-you-go) payment channels. Tempo Wallet CLI tracks them locally and can reconcile against onchain state.

| Command | Description |
| --- | --- |
| `tempo wallet sessions list` | List active payment sessions |
| `tempo wallet sessions sync` | Reconcile local sessions with onchain state |
| `tempo wallet sessions close --all` | Close all sessions |
| `tempo wallet sessions close --orphaned` | Close sessions whose counterparty is unreachable |
| `tempo wallet sessions close --finalize` | Finalize channels pending close |
| `tempo wallet sessions close --cooperative <url>` | Use cooperative close for a target session |

### Agent setup and diagnostics

| Command | Description |
| --- | --- |
| `tempo wallet debug` | Collect debug info for support |
| `tempo wallet completions <shell>` | Generate shell completions |

## `tempo request`

A curl-like HTTP client that handles [MPP](https://mpp.dev) payment negotiation transparently. On a `402 Payment Required` response, it reads the challenge, signs and submits the payment, then retries with the credential.

| Command | Description |
| --- | --- |
| `tempo request <url>` | Make an HTTP request with automatic payment |
| `tempo request --dry-run <url>` | Preview cost without executing payment |
| `tempo request --max-spend <amount> <url>` | Cap cumulative payment spend |
| `tempo request <url> --json '{...}'` | Send a JSON body (implies `-X POST`) |
| `tempo request <url> -H 'Header: Value'` | Add a custom header |
| `tempo request -D <file> <url>` | Write response headers to a file |

## Tempo Wallet global flags

| Flag | Scope | Description |
| --- | --- | --- |
| `-t` / `--toon-output` | `tempo wallet`, `tempo request` | Compact machine-readable output for scripts and agents |
| `--dry-run` | `tempo request`, `tempo wallet transfer`, `tempo wallet sessions close` | Preview the action without executing |
| `--max-spend` | `tempo request` | Hard cap for cumulative payment spend |
| `--help` | all commands | Show command documentation |
| `--describe` | supported commands | Output command schema as JSON for programmatic tooling |
| `--schema` | supported built-in setup commands | Output command schema for programmatic tooling |

## Tempo Wallet source

* Repository: [`tempoxyz/wallet-cli`](https://github.com/tempoxyz/wallet-cli)
* Full help: `tempo wallet --help`, `tempo request --help`