Moonpay

MoonPay CLI

Your agent needs money. Give your agents crypto.

MoonPay is the crypto onramp for AI agents — non-custodial wallets, swaps, bridges, transfers, DCA, limit orders, deposits, market data, and fiat on/off ramps. One CLI for everything.

Base URL: https://agents.moonpay.com

What is MoonPay CLI?

MoonPay CLI gives AI agents and humans full access to crypto:

• Non-custodial — Local wallets with OS keychain encryption. Keys never leave the machine.
• Multi-chain — Solana, Ethereum, Base, Polygon, Arbitrum, Optimism, BNB, Avalanche, TRON, Bitcoin
• Multi-surface — MoonPay CLI (mp), local MCP server (mp mcp), web chat
• Trading — Swap, bridge, transfer, DCA, limit orders, stop losses
• Market intelligence — Trending tokens, token analysis, price data, price alerts
• Deposits — Multi-chain deposit links with automatic stablecoin conversion
• Fiat on/off-ramp — Buy crypto with fiat (USD), virtual accounts with KYC
• Deposits — Multi-chain deposit links with automatic stablecoin conversion

Quick Start

Option A: CLI (Recommended)

# Install
npm install -g @moonpay/cli

# Login (opens browser for captcha verification)
mp login --email you@example.com
# Open the URL, solve captcha, get code from email
mp verify --email you@example.com --code 123456

# Create a wallet
mp wallet create --name main

# List tools
mp tools

# Search for a token
mp token search --query "SOL" --chain solana --limit 5

# Check balances
mp token balance list --wallet main --chain solana

Option B: MCP Server (Local)

Run mp mcp to start a local MCP server over stdio. This exposes all CLI + remote tools to any MCP-compatible client (Claude Desktop, Cursor, Claude Code).

{
  "mcpServers": {
    "moonpay": {
      "command": "mp",
      "args": ["mcp"]
    }
  }
}

Option C: REST API

curl -X POST https://agents.moonpay.com/api/tools/token_search \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query": "SOL", "chain": "solana", "limit": 5}'

Authentication

CLI: Run mp login --email you@example.com to open a browser page with hCaptcha. After solving the captcha, a verification code is sent to your email. Run mp verify --email you@example.com --code 123456. Credentials are stored encrypted at ~/.config/moonpay/credentials.json and auto-refresh. Run mp logout to clear stored credentials.

REST API: Use a Bearer token in the Authorization header. Obtain tokens via the login/verify flow or OAuth 2.0 with PKCE.

Rate limits: 5 requests/min (anonymous), 60 requests/min (authenticated).

Terms of Use: https://www.moonpay.com/legal/terms_of_use_europe_hypermint

Core Tools

Wallet Management

Wallets are HD (BIP39) — one mnemonic derives addresses for all chains. EVM wallets share a single address across Ethereum, Base, Polygon, Arbitrum, Optimism, BNB, and Avalanche.

mp wallet create --name main          # Create HD wallet (Solana + EVM + Bitcoin + TRON)
mp wallet import --name funded        # Import from mnemonic or private key (interactive)
mp wallet list                         # List all wallets (shows all chain addresses)
mp wallet retrieve --wallet main       # Get wallet details
mp wallet rename --wallet old --name new  # Rename a wallet
mp wallet export --wallet main         # Export mnemonic (interactive only)
mp wallet delete --wallet old          # Permanently delete a wallet

Token Trading

Swaps, bridges, and transfers sign locally — keys never leave the machine.

# Swap (same chain)
mp token swap \
  --wallet main --chain solana \
  --from-token EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v \
  --from-amount 5 \
  --to-token So11111111111111111111111111111111111111111

# Bridge (cross chain)
mp token bridge \
  --from-wallet main --from-chain polygon \
  --from-token 0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174 \
  --from-amount 6 \
  --to-chain solana \
  --to-token EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v \
  --to-wallet <solana-address>

# Transfer
mp token transfer \
  --wallet main --chain solana \
  --token EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v \
  --amount 10 \
  --to <recipient-address>

Market Data

# Search tokens
mp token search --query "BONK" --chain solana --limit 5

# Token details + market data
mp token retrieve --token <address> --chain solana

# Trending tokens
mp token trending list --chain solana --limit 10 --page 1

# Check balances
mp token balance list --wallet <address> --chain solana

Fiat On-Ramp

# Buy crypto with fiat (amount in USD, returns checkout URL)
mp buy --token sol --amount 50 --wallet <address> --email <email>

# Virtual account (KYC-based fiat on-ramp)
mp virtual-account create
mp virtual-account wallet register --wallet main --chain solana
mp virtual-account onramp create --name "USD to USDC" --fiat USD --chain solana --stablecoin USDC

Deposits

# Create a multi-chain deposit link
mp deposit create --name "My Deposit" --wallet <address> --chain solana --token USDC

# Check deposit details
mp deposit retrieve --id <deposit-id>

# List deposit transactions
mp deposit transaction list --id <deposit-id>

Signing

# Sign a message
mp message sign --wallet main --chain solana --message "hello"

# Sign a transaction
mp transaction sign --wallet main --chain solana --transaction <base64>

# Send a signed transaction
mp transaction send --chain solana --transaction <signed-base64>

Safety Rules

CLI tools (mp token swap, mp token bridge, mp token transfer) handle the full build, sign, broadcast flow automatically. Keys are signed locally and never sent to the server.

For server-side tools (REST API / MCP), use the simulate-then-execute pattern:

1. Always simulate first — call with "simulation": true to get a quote
2. Show the quote — display expected output, fees, slippage
3. Get explicit confirmation — never auto-execute without user approval
4. Execute — call with "simulation": false only after confirmation

CLI Tools by Category

Auth

Wallet

Token Trading

Market Data

Transactions

Fiat

Deposits

x402

Skills

Feedback

x402 Rate Limit Upgrade

Pay to increase your API rate limit via the x402 protocol.

Endpoint: POST https://agents.moonpay.com/x402/upgrade

# With CLI (handles payment automatically)
mp upgrade --duration day --wallet main --chain solana

Payment: USDC via x402 on Solana or Base. Requires login. Payment is only settled on success.

Pre-Built Skills

Install AI skills for Claude Code:

mp skill install

Supported Chains

Tips for Agents

• Resolve token addresses first — call token search before trading if you only have a name/symbol
• Check balances — use token balance list before trading to confirm available amounts
• Native token addresses — Solana: So11111111111111111111111111111111111111111, EVM: 0x0000000000000000000000000000000000000000
• EVM wallets share one address across Ethereum, Base, Polygon, Arbitrum, Optimism, BNB, Avalanche
• CLI signs locally — mp token swap, mp token bridge, mp token transfer handle the full flow (build → sign → broadcast)
• Use -f compact when piping CLI output to jq for scripting

Links

• Web App: https://agents.moonpay.com
• CLI: npm install -g @moonpay/cli
• MCP Server: mp mcp (local, stdio)
• Skills: mp skill install