# presto \[Command-line HTTP client for MPP] `presto` is a command-line HTTP client with automatic payment. On `402 Payment Required`, it handles payment and retries. No API keys needed. ## Install ```bash [install.sh] $ curl -fsSL https://presto-binaries.tempo.xyz/install.sh | bash ``` ## Setup ```bash [login.sh] $ presto login ``` This opens your browser to authenticate with your Tempo wallet. Verify readiness: ```bash [preflight.sh] $ presto whoami ``` Check `ready` is `true` and `key.balance` is sufficient. If not, run `presto login`. :::tip\[Agent config] Set `output_format = "json"` in config (`~/Library/Application Support/presto/config.toml` on macOS, `~/.config/presto/config.toml` on Linux) to avoid passing `--output-format json` on every call. ::: ## Available services ```bash [services.sh] $ curl -s https://mpp.tempo.xyz/services | jq '.[].id' ``` Pattern: `.mpp.tempo.xyz`. Examples: * `https://openrouter.mpp.tempo.xyz/v1/chat/completions` * `https://openai.mpp.tempo.xyz/v1/chat/completions` * `https://anthropic.mpp.tempo.xyz/v1/messages` * `https://fal.mpp.tempo.xyz/fal-ai/flux/schnell` ## Examples ```bash [examples.sh] # LLM request $ presto -X POST \ --json '{"model":"openai/gpt-4o-mini","messages":[{"role":"user","content":"Hello"}]}' \ https://openrouter.mpp.tempo.xyz/v1/chat/completions # Image generation $ presto -X POST \ --json '{"prompt":"A sunset over mountains","image_size":"landscape_4_3","num_images":1}' \ https://fal.mpp.tempo.xyz/fal-ai/flux/schnell # Preview cost without paying $ presto --dry-run -X POST \ --json '{"model":"openai/gpt-4o-mini","messages":[{"role":"user","content":"Hello"}]}' \ https://openrouter.mpp.tempo.xyz/v1/chat/completions ``` ## Error recovery | Exit code | Meaning | Action | |-----------|---------|--------| | 0 | Success | — | | 1 | General error | Retry | | 3 | Config error | `presto login` | | 4 | Network error | Retry | | 5 | Payment failed | Retry | | 6 | Insufficient funds | Tell user to fund wallet | | 8 | Auth error | `presto login` | | 10 | Timeout | Retry with `-m ` | On `No wallet configured`, `Access key is not provisioned`, or exit 3/8: automatically run `presto login` then retry. On `Spending limit exceeded` or `Insufficient balance`: report to user. ## Commands | Command | Description | |---------|-------------| | `presto ` | HTTP request with automatic payment | | `presto login` | Log in (opens browser) | | `presto logout [--yes]` | Log out | | `presto whoami` | Wallet status, balances, keys | | `presto session close --all` | Reclaim funds from all payment sessions | ### Options | Flag | Description | |------|-------------| | `-q` | Quiet (suppress logs, recommended for agents) | | `--output-format json` | JSON output | | `-X ` | HTTP method | | `--json ` | JSON body (sets Content-Type) | | `-d ` | POST data (`@file` or `@-` for stdin) | | `-H

` | Custom header (repeatable) | | `--dry-run` | Preview payment without executing | | `-m ` | Timeout | | `-i` | Include response headers | | `-o ` | Write output to file | | `-v` | Verbose (`-vv` debug, `-vvv` trace) | ## Learn more