tempoxyz · letstokenize · Mar 18, 2026 · Mar 18, 2026
diff --git a/bun.lockb b/bun.lockb
diff --git a/src/pages/cli/download.mdx b/src/pages/cli/download.mdx
@@ -0,0 +1,47 @@
+---
+title: tempo download
+description: Download chain snapshots for faster initial sync of a Tempo node.
+---
+
+# `tempo download`
+
+Download chain snapshots for faster initial sync. Fetches MDBX state and static files, and generates a `reth.toml` prune config for the target data directory.
+
+## Usage
+
+```bash
+tempo download [flags]
+```
+
+## Flags
+
+| Flag | Description |
+| --- | --- |
+| `--chain <network>` | Target network (`mainnet`, `moderato`) |
+| `--datadir <path>` | Data directory for downloaded state |
+| `-u, --url <url>` | Download a specific snapshot URL instead of the latest |
+| `--resumable` | Resume an interrupted download |
+| `--minimal` | Download minimal snapshot (pruned state only) |
+| `--archive` | Download full archive snapshot |
+
+## Examples
+
+Download the latest mainnet snapshot:
+
+```bash
+tempo download --chain mainnet
+```
+
+Download to a specific directory:
+
+```bash
+tempo download --chain mainnet --datadir /data/tempo
+```
+
+Resume an interrupted download:
+
+```bash
+tempo download --chain mainnet --resumable
+```
+
+Then start your node with [`tempo node`](/cli/node).
diff --git a/src/pages/cli/index.mdx b/src/pages/cli/index.mdx
@@ -29,13 +29,13 @@ Paste this into your AI agent to set up Tempo Wallet and start making paid reque
 
 :::code-group
 ```bash [Claude Code]
-claude -p "Read https://wallet.tempo.xyz/SKILL.md and set up tempo"
+claude -p "Read https://tempo.xyz/SKILL.md and set up tempo"
 ```
 ```bash [Amp]
-amp -x "Read https://wallet.tempo.xyz/SKILL.md and set up tempo"
+amp --execute "Read https://tempo.xyz/SKILL.md and set up tempo"
 ```
 ```bash [Codex CLI]
-codex exec "Read https://wallet.tempo.xyz/SKILL.md and set up tempo"
+codex exec "Read https://tempo.xyz/SKILL.md and set up tempo"
 ```
 :::
 

diff --git a/src/pages/cli/wallet.mdx b/src/pages/cli/wallet.mdx
@@ -23,16 +23,28 @@ CLI interface for [Tempo Wallet](https://wallet.tempo.xyz), Tempo's web-based pa
     icon="lucide:log-in"
   />
   <Card
-    title="Use it"
-    description="Keys, funds, services, and sessions"
-    to="#use-it"
-    icon="lucide:terminal"
+    title="Check Balances"
+    description="View your address, balances, and key state"
+    to="#check-balances"
+    icon="lucide:coins"
   />
   <Card
-    title="Command reference"
-    description="Full command table"
-    to="#command-reference"
-    icon="lucide:list"
+    title="Add Funds"
+    description="Fund your wallet or transfer tokens"
+    to="#add-funds"
+    icon="lucide:plus-circle"
+  />
+  <Card
+    title="Discover Services"
+    description="Browse MPP-registered service providers"
+    to="#discover-services"
+    icon="lucide:search"
+  />
+  <Card
+    title="Manage Sessions"
+    description="Track and close payment sessions"
+    to="#manage-payment-sessions"
+    icon="lucide:refresh-cw"
   />
 </Cards>
 
@@ -66,25 +78,23 @@ To disconnect:
 tempo wallet logout
 ```
 
-## Use it
-
-### Check balances
+## Check balances
 
 ```bash
 tempo wallet whoami
 ```
 
 Shows your address, token balances, and key state.
 
-### Manage access keys
+## Manage access keys
 
 ```bash
 tempo wallet keys
 ```
 
 Each wallet can have multiple access keys with independent spending limits. Use these to constrain what an agent or script can spend.
 
-### Add funds
+## Add funds
 
 ```bash
 tempo wallet fund
@@ -100,7 +110,7 @@ tempo wallet transfer <amount> <token> <to>
 
 For more options, see [Getting Funds on Tempo](/guide/getting-funds).
 
-### Discover services
+## Discover services
 
 ```bash
 tempo wallet services
@@ -110,7 +120,7 @@ tempo wallet services <id>
 
 The [Machine Payments Protocol](https://mpp.dev/overview) (MPP) lets any HTTP endpoint accept payments inline. The service directory indexes MPP-registered providers — each entry shows endpoint URLs, HTTP methods, pricing, and request schemas. Use it to find the right URL and payload for [`tempo request`](/cli/request).
 
-### Manage payment sessions
+## Manage payment sessions
 
 When you use [pay-as-you-go](/guide/machine-payments/pay-as-you-go) services, MPP opens a [session](https://mpp.dev/payment-methods/tempo/session) — a payment channel where your wallet deposits funds into an escrow contract, then pays per request using signed [vouchers](https://mpp.dev/protocol/credentials) off-chain. This avoids an on-chain transaction for every request, giving sub-100ms latency and near-zero per-request fees.
 

diff --git a/src/pages/guide/getting-funds.mdx b/src/pages/guide/getting-funds.mdx
@@ -3,44 +3,11 @@ title: Getting Funds on Tempo
 description: Bridge assets to Tempo, add funds in Tempo Wallet, or use the faucet on testnet.
 ---
 
-import { Cards, Card } from 'vocs'
-
 # Getting Funds on Tempo
 
-You can get funds onto Tempo in three ways:
-
-<Cards>
-  <Card
-    title="Bridges"
-    description="Move assets to and from Tempo with cross-chain bridges"
-    to="#bridge"
-    icon="lucide:arrow-left-right"
-  />
-  <Card
-    title="Tempo Wallet"
-    description="Add funds directly in Tempo Wallet"
-    to="#tempo-wallet"
-    icon="lucide:wallet"
-  />
-  <Card
-    title="Testnet Funds"
-    description="Get test stablecoins from the faucet for development and testing."
-    to="#testnet-funds"
-    icon="lucide:flask-conical"
-  />
-</Cards>
-
-## Bridge
-
-Use one of these supported bridges to move assets to Tempo:
-
-- **[LayerZero](https://layerzero.network/)**: Bridge supported assets from other chains to Tempo.
-- **[Squid](https://app.squidrouter.com/)**: Swap and bridge assets to Tempo in one flow.
-- **[Relay](https://relay.link/)**: Bridge assets to Tempo with low fees.
-
 ## Tempo Wallet
 
-[Tempo Wallet](https://wallet.tempo.xyz) is Tempo's web-based passkey wallet. You can add funds directly in the app.
+[Tempo Wallet](https://wallet.tempo.xyz) is Tempo's web-based passkey wallet. You can onramp with fiat or bridge from other chains directly in the app.
 
 ### In Tempo Wallet
 
@@ -51,7 +18,14 @@ Use one of these supported bridges to move assets to Tempo:
 
 ### With the CLI
 
-Fund your wallet from the terminal using the [Tempo CLI](/cli):
+Install the [Tempo CLI](/cli/wallet) and log in to your wallet:
+
+```bash
+curl -fsSL https://tempo.xyz/install | bash
+tempo wallet login
+```
+
+Then fund your wallet:
 
 ```bash
 tempo wallet fund
@@ -61,9 +35,25 @@ tempo wallet fund
 
 Paste this into your agent to set up Tempo Wallet and add funds:
 
+:::code-group
+```bash [Claude Code]
+claude -p "Read https://tempo.xyz/SKILL.md and fund my Tempo Wallet"
+```
+```bash [Amp]
+amp --execute "Read https://tempo.xyz/SKILL.md and fund my Tempo Wallet"
 ```
-Read https://wallet.tempo.xyz/SKILL.md and fund my Tempo Wallet
+```bash [Codex CLI]
+codex exec "Read https://tempo.xyz/SKILL.md and fund my Tempo Wallet"
 ```
+:::
+
+## Bridge
+
+Use one of these supported bridges to move assets to Tempo:
+
+- **[LayerZero](https://layerzero.network/)**: Bridge supported assets from other chains to Tempo.
+- **[Squid](/ecosystem/bridges#squid)**: Swap and bridge assets to Tempo in one flow.
+- **[Relay](/ecosystem/bridges#relay)**: Bridge assets to Tempo with low fees.
 
 ## Testnet Funds
 

diff --git a/src/pages/guide/machine-payments/agent.mdx b/src/pages/guide/machine-payments/agent.mdx
@@ -0,0 +1,103 @@
+---
+title: Agent Quickstart
+description: Use the tempo CLI to discover services, preview costs, and make paid requests from a terminal or AI agent — no SDK required.
+---
+
+import { Card, Cards } from 'vocs'
+
+# Agent quickstart
+
+The `tempo` CLI handles `402 Payment Required` responses the same way the client SDK does — but from a terminal, script, or AI agent, with zero integration code.
+
+::::steps
+
+### Install the CLI
+
+```bash
+curl -fsSL https://tempo.xyz/install | bash
+```
+
+### Log in
+
+```bash
+tempo wallet login
+tempo wallet whoami
+```
+
+`login` opens a browser flow that creates or connects a Tempo wallet. `whoami` confirms readiness and prints your address and balances.
+
+:::tip
+If your balance is zero, run `tempo wallet fund` before making requests.
+:::
+
+### Discover services
+
+```bash
+tempo wallet services --search ai
+tempo wallet services <SERVICE_ID>
+```
+
+The service directory shows endpoint URLs, HTTP methods, pricing, and request schemas — everything you need to construct a valid request.
+
+### Preview cost
+
+```bash
+tempo request --dry-run -X POST \
+  --json '{"prompt":"a sunset over the ocean"}' \
+  https://fal.mpp.tempo.xyz/fal-ai/flux/dev
+```
+
+`--dry-run` validates the request and shows the payment cost without spending.
+
+### Make a paid request
+
+```bash
+tempo request -X POST \
+  --json '{"prompt":"a sunset over the ocean"}' \
+  https://fal.mpp.tempo.xyz/fal-ai/flux/dev
+```
+
+`tempo request` sends the request, intercepts the `402` challenge, signs and submits the payment, and retries with the credential — all in one command.
+
+::::
+
+## Set up an AI agent
+
+Paste this into your agent to install Tempo's wallet and request skills:
+
+:::code-group
+```txt [Claude Code]
+Read https://tempo.xyz/SKILL.md and set up tempo
+```
+```txt [Amp]
+Read https://tempo.xyz/SKILL.md and set up tempo
+```
+```txt [Codex]
+Read https://tempo.xyz/SKILL.md and set up tempo
+```
+:::
+
+Once installed, the agent can discover services, preview costs, and make paid requests within scoped spending limits.
+
+## Next steps
+
+<Cards>
+  <Card
+    icon="lucide:server"
+    title="Server quickstart"
+    description="Add payment gating to your HTTP endpoints"
+    to="/guide/machine-payments/server"
+  />
+  <Card
+    icon="lucide:wallet"
+    title="CLI reference"
+    description="Complete tempo wallet and tempo request command reference"
+    to="/cli/wallet"
+  />
+  <Card
+    icon="lucide:credit-card"
+    title="Accept one-time payments"
+    description="Charge per request with on-chain settlement"
+    to="/guide/machine-payments/one-time-payments"
+  />
+</Cards>
diff --git a/src/pages/guide/machine-payments/index.mdx b/src/pages/guide/machine-payments/index.mdx
@@ -76,6 +76,12 @@ Two [intents](https://mpp.dev/protocol#payment-intents) are available on Tempo:
     description="Handle payment-gated resources automatically"
     to="/guide/machine-payments/client"
   />
+  <Card
+    icon="lucide:bot"
+    title="Agent quickstart"
+    description="Discover services and make paid requests from a terminal or AI agent"
+    to="/guide/machine-payments/agent"
+  />
   <Card
     icon="lucide:server"
     title="Server quickstart"