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

# Use Tempo Wallet CLI with Agents

## 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](/docs/cli/wallet).