@codespar/mcp-moonpay

MCP server for MoonPay — fiat-to-crypto on/off-ramp.

MoonPay spans 100+ crypto assets and many geographies, with both buy (fiat → crypto) and sell (crypto → fiat) flows. Pix is supported as a Brazil onramp rail.

Positioning vs the rest of the catalog

| Server | Coverage | Direction | |--------|----------|-----------| | @codespar/mcp-unblockpay | BRL / MXN ↔ USDC | Onramp + offramp, stablecoin only | | @codespar/mcp-moonpay | 100+ crypto assets, multi-geo, Pix for BR | Onramp + offramp | | @codespar/mcp-mercado-bitcoin, @codespar/mcp-bitso | Exchange order books | Trade | | @codespar/mcp-circle | USDC native rails | Stablecoin infra |

Use MoonPay when an agent needs broader crypto coverage (beyond USDC), longer-tail geographies, or a sell-side flow that pays out to local fiat.

Tools (20)

| Tool | Purpose | |---|---| | get_buy_quote | Preview a fiat -> crypto buy quote in real time. | | create_buy_transaction | Create a buy transaction (fiat -> crypto). | | get_buy_transaction | Retrieve a buy transaction (fiat -> crypto) by its MoonPay id. | | list_buy_transactions | List buy transactions with optional filters. | | get_sell_quote | Preview a crypto -> fiat sell quote in real time. | | create_sell_transaction | Create a sell transaction (crypto -> fiat). | | get_sell_transaction | Retrieve a sell transaction (crypto -> fiat) by its MoonPay id. | | refund_sell_transaction | Request a refund on an off-ramp (sell) transaction. | | create_customer | Create a MoonPay customer (KYC'd end user). | | get_customer | Retrieve a MoonPay customer by id. | | get_customer_kyc_status | Fetch KYC verification status (and any pending document requirements) for a MoonPay customer. | | list_customer_transactions | List all transactions (buy + sell) tied to a single MoonPay customer. | | get_transaction_receipt | Fetch a tax-/audit-grade receipt for a completed buy or sell transaction. | | list_currencies | List supported currencies (fiat + crypto). | | get_currency | Retrieve metadata for a single currency (fiat or crypto) by its MoonPay code. | | list_countries | List countries supported by MoonPay along with which flows (buy / sell / NFT) are allowed per geography. | | list_payment_methods | List payment methods supported for a given fiat currency / country combination (e.g. | | get_user_country | Resolve the caller's (or a given IP's) country via MoonPay's IP-address geolocation endpoint. | | sign_buy_url | Build and HMAC-SHA256 sign a MoonPay buy widget URL (buy.moonpay.com). | | sign_sell_url | Build and HMAC-SHA256 sign a MoonPay sell widget URL (sell.moonpay.com). |

Install

npm install @codespar/mcp-moonpay

Environment

MOONPAY_API_KEY="..."     # API key (sandbox or production — the key selects the environment)
MOONPAY_BASE_URL="..."    # Optional. Defaults to https://api.moonpay.com.

Authentication

Every request uses a simple header:

Authorization: Api-Key <MOONPAY_API_KEY>

Sandbox vs production is selected by the key itself — the base URL stays the same.

Run

# stdio (default — for Claude Desktop, Cursor, etc)
npx @codespar/mcp-moonpay

# HTTP (for server-to-server testing)
MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-moonpay

License

MIT