How do I install the Moonpay Auth skill?

Run npx skillmds@latest add luokai0/moonpay-auth in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Moonpay Auth safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: CAUTION, Skill Scanner: PASS. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Moonpay Auth?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Moonpay Auth free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Moonpay Auth?

luokai0 (@luokai0) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Moonpay Auth by luokai0 — Agent Skill

Name: Moonpay Auth
Rating: 4.5 (4 reviews)
Author: luokai0

Moonpay Auth

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.

luokai0 Updated Sep 8, 2026 10 repo stars

File contents

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

Install the MoonPay CLI in the terminal:

npm i -g @moonpay/cli

Verify the install:

mp --version
mp --help

Check whether the user is already authenticated:

mp user retrieve

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.

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

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

Inspect available wallets:

mp wallet list

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

---name: moonpay-authdescription: 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.---# MoonPay AuthSet up MoonPay on Zo so later wallet, buy, swap, or virtual-account flows can run cleanly.## What Zo Uses- [Terminal](/?t=terminal) for `mp` CLI commands- [Browser](/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 Setup1. Install the MoonPay CLI in the terminal:```bashnpm i -g @moonpay/cli```2. Verify the install:```bashmp --versionmp --help```3. Check whether the user is already authenticated:```bashmp user retrieve```4. If not authenticated, start login:```bashmp 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:```bashmp verify --email user@example.com --code 123456```7. Inspect available wallets:```bashmp wallet list```8. If no wallet exists, create one:```bashmp wallet create --name "default"```## Wallet Operations```bash# Create a new walletmp wallet create --name "default"# Import from mnemonicmp wallet import --name "restored" --mnemonic "word1 word2 ..."# Import from private key for a single chainmp wallet import --name "imported" --key <hex-key> --chain ethereum# List walletsmp wallet list# Retrieve one walletmp 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`

Frequently asked questions