Moonpay Auth

MoonPay auth and setup

Install

npm i -g @moonpay/cli

This installs the mp (and moonpay) binary globally.

Verify installation

mp --version
mp --help

Auth commands

# Log in (sends OTP to email)
mp login --email user@example.com

# Verify OTP code
mp verify --email user@example.com --code 123456

# Check current user
mp user retrieve

# Log out
mp logout

Local wallet management

The CLI manages local wallets stored encrypted in ~/.config/moonpay/wallets.json. Private keys are encrypted with AES-256-GCM using a random key stored in your OS keychain. No password required — keys never leave the machine.

# Create a new HD wallet (Solana, Ethereum, Bitcoin, Tron)
mp wallet create --name "my-wallet"

# Import from a mnemonic (all chains)
mp wallet import --name "restored" --mnemonic "word1 word2 ..."

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

# List all local wallets
mp wallet list

# Get wallet details (by name or address)
mp wallet retrieve --wallet "my-wallet"

# Export mnemonic/key (interactive only — agents cannot run this)
mp wallet export --wallet "my-wallet"

# Delete a wallet (irreversible)
mp wallet delete --wallet "my-wallet" --confirm

Workflow

1. Run mp user retrieve to check if authenticated.
2. If it fails, run mp login --email <email>, then mp verify --email <email> --code <code>.
3. Run mp wallet list to see local wallets.
4. If no wallets, create one: mp wallet create --name "default".

Autonomous login

Agents can log in without human intervention if they have access to the user's email. For example, with the gog CLI (Google Workspace):

# 1. Send OTP
mp login --email user@example.com

# 2. Read the OTP code from email
gog gmail search "Your MoonPay verification code" --max-results 1

# 3. Verify with the code
mp verify --email user@example.com --code <code>

This enables fully autonomous agent setup — no human in the loop.

Config locations

• Wallets: ~/.config/moonpay/wallets.json (encrypted, AES-256-GCM)
• Encryption key: OS keychain (moonpay-cli / encryption-key)
• Credentials: ~/.config/moonpay/credentials.json (encrypted, AES-256-GCM)
• Config: ~/.config/moonpay/config.json (base URL, client ID)

Security

• Wallet secrets are always encrypted on disk
• Encryption key is stored in macOS Keychain / Linux libsecret
• No password to remember — the OS handles authentication
• wallet export requires an interactive terminal (TTY) — agents and scripts cannot extract secrets
• 24-word BIP39 mnemonics (256-bit entropy)

Related skills

• moonpay-swap-tokens — Swap or bridge tokens using local wallets.
• moonpay-check-wallet — Check wallet balances.