About moonpay-mcp
moonpay-mcp explains how to configure the MoonPay CLI as an MCP server for Claude Desktop, Claude Code, and other compatible clients. It exposes wallet, token, fiat, x402 payment, and transaction tools through CLI credentials.
Key features
- 01Configure MoonPay CLI as an MCP server
- 02Provide wallet management tools
- 03Offer token search, swaps, bridges, and transfers
- 04Support fiat purchases and virtual accounts
- 05Expose x402 payment and transaction tools
Use cases
- 01Use MoonPay tools in Claude Desktop
- 02Perform wallet and token operations in Claude Code
- 03Handle transactions and payments from an MCP-compatible client
MCP support
Runs the MoonPay CLI as an MCP server and exposes all MoonPay CLI tools to compatible clients. It uses the same credentials as the CLI.
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ moonpay/ skills --skill moonpay-mcpAfter installing, type/moonpay-mcpin Claude Code to confirm it loaded.
Details
From the project READMEMoonPay MCP Setup
Goal
Configure the MoonPay CLI as an MCP server so Claude Desktop, Claude Code, or any MCP-compatible client can use all MoonPay tools directly.
Prerequisites
npm i -g @moonpay/cli
mp login --email [email protected]
mp verify --email [email protected] --code <code>
Claude Code setup
claude mcp add moonpay -- mp mcp
Claude Desktop setup
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"moonpay": {
"command": "mp",
"args": ["mcp"]
}
}
}
Then restart Claude Desktop.
What it provides
All MoonPay CLI tools are available as MCP tools:
- Wallet management — create, import, list, retrieve, delete, export wallets
- Token operations — search, retrieve, trending, swap, bridge, transfer
- Fiat — buy crypto with card/bank, virtual accounts with on-ramp
- x402 payments — paid API requests with automatic payment handling
- Transactions — sign locally, send, list, retrieve
Verification
After setup, ask Claude: "What MoonPay tools do you have?" — it should list all available tools.
Auth
The MCP server uses the same credentials as the CLI (~/.config/moonpay/credentials.json). Run mp login --email <email> then mp verify --email <email> --code <code> to authenticate.
Related skills
- moonpay-auth — Login and wallet setup.
- moonpay-discover-tokens — Search and analyze tokens.
- moonpay-swap-tokens — Swap tokens.