PerformanceBlog
Tempo MCP serverGive agents search and read tools for Tempo docs
Skip to content
LogoLogo

Tempo Wallet CLI Reference

tempo wallet

Manages your onchain identity and provides service discovery for MPP endpoints.

Wallet auth commands

CommandDescription
tempo wallet loginConnect or create wallet via browser auth
tempo wallet login --no-browserPrint an auth URL for remote-host login
tempo wallet refreshRefresh your access key without logging out
tempo wallet logoutDisconnect wallet and clear local credentials
tempo wallet whoamiPrint readiness, address, balances, and key state
tempo wallet whoami --creditsShow MPP Credits balance

Wallet key commands

Each wallet can have multiple access keys with independent spending limits. This is how you constrain what an agent or script can spend.

CommandDescription
tempo wallet keysList keys and their spending limits
tempo wallet revoke <access-key> --dry-runPreview access-key revocation
tempo wallet revoke <access-key>Revoke an access key

Wallet funding commands

CommandDescription
tempo wallet fundFund wallet (faucet on testnet, bridge on mainnet)
tempo wallet fund --cryptoOpen direct crypto funding
tempo wallet fund --creditsBuy credits for eligible one-time MPP charges
tempo wallet transfer <amount> <token> <to>Transfer tokens to another address
tempo wallet transfer <amount> <token> <to> --dry-runPreview a token transfer
tempo wallet transfer --credits --mpp-challenge-file <file>Pay a captured MPP challenge with credits

Wallet service commands

The service directory indexes MPP-registered providers. Each service entry includes endpoint URLs, HTTP methods, pricing, request schemas, payment mode, and credit support when available.

CommandDescription
tempo wallet servicesList all registered services
tempo wallet services --search <query>Filter services by keyword
tempo wallet services <id>Show a service's endpoints, methods, and request schemas

Wallet session commands

Sessions are the local state for pay-as-you-go payment channels. Tempo Wallet CLI tracks them locally and can reconcile against onchain state.

CommandDescription
tempo wallet sessions listList active payment sessions
tempo wallet sessions syncReconcile local sessions with onchain state
tempo wallet sessions close --allClose all sessions
tempo wallet sessions close --orphanedClose sessions whose counterparty is unreachable
tempo wallet sessions close --finalizeFinalize channels pending close
tempo wallet sessions close --cooperative <url>Use cooperative close for a target session

Agent setup and diagnostics

CommandDescription
tempo wallet debugCollect debug info for support
tempo wallet completions <shell>Generate shell completions

tempo request

A curl-like HTTP client that handles MPP payment negotiation transparently. On a 402 Payment Required response, it reads the challenge, signs and submits the payment, then retries with the credential.

CommandDescription
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>Cap cumulative payment spend
tempo request <url> --json '{...}'Send a JSON body (implies -X POST)
tempo request <url> -H 'Header: Value'Add a custom header
tempo request -D <file> <url>Write response headers to a file

Tempo Wallet global flags

FlagScopeDescription
-t / --toon-outputtempo wallet, tempo requestCompact machine-readable output for scripts and agents
--dry-runtempo request, tempo wallet transfer, tempo wallet sessions closePreview the action without executing
--max-spendtempo requestHard cap for cumulative payment spend
--helpall commandsShow command documentation
--describesupported commandsOutput command schema as JSON for programmatic tooling
--schemasupported built-in setup commandsOutput command schema for programmatic tooling

Tempo Wallet source