---

name: moonpay-auth description: Set up the MoonPay CLI on Zo, authenticate the current user, and create or inspect local wallets. Use when MoonPay commands fail because the user is not logged in, when a wallet is missing, or when a MoonPay flow needs login completed before continuing. compatibility: Created for Zo Computer metadata: author: Zo category: Official display-name: MoonPay Auth

MoonPay Auth

Set up MoonPay on Zo so later wallet, buy, swap, or virtual-account flows can run cleanly.

What Zo Uses

• Terminal for mp CLI commands
• Browser for any verification or continuation links
• Optional Gmail connection only if OTP retrieval is explicitly appropriate and available

Prerequisites

• Node.js and npm available on Zo
• A MoonPay account email address

Zo-Native Setup

1. Install the MoonPay CLI in the terminal:

npm i -g @moonpay/cli

2. Verify the install:

mp --version
mp --help

3. Check whether the user is already authenticated:

mp user retrieve

4. If not authenticated, start login:

mp login --email user@example.com

mp login generates a sign-in link and attempts to open it in a browser. On Zo, treat that as a Zo browser step, not a local-desktop browser step.

5. If MoonPay returns a sign-in link or asks for browser continuation, move the user to Zo browser and complete that step there.

6. Complete verification:

mp verify --email user@example.com --code 123456

7. Inspect available wallets:

mp wallet list

8. If no wallet exists, create one:

mp wallet create --name "default"

Wallet Operations

# Create a new wallet
mp wallet create --name "default"

# Import from mnemonic
mp wallet import --name "restored" --mnemonic "word1 word2 ..."

# Import from private key for a single chain
mp wallet import --name "imported" --key <hex-key> --chain ethereum

# List wallets
mp wallet list

# Retrieve one wallet
mp wallet retrieve --wallet "default"

Config and Storage Notes

• Wallets: ~/.config/moonpay/wallets.json
• Credentials: ~/.config/moonpay/credentials.json
• General config: ~/.config/moonpay/config.json

These are local to the Zo machine. Do not assume the user is on a desktop with local MoonPay state elsewhere.

Failure Handling

• If mp is missing, install it and verify again.
• If mp user retrieve fails, do not continue to buy, swap, or virtual-account flows until login is complete.
• If mp login produces a sign-in link or browser continuation step, move the user to Zo browser rather than describing local-browser steps.
• If the user has no wallet, create or import one before balance or swap flows.

Safety Notes

• Do not ask the user to paste private keys, mnemonics, or secrets into chat.
• mp wallet export is interactive and should not be used as part of a normal Zo agent flow.
• Only retrieve OTP codes from Gmail if the user has Gmail connected and the flow clearly requires it.

Related Skills

• moonpay-check-wallet
• moonpay-buy-crypto
• moonpay-swap-tokens
• moonpay-virtual-account