tempo request
A curl-compatible HTTP client that handles Machine Payments Protocol negotiation transparently. When a server responds with 402 Payment Required, tempo request reads the challenge, signs and submits the payment onchain, then retries with the credential in one command.
Requires tempo wallet login first. Use tempo wallet services before calling paid endpoints so agents and scripts use registered URLs, methods, pricing, and request schemas instead of guessing.
tempo request usage
| Command | Description |
|---|---|
tempo request <url> | Make an HTTP request with automatic payment |
tempo request --dry-run <url> | Preview cost without executing payment |
tempo request --max-spend <amount> <url> | Set a hard cap for cumulative payment spend |
tempo request -X POST <url> --json '{...}' | Send a JSON body |
tempo request <url> -H 'Header: Value' | Add a custom header |
tempo request flags
| Flag | Description |
|---|---|
-X <method> | HTTP method (GET, POST, etc.) |
--json <body> | Send a JSON body (implies -X POST) |
-H <header> | Add a custom header |
--dry-run | Preview the payment cost and validate the request without spending |
--max-spend <amount> | Stop if the request would exceed a spend cap |
-D <file> / --dump-header <file> | Write response headers, useful for inspecting MPP challenges |
-t / --toon-output | Compact machine-readable output for scripts and agents |
tempo request examples
Preview cost before paying:
tempo request --dry-run -X POST \
--json '{"prompt":"a sunset over the ocean"}' \
https://fal.mpp.tempo.xyz/fal-ai/flux/devExecute a paid request:
tempo request -X POST \
--json '{"prompt":"a sunset over the ocean"}' \
https://fal.mpp.tempo.xyz/fal-ai/flux/devCapture headers for an agent-controlled MPP Credits flow:
headers="$(mktemp)"
tempo request -t --dry-run -D "$headers" -X POST \
--json '{"input":"hello"}' \
<SERVICE_URL>/<ENDPOINT_PATH>Discover the right URL and request schema first with tempo wallet services.
Learn more about paid Tempo requests
Challenges, credentials, and receipts
Authenticate and discover services
TypeScript, Python, and Rust libraries
Add MPP to your own API
Was this helpful?