io.github.codespar/mcp-moonpay
io.github.codespar/mcp-moonpay · 273 stars · TypeScript · MIT
MCP server MCP server for MoonPay — fiat-to-crypto on/off-ramp, 100+ assets; Pix for Brazil onramp
Install
The repo has no one-line install. Follow its README.
Published as
- npm
@codespar/mcp-moonpaystdio
From the server's entry in the official MCP Registry.
Configuration
| Name | Set as | What it is |
|---|---|---|
MOONPAY_API_KEYRequired · Secret | Env var | MoonPay REST API key (sandbox or production — the key selects the environment) |
MOONPAY_PUBLISHABLE_KEYOptional | Env var | MoonPay publishable key used as `apiKey` in signed widget URLs (required for sign_buy_url / sign_sell_url). |
MOONPAY_SECRET_KEYOptional · Secret | Env var | MoonPay secret key used to HMAC-SHA256 sign widget URLs (required for sign_buy_url / sign_sell_url). |
MOONPAY_BASE_URLOptional | Env var | MoonPay API base URL. Defaults to https://api.moonpay.com. |
MOONPAY_BUY_WIDGET_URLOptional | Env var | MoonPay buy widget base URL. Defaults to https://buy.moonpay.com. |
MOONPAY_SELL_WIDGET_URLOptional | Env var | MoonPay sell widget base URL. Defaults to https://sell.moonpay.com. |
Files
@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
Enterprise
Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.
License
MIT
Facts
- Kind
- MCP server
- Group
- Uncategorized
- Stars
- 273
- License
- MIT
- Language
- TypeScript
- Last push
- 2026-09-27
- Forks
- 50
- MCP Registry
- io.github.codespar/mcp-moonpay
- Homepage
- codespar.dev/servers
- Topics
- agentic-commerce, ai-agents, brazil, claude, fintech, latin-america, llm-tools, mcp, model-context-protocol, nfe, open-finance, payments, pix
- 1REAio.github.morluto/reaReverse engineer anything from your terminal or agent with one CLI and MCP server.125.3k
- 2com.browser-use/browser-usecom.browser-use/browser-useControl a real Chrome browser to complete any task: fill forms, extract data, book flights.117.7k
- 3World Monitorapp.worldmonitor/mcpLive markets, conflicts, country risk, chokepoints, energy, and China decision signals. 93 tools.88.3k
- 4Scrapling MCP Serverd4vinci/scrapling🕷️ An adaptive Web Scraping framework that handles everything from a single request to a full-scale crawl! Don't be shy, join here: https://discord.gg/EMgGbDceNQ and follow here for daily tips and tricks: https://x.com/Scraplingdev86.9k
- 5Everythingmodelcontextprotocol/serversThis MCP server attempts to exercise all the features of the MCP protocol. It is not intended to be a useful server, but rather a test server for builders of MCP clients. It implements prompts, tools, resources, sampling, and more to showcase MCP capabilities.85.8k
- 6Fetchmodelcontextprotocol/serversA Model Context Protocol server that provides web content fetching capabilities. This server enables LLMs to retrieve and process content from web pages, converting HTML to markdown for easier consumption.85.8k