MCP server for MoonPay, enabling fiat-to-crypto on/off-ramp functionality. It supports 100+ crypto assets and multiple geographies, with both buy (fiat → crypto) and sell (crypto → fiat) flows. Pix is supported as an onramp rail for Brazil.

🛠️ Key Features

MoonPay fiat-to-crypto on/off-ramp integration
100+ crypto assets
Multi-geo coverage
Buy (fiat → crypto) and sell (crypto → fiat)
Pix supported for Brazil onramp

🚀 Use Cases

Onramp users converting local fiat to crypto
Offramp users converting crypto back to fiat
Brazil-specific workflows using Pix as the onramp rail
Agentic commerce contexts involving payments and asset conversion

⚡ Developer Benefits

Tooling aligned with Model Context Protocol (MCP)
Topic coverage relevant to fintech, payments, open finance, and Latin America
References to use with LLM tools and AI agents

⚠️ Limitations

Provided description does not list exact supported fiat currencies or sell/off-ramp rails beyond Pix for Brazil onramp

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

Configuration

Environment variables

MOONPAY_API_KEYrequiredsecret

MoonPay REST API key (sandbox or production — the key selects the environment)

MOONPAY_PUBLISHABLE_KEY

MoonPay publishable key used as `apiKey` in signed widget URLs (required for sign_buy_url / sign_sell_url).

MOONPAY_SECRET_KEYsecret

MoonPay secret key used to HMAC-SHA256 sign widget URLs (required for sign_buy_url / sign_sell_url).

MOONPAY_BASE_URL

MoonPay API base URL. Defaults to https://api.moonpay.com.

MOONPAY_BUY_WIDGET_URL

MoonPay buy widget base URL. Defaults to https://buy.moonpay.com.

MOONPAY_SELL_WIDGET_URL

MoonPay sell widget base URL. Defaults to https://sell.moonpay.com.

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "mcp-moonpay": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-moonpay@0.2.2"
      ],
      "env": {
        "MOONPAY_API_KEY": "<YOUR_MOONPAY_API_KEY>",
        "MOONPAY_PUBLISHABLE_KEY": "<YOUR_MOONPAY_PUBLISHABLE_KEY>",
        "MOONPAY_SECRET_KEY": "<YOUR_MOONPAY_SECRET_KEY>",
        "MOONPAY_BASE_URL": "<YOUR_MOONPAY_BASE_URL>",
        "MOONPAY_BUY_WIDGET_URL": "<YOUR_MOONPAY_BUY_WIDGET_URL>",
        "MOONPAY_SELL_WIDGET_URL": "<YOUR_MOONPAY_SELL_WIDGET_URL>"
      }
    }
  }
}

io.github.codespar/mcp-moonpay

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

@codespar/mcp-moonpay

Positioning vs the rest of the catalog

Tools (20)

Install

Environment

Authentication

Run

Enterprise

License

Install

Configuration

Related servers