> Feedback: If these docs are stale, missing, or confusing, post sanitized feedback to `https://docs.tempo.xyz/api/feedback` with `source: "mcp"`, a short `message`, and any relevant `toolName`, `relatedResource`, or `client`.
# Reference

## `tempo wallet`

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

### Auth

| Command | Description |
| --- | --- |
| `tempo wallet login` | Connect or create wallet via browser auth |
| `tempo wallet logout` | Disconnect wallet and clear local credentials |
| `tempo wallet whoami` | Print readiness, address, balances, and key state |

### Keys

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 |

### Funds

| Command | Description |
| --- | --- |
| `tempo wallet fund` | Fund wallet (faucet on testnet, bridge on mainnet) |
| `tempo wallet transfer <amount> <token> <to>` | Transfer tokens to another address |

### Services

The service directory indexes [MPP](https://mpp.dev)-registered providers. Each service entry includes endpoint URLs, HTTP methods, and expected request schemas, enough to construct a valid `tempo request` call.

| 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 |

### Sessions

Sessions are the local state for [pay-as-you-go](/docs/guide/machine-payments/pay-as-you-go) payment channels. The 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 |

### Other

| Command | Description |
| --- | --- |
| `tempo wallet mpp-sign` | Sign an MPP payment challenge (used internally by `tempo request`) |

## `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 <url> --json '{...}'` | Send a JSON body (implies `-X POST`) |
| `tempo request <url> -H 'Header: Value'` | Add a custom header |

## 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 fund`, `tempo wallet sessions close` | Preview the action without executing |
| `--help` | all commands | Show command documentation |
| `--describe` | supported commands | Output command schema as JSON for programmatic tooling |

## Source

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