# Use Tempo Wallet CLI with Agents

Tempo Wallet CLI uses Tempo Mainnet for balances, funding, transfers, and MPP settlement. Agents should treat pathUSD in Tempo Wallet as the live mainnet asset, not as a testnet faucet token.

## Agent wallet quickstart

Paste this into your agent to set up Tempo Wallet CLI:

:::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"
```
:::

## Auto-installed Tempo wallet skills

When you run the setup prompt, your agent installs Tempo's built-in skills automatically. No manual skill wiring required.

* `tempo-wallet`: gives your agent wallet-aware capabilities like readiness checks, balances, service discovery, and session/funding actions.
* `tempo-request`: gives your agent paid HTTP request capabilities with payment preview (`--dry-run`) and execution support.

This works in supported skill-enabled agents including **Claude Code**, **Amp**, **Codex**, and similar environments.

## Tempo Wallet is agent-ready by design

1. **TOON output mode (`-t` / `--toon-output`)** gives compact, machine-readable, token-efficient output so agent tooling can parse command responses reliably.
2. **Built-in service discovery** (`tempo wallet services`) lets agents search providers, inspect endpoint details, and use verified method/path metadata instead of guessing URLs or payload shapes.
3. **`--dry-run` payment previews** let agents validate endpoint reachability, request shape, and expected payment cost before committing funds.
4. **`--max-spend` and scoped access keys** let you enforce budgets per request and per key.
5. **MPP Credits support** lets agents pay eligible one-time charges from a separate credits balance after checking `tempo wallet -t whoami --credits`.

## Tempo Wallet agent pattern

```bash
tempo wallet -t whoami
tempo wallet -t services --search <query>
tempo wallet -t services <SERVICE_ID>
tempo request -t --dry-run --max-spend 1.00 -X POST --json '{"input":"hello"}' <SERVICE_URL>/<ENDPOINT_PATH>
tempo request -t --max-spend 1.00 -X POST --json '{"input":"hello"}' <SERVICE_URL>/<ENDPOINT_PATH>
```

For credit-eligible one-time charges:

```bash
tempo wallet -t whoami --credits
headers="$(mktemp)"
tempo request -t --dry-run -D "$headers" -X POST --json '{"input":"hello"}' <SERVICE_URL>/<ENDPOINT_PATH>
tempo wallet -t transfer --credits --dry-run --mpp-challenge-file "$headers"
```

## Troubleshoot agent wallet flows

If agent runs fail, continue with [Troubleshooting](https://tempo.xyz/developers/docs/cli/wallet).
