Tempo Wallet CLI

Tempo Wallet CLI is the command-line way to use Tempo Wallet from scripts, terminals, and AI agents. Use tempo wallet to authenticate, manage balances and access keys, discover MPP services, fund token or credit balances, and manage payment sessions. Use tempo request when you want the CLI to make the paid HTTP call.

Download the Tempo Wallet CLI

curl -fsSL https://tempo.xyz/install | bash

The launcher manages tempo wallet and tempo request extensions. To update later, run tempoup. Verify with tempo --version.

Authenticate with Tempo Wallet CLI

tempo wallet login

Opens a browser flow to connect to your Tempo Wallet. If you don't have one, the flow creates it.

For remote hosts where the browser is on another device:

tempo wallet login --no-browser

Once logged in, verify everything works:

tempo wallet whoami

If ready=true, the wallet is ready for tempo request.

Refresh a stale access key without logging out:

tempo wallet refresh

To disconnect:

tempo wallet logout --yes

Balances and credits

tempo wallet whoami
tempo wallet whoami --credits

Shows your address, token balances, key state, and optional MPP Credits balance. Credits are separate from token balances and only apply to eligible one-time MPP charges.

Manage access keys

tempo wallet keys
tempo wallet revoke <ACCESS_KEY_ADDRESS> --dry-run
tempo wallet revoke <ACCESS_KEY_ADDRESS>

Each wallet can have multiple access keys with independent spending limits. Use scoped keys to constrain what an agent or script can spend, and revoke keys that are stale or no longer needed.

Add wallet funds

tempo wallet fund
tempo wallet fund --credits
tempo wallet fund --crypto

On testnet, the default flow opens the faucet. On mainnet, it opens available funding options. --crypto opens direct crypto funding. --credits opens MPP Credits purchase for eligible one-time services.

To transfer tokens to another address:

tempo wallet transfer <amount> <token> <to> --dry-run
tempo wallet transfer <amount> <token> <to>

For more options, see Getting Funds on Tempo.

Discover services

tempo wallet services
tempo wallet services --search <query>
tempo wallet services <id>

The Machine Payments Protocol (MPP) lets HTTP endpoints accept payments inline. The service directory indexes MPP-registered providers. Each entry shows endpoint URLs, HTTP methods, pricing, whether credits are supported, and request schemas. Use it to find the exact URL and payload for tempo request.

Agents that support MCP can also use the read-only services MCP server at https://mpp.dev/mcp/services. See Discover MPP services for MCP setup, JSON-RPC examples, and the public catalog API.

Agent workflow:

tempo wallet -t services --search ai
tempo wallet -t services <SERVICE_ID>
tempo request -t --dry-run -X POST --json '{"input":"hello"}' <SERVICE_URL>/<ENDPOINT_PATH>
tempo request -t -X POST --json '{"input":"hello"}' <SERVICE_URL>/<ENDPOINT_PATH>

Manage payment sessions

When you use pay-as-you-go services, MPP opens a session — a payment channel where your wallet deposits funds into a reserve contract, then pays per request using signed vouchers off-chain. This avoids an on-chain transaction for every request, giving sub-100ms latency and near-zero per-request fees.

Tempo Wallet CLI tracks session state locally:

tempo wallet sessions list
tempo wallet sessions sync
tempo wallet sessions close --all
tempo wallet sessions close --orphaned
tempo wallet sessions close --finalize

sync reconciles local records with onchain state. close --orphaned cleans up sessions whose counterparty is unreachable. close --finalize finalizes channels already pending close. Use --dry-run with any close command to preview before executing.

Agent and script mode

Use TOON output for compact, machine-readable responses:

tempo wallet -t whoami
tempo wallet -t services --search ai
tempo wallet -t services <SERVICE_ID>

Before spending, preview and cap paid requests:

tempo request -t --dry-run -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>

If a service supports MPP Credits, inspect the challenge first, then pay with 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"
tempo wallet -t transfer --credits --mpp-challenge-file "$headers"

Tempo Wallet CLI command reference

Wallet authentication commands

Wallet key commands

Wallet funding commands

Wallet service discovery commands

Wallet session commands

Advanced wallet commands

Learn more about Tempo Wallet CLI