docs: add Use Tempo how-to guides

src/pages/docs/guide/getting-funds.mdx

@@ -1,7 +1,7 @@
 ---
 title: "Fund an account"
 seoTitle: "Fund a Tempo account | Tempo Docs"
-description: Get testnet stablecoins, use the Tempo Wallet fiat onramp, or add wallet funding and cross-network deposits to your app.
+description: Get testnet stablecoins, deposit into Tempo Wallet from other chains, or add wallet funding and cross-network deposits to your app.
 interactive: true
 ogImage: /og/2026-q4/og_2026-q4_docs_guide-getting-funds_title-f5_v02.png
 ---
@@ -25,7 +25,7 @@ Choose a funding path for the network and integration you are building. Tempo Wa
 
 ## Add money with Tempo Wallet
 
-[Tempo Wallet](https://wallet.tempo.xyz) includes a fiat onramp and funding from other chains. Connect below, select **Add funds**, and choose a funding method in the wallet. The wallet shows the available methods, amount, and any fees before you confirm.
+[Tempo Wallet](https://wallet.tempo.xyz) takes deposits from other chains, such as Base, Ethereum, and Solana. Connect below, select **Add funds**, and choose a funding method in the wallet. The wallet shows the available methods, amount, and any fees before you confirm.
 
 This demo opens the funding flow for **Tempo Mainnet**, using real funds. For test tokens, use the [Moderato faucet](/docs/quickstart/faucet).
 

src/pages/docs/resources/guides/add-tempo-to-metamask.mdx

@@ -0,0 +1,68 @@
+---
+title: Add Tempo to MetaMask
+seoTitle: How to Add Tempo Network to MetaMask (Chain ID 4217) | Tempo Docs
+description: Add Tempo mainnet to MetaMask, Rabby, or another EVM wallet with chain ID 4217 and the official RPC, then see stablecoin balances and pay fees in stablecoins.
+interactive: true
+mipd: true
+---
+
+import { Card, Cards } from 'vocs'
+import { ConnectWallet } from '../../../../components/ConnectWallet.tsx'
+
+[Guides](/docs/resources/guides) / [Use Tempo](/docs/resources/guides#use-tempo) / Add Tempo to MetaMask
+
+# Add Tempo to MetaMask
+
+Add Tempo mainnet to MetaMask or any EVM wallet in under a minute.
+
+## Overview
+
+Tempo works with EVM wallets, such as MetaMask, Rabby, and Ledger. Your wallet's address is the same on Tempo as on Ethereum. Some wallets, such as Gem Wallet and OKX Wallet, support Tempo already.
+
+## Add Tempo automatically
+
+Connect your browser wallet and approve the network request.
+
+<ConnectWallet network="mainnet" />
+
+## Add Tempo manually
+
+:::::steps
+
+### Open the network settings
+
+In MetaMask, open the network menu and select **Add a custom network**. In Rabby or another wallet, add a custom network from its settings.
+
+### Enter the network details
+
+| Field | Value |
+| --- | --- |
+| Network name | Tempo Mainnet |
+| RPC URL | `https://rpc.tempo.xyz` |
+| Chain ID | `4217` |
+| Currency symbol | `USD` |
+| Block explorer URL | `https://explore.tempo.xyz` |
+
+### Save and switch
+
+Save the network and switch to it.
+
+:::::
+
+For the testnet, use chain ID `42431`, RPC URL `https://rpc.moderato.tempo.xyz`, and explorer `https://explore.testnet.tempo.xyz`.
+
+## Show your stablecoins
+
+Tempo has no native token, so your wallet's native balance is a placeholder. Ignore the large `USD` number it shows. Import each stablecoin you hold by its address from the [token list](/docs/quickstart/tokenlist), such as OUSD or USDC.e.
+
+## Pay fees
+
+Each transaction pays its network fee in a stablecoin. You don't need ETH or any other token. By default, a transfer pays its fee in the stablecoin it sends. Most other transactions fall back to pathUSD. [Pay fees in stablecoins](/docs/resources/guides/pay-network-fees-in-stablecoins) explains the rules.
+
+## Related
+
+<Cards>
+  <Card title="Get stablecoins on Tempo" description="Fund your new Tempo address." to="/docs/resources/guides/get-stablecoins-on-tempo" />
+  <Card title="Pay fees in stablecoins" description="How Tempo charges network fees without a gas token." to="/docs/resources/guides/pay-network-fees-in-stablecoins" />
+  <Card title="Add Tempo to your wallet" description="For wallet teams adding Tempo support." to="/docs/accounts/wallets/add-tempo-to-your-wallet" />
+</Cards>

src/pages/docs/resources/guides/connect-tempo-wallet-to-an-app.mdx

@@ -0,0 +1,73 @@
+---
+title: Connect Tempo Wallet to an app
+seoTitle: How to Connect Tempo Wallet to an App or AI Agent | Tempo Docs
+description: Sign in to an app with Tempo Wallet, connect Claude Code, Codex, Amp, or Cursor to your wallet, and disconnect apps you no longer use.
+---
+
+import { Card, Cards } from 'vocs'
+
+[Guides](/docs/resources/guides) / [Use Tempo](/docs/resources/guides#use-tempo) / Connect Tempo Wallet to an app
+
+# Connect Tempo Wallet to an app
+
+Sign in to apps and agents with your Tempo Wallet, then disconnect them when you're done.
+
+## Overview
+
+[Tempo Wallet](https://wallet.tempo.xyz) is a web wallet you open with your email or a passkey. An app connects to it through a **Sign in with Tempo** window. If the app wants to pay from your account, you approve a spending limit first.
+
+## Connect to an app
+
+:::::steps
+
+### Select Sign in with Tempo
+
+In the app, select **Sign in with Tempo**. A Tempo Wallet window opens.
+
+### Sign in
+
+Enter your email and the 6-digit code it receives, or select **Continue with passkey**. A new email creates a wallet.
+
+### Review the request
+
+If the app asks to spend, the window says it will be authorized to spend from your account. It lists the spending limit, network fees, and expiry. Select **Approve** to connect, or **Reject**.
+
+:::::
+
+[Set a spending limit](/docs/resources/guides/set-an-agent-spending-limit) explains each line on the approval screen.
+
+## Connect an AI agent
+
+:::::steps
+
+### Open Agent payments
+
+In Tempo Wallet, open the account menu and select **Agent payments**.
+
+### Copy the command
+
+Choose your agent: Claude, Codex, Amp, OpenCode, or Cursor. Copy the command and run it in the agent. For Claude Code:
+
+```bash
+claude "Read https://tempo.xyz/SKILL.md and connect to my Tempo wallet"
+```
+
+### Approve in the browser
+
+The agent opens Tempo Wallet. Check that the device code matches your terminal, then approve the spending limit.
+
+:::::
+
+From a terminal, `tempo wallet login` starts the same flow. The [`tempo wallet` reference](/docs/cli/wallet) lists its other commands.
+
+## Disconnect an app
+
+Sign in to Tempo Wallet with your passkey, then open [wallet.tempo.xyz/apps](https://wallet.tempo.xyz/apps). It lists connected apps and CLI keys with their spending limits. Select **Disconnect** on an app to revoke its keys. Revoked keys can't spend.
+
+## Related
+
+<Cards>
+  <Card title="Set a spending limit" description="Choose how much an agent can spend and for how long." to="/docs/resources/guides/set-an-agent-spending-limit" />
+  <Card title="Get stablecoins on Tempo" description="Add money to your wallet before you connect." to="/docs/resources/guides/get-stablecoins-on-tempo" />
+  <Card title="Give an agent a wallet" description="For developers building agent payments." to="/docs/accounts/automations/give-an-agent-a-wallet" />
+</Cards>

src/pages/docs/resources/guides/get-stablecoins-on-tempo.mdx

@@ -0,0 +1,88 @@
+---
+title: Get stablecoins on Tempo
+seoTitle: How to Get USDC and Stablecoins on Tempo | Tempo Docs
+description: Deposit USDC, USDT, or ETH from Base, Ethereum, Arbitrum, Solana, and other chains into Tempo Wallet, withdraw from Coinbase or Kraken on Tempo, or bridge.
+---
+
+import { Card, Cards } from 'vocs'
+
+[Guides](/docs/resources/guides) / [Use Tempo](/docs/resources/guides#use-tempo) / Get stablecoins on Tempo
+
+# Get stablecoins on Tempo
+
+Move stablecoins onto Tempo from another chain, an exchange, or another Tempo account.
+
+## Overview
+
+Tempo has no native token. Your balance is held in stablecoins, such as OUSD, USDC.e, and USDT0. Anyone can send stablecoins to a Tempo address, with nothing to set up first.
+
+Pick a path by where your money is now:
+
+- **On another chain.** Deposit it into [Tempo Wallet](https://wallet.tempo.xyz), or use a bridge.
+- **On an exchange.** Withdraw it and choose Tempo as the network.
+- **In another Tempo account.** Share your address and receive it.
+
+## Deposit from another chain
+
+Tempo Wallet gives you a deposit address on the chain your funds are on. It converts what you send and adds OUSD to your Tempo balance.
+
+:::::steps
+
+### Open the deposit screen
+
+Sign in at [wallet.tempo.xyz](https://wallet.tempo.xyz) with your email or a passkey. A new email creates a wallet. Select **Deposit**, then **Deposit crypto**.
+
+### Choose the network and token
+
+Pick the **Network** and **Token** you're sending from.
+
+| Network | Tokens |
+| --- | --- |
+| Base | USDC, OUSD, ETH, WETH, cbBTC, SOL, WBTC |
+| Ethereum | USDC, USDT, OUSD, ETH, WETH, WBTC |
+| Arbitrum | USDC, USDT, ETH |
+| Optimism | USDC, USDT, ETH, WETH |
+| Solana | USDC, SOL |
+| Unichain | USDC, ETH |
+| Abstract | USDC, ETH |
+
+### Send to the deposit address
+
+Copy the **Deposit address** or scan its QR code. Send only the token and network you selected. Select **Done**. The wallet shows **Deposit complete** when the OUSD arrives.
+
+:::::
+
+Deposits from other chains go to Tempo mainnet only. [Relay](/docs/guide/bridge-relay) routes them.
+
+<span id="withdraw-from-an-exchange" />
+
+## Withdraw from an exchange
+
+Some exchanges send stablecoins on Tempo directly:
+
+- **Coinbase.** Select Tempo as the network when you send a supported stablecoin.
+- **Kraken.** Withdraw USDT0 on Tempo.
+
+Paste your Tempo address as the destination. Check that the exchange shows Tempo as the network before you confirm.
+
+## Bridge from another chain
+
+A bridge moves stablecoins from another chain to any Tempo address, including one in MetaMask or Rabby. To use [Relay](https://relay.link/bridge), choose your source chain and token, then set **Tempo** as the destination.
+
+Other bridges, such as LayerZero, Bungee, and Across, are in the [bridge directory](/docs/partners/bridges).
+
+## Receive from another Tempo account
+
+In Tempo Wallet, select **Receive**, then copy your **Wallet address** or show its QR code. Only send supported stablecoins on Tempo to it.
+
+## Get test stablecoins
+
+The [Moderato testnet faucet](/docs/quickstart/faucet) gives you free test stablecoins. They have no value and work only on testnet.
+
+## Related
+
+<Cards>
+  <Card title="Add Tempo to MetaMask" description="Use Tempo in a wallet you already have." to="/docs/resources/guides/add-tempo-to-metamask" />
+  <Card title="Move funds off Tempo" description="Send stablecoins to an exchange, another chain, or a bank." to="/docs/resources/guides/move-funds-off-tempo" />
+  <Card title="Fund an account" description="Add funding and deposits to your own app." to="/docs/guide/getting-funds" />
+</Cards>

src/pages/docs/resources/guides/index.mdx

@@ -12,6 +12,15 @@ Choose the task your application needs to complete. Each guide explains the work
 
 For a first test payment, use the [quickstart](/get-started/quickstart). [Partners](/docs/partners) lists the third-party providers these guides mention, such as wallet, funding, and RPC providers.
 
+## Use Tempo
+
+- [Get stablecoins on Tempo](/docs/resources/guides/get-stablecoins-on-tempo)
+- [Add Tempo to MetaMask](/docs/resources/guides/add-tempo-to-metamask)
+- [Connect Tempo Wallet to an app](/docs/resources/guides/connect-tempo-wallet-to-an-app)
+- [Set an agent spending limit](/docs/resources/guides/set-an-agent-spending-limit)
+- [Pay fees in stablecoins](/docs/resources/guides/pay-network-fees-in-stablecoins)
+- [Move funds off Tempo](/docs/resources/guides/move-funds-off-tempo)
+
 ## Payment infrastructure
 
 - [Blockchain payment flows](/docs/resources/guides/blockchain-payments)

src/pages/docs/resources/guides/move-funds-off-tempo.mdx

@@ -0,0 +1,53 @@
+---
+title: Move funds off Tempo
+seoTitle: How to Withdraw From Tempo to a Bank or Another Chain | Tempo Docs
+description: Cash out stablecoins from Tempo through Coinbase or Kraken, bridge them to Base, Ethereum, or Solana, or send them to another wallet.
+---
+
+import { Card, Cards } from 'vocs'
+
+[Guides](/docs/resources/guides) / [Use Tempo](/docs/resources/guides#use-tempo) / Move funds off Tempo
+
+# Move funds off Tempo
+
+Send stablecoins from Tempo to an exchange, another chain, or another wallet.
+
+## Overview
+
+Tempo Wallet doesn't withdraw to a bank account. To cash out, send stablecoins to an exchange or ramp that supports Tempo, then withdraw to your bank there. To use them on another chain, bridge them.
+
+## Cash out through an exchange
+
+:::::steps
+
+### Get a Tempo deposit address
+
+In Coinbase, receive a supported stablecoin and choose Tempo as the network. Kraken accepts USDT0 deposits on Tempo.
+
+### Send from Tempo Wallet
+
+In Tempo Wallet, select **Send**. Paste the exchange's address as the **Recipient**, choose the stablecoin, and enter the amount. Add a **Note** if the exchange asks for a memo. Select **Send**.
+
+### Withdraw to your bank
+
+When the deposit arrives, sell or withdraw it to your bank on the exchange.
+
+:::::
+
+Send only stablecoins the exchange supports on Tempo. Stablecoins sent on the wrong network or in an unsupported token can be lost.
+
+## Bridge to another chain
+
+A bridge moves stablecoins from Tempo to chains such as Base, Ethereum, Arbitrum, and Solana. To use [Relay](https://relay.link/bridge), connect a wallet that holds your Tempo address, such as MetaMask or Rabby. Choose **Tempo** as the source chain and pick the destination. Other bridges are in the [bridge directory](/docs/partners/bridges).
+
+## Use a wallet with a built-in off-ramp
+
+Some wallets that support Tempo sell stablecoins for local currency. [Bridge Wallet by Mt Pelerin](https://www.mtpelerin.com/bridge-wallet) supports cashing out supported assets. Send your stablecoins to its Tempo address first.
+
+## Related
+
+<Cards>
+  <Card title="Get stablecoins on Tempo" description="Move money onto Tempo." to="/docs/resources/guides/get-stablecoins-on-tempo" />
+  <Card title="Bridging with Relay" description="Bridge with the Relay API or app." to="/docs/guide/bridge-relay" />
+  <Card title="Payments and ramps" description="Fiat ramp providers for apps." to="/docs/partners/payments-and-ramps" />
+</Cards>

src/pages/docs/resources/guides/pay-network-fees-in-stablecoins.mdx

@@ -0,0 +1,49 @@
+---
+title: Pay fees in stablecoins
+seoTitle: How to Pay Gas Fees on Tempo Without a Native Token | Tempo Docs
+description: Tempo charges network fees in USD stablecoins, not a gas token. See which stablecoin pays, why a transaction fails for fees, and how sponsored fees work.
+---
+
+import { Card, Cards } from 'vocs'
+
+[Guides](/docs/resources/guides) / [Use Tempo](/docs/resources/guides#use-tempo) / Pay fees in stablecoins
+
+# Pay fees in stablecoins
+
+Tempo has no gas token. Every network fee is paid in a USD stablecoin.
+
+## Overview
+
+A network fee is what a transaction pays to be included in a block. On Tempo, it's priced in USD and paid in a USD stablecoin you already hold, such as OUSD, USDC.e, or USDT0. You never need to buy ETH or another token to pay it.
+
+## Which stablecoin pays
+
+Tempo picks the fee token in this order:
+
+1. **Your choice for the transaction.** Some apps let you pick it.
+2. **Your account's default.** You set it once.
+3. **The stablecoin you send.** A transfer of USDC.e pays its fee in USDC.e.
+4. **The stablecoin you swap from.** This applies to a single swap.
+5. **pathUSD.** The fallback for every other transaction.
+
+When an app or fee payer covers the fee, its own default applies instead of yours. The fee token must be a USD stablecoin. Tempo rejects a transaction when your account can't cover the maximum fee in that token. It doesn't try another token.
+
+## Fees in Tempo Wallet
+
+Tempo Wallet picks the fee token for you. Each review screen shows a **Fee** row in USD. When an app or Tempo covers the fee, the row says **Sponsored**, and you pay nothing.
+
+## Fees in MetaMask and other wallets
+
+Standard wallets follow the same order. Keep a small balance of the stablecoin you send. Wallets show a large placeholder in place of a native balance. It isn't money you hold.
+
+## When a transaction fails for fees
+
+Check that you hold enough of the fee token. If the fee falls back to pathUSD and you hold none, swap a little into pathUSD. In Tempo Wallet, select **Swap**. Or [set a default fee token](/docs/accounts/fees/fee-tokens#set-a-default-fee-token) you hold.
+
+## Related
+
+<Cards>
+  <Card title="Fee Tokens" description="Set and override an account's fee token in code." to="/docs/accounts/fees/fee-tokens" />
+  <Card title="Fee Sponsorship" description="Pay your users' fees from your app." to="/docs/accounts/fees/fee-sponsorship" />
+  <Card title="Add Tempo to MetaMask" description="Use Tempo in a wallet you already have." to="/docs/resources/guides/add-tempo-to-metamask" />
+</Cards>