> 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

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](/docs/cli/wallet): canonical docs and command reference
* [Reference](/docs/wallet/reference): legacy command reference