# Tempo Wallet CLI: overview

Tempo Wallet CLI uses Tempo Mainnet for wallet balances, funding, transfers, and MPP settlement. Mainnet has been live since March 18, 2026, and pathUSD in Tempo Wallet is the production mainnet asset. Use the separate Moderato testnet only for explicitly testnet development workflows.

Tempo Wallet CLI is the command-line way to use Tempo Wallet from scripts, terminals, and AI agents. It has two command families:

* **`tempo wallet`**: manages your onchain identity: authentication, key management, balances, funding, transfers, MPP Credits, service discovery, and payment sessions. It also provides a service directory for discovering [MPP](https://mpp.dev)-compatible endpoints and their request schemas.
* **`tempo request`**: a curl-like HTTP client that handles [Machine Payments Protocol](https://mpp.dev) negotiation automatically. It sends your request, intercepts `402 Payment Required` challenges, signs and submits the payment onchain, then retries with the credential, all in a single command.

Together they let you browse paid APIs, preview costs, and execute paid requests from a terminal, script, or AI agent without writing any integration code.

## Install Tempo Wallet CLI

```bash
curl -fsSL https://tempo.xyz/install | bash
```

## Authenticate with Tempo Wallet CLI

```bash
tempo wallet login
tempo wallet login --no-browser
tempo wallet whoami
tempo wallet whoami --credits
```

`login` opens a browser flow that creates or connects a Tempo Wallet. Use `--no-browser` on remote hosts. `whoami` confirms readiness, prints your address, and shows token balances. `whoami --credits` shows MPP Credits separately from token balances.

## Discover and call a paid API

```bash
# Find services
tempo wallet services --search ai

# Inspect a service's endpoints and request schema
tempo wallet services <SERVICE_ID>

# Preview cost without paying
tempo request --dry-run -X POST \
  --json '{"prompt":"a sunset over the ocean"}' \
  https://fal.mpp.tempo.xyz/fal-ai/flux/dev

# Execute the paid request
tempo request -X POST \
  --json '{"prompt":"a sunset over the ocean"}' \
  https://fal.mpp.tempo.xyz/fal-ai/flux/dev
```

Always build request URLs from `tempo wallet services <SERVICE_ID>` output. Service entries include URLs, methods, pricing, request schemas, and credit support when available.

## Scripting and agents

Tempo Wallet CLI is designed for non-interactive use. Three features matter here:

* **`-t` ([TOON](https://toonformat.dev/) output)**: compact, machine-readable output that minimizes token usage when consumed by an LLM or parsed by a script.
* **`--dry-run`**: previews the payment cost and validates the request shape without spending funds. Useful for agents that need to confirm cost before committing.
* **`--max-spend`**: caps paid `tempo request` workflows so an agent cannot exceed a caller-provided budget.

To set up an AI agent (Claude Code, Amp, Codex) with wallet and request capabilities:

:::code-group
```bash [Claude Code]
claude -p "Read https://tempo.xyz/SKILL.md and set up tempo"
```

```bash [Amp]
amp --execute "Read https://tempo.xyz/SKILL.md and set up tempo"
```

```bash [Codex CLI]
codex exec "Read https://tempo.xyz/SKILL.md and set up tempo"
```
:::

This installs `tempo-wallet` and `tempo-request` skills automatically. The agent can then discover services, preview costs, and make paid requests within scoped spending limits.

## Next Tempo Wallet steps

* [Wallet CLI](https://tempo.xyz/developers/docs/cli/wallet): canonical docs and command reference
* [Reference](https://tempo.xyz/developers/docs/wallet/reference): legacy command reference