mcp-moonpay

Name: mcp-moonpay
Author: codespar

本地服务

github.com/codespar金融数据2754 周前更新

代码仓库

关于 mcp-moonpay

MCP 服务，用于接入 MoonPay 法币与加密货币互换服务，覆盖 100 多种加密资产和多个地区，并支持巴西 Pix 入金。适合需要买入、卖出加密资产或查询 KYC 状态的应用与 Agent。

主要功能

01实时买入与卖出报价
02买入与卖出交易的创建和查询
03客户 KYC 状态查询
04交易收据获取
05支持国家、货币与支付方式查询
06买入与卖出小组件 URL 签名

适用场景

01为 Agent 提供加密资产买入报价与下单
02查询终端用户的 KYC 进度与交易记录
03将加密资产卖出并结算为本地法币

MCP 相关

该项目是 MCP 服务，向 MCP 客户端暴露 20 个工具，用于调用 MoonPay API 处理买入、卖出、客户和货币相关操作。通过 MOONPAY_API_KEY 进行 Api-Key 认证。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "codespar-mcp-moonpay": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-moonpay"
      ],
      "env": {
        "MOONPAY_API_KEY": "<MOONPAY_API_KEY>",
        "MOONPAY_PUBLISHABLE_KEY": "<MOONPAY_PUBLISHABLE_KEY>",
        "MOONPAY_SECRET_KEY": "<MOONPAY_SECRET_KEY>",
        "MOONPAY_BASE_URL": "<MOONPAY_BASE_URL>",
        "MOONPAY_BUY_WIDGET_URL": "<MOONPAY_BUY_WIDGET_URL>",
        "MOONPAY_SELL_WIDGET_URL": "<MOONPAY_SELL_WIDGET_URL>"
      }
    }
  }
}

启动命令npx -y @codespar/mcp-moonpay

需要配置的环境变量

MOONPAY_API_KEY密钥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_KEY密钥MoonPay secret key used to HMAC-SHA256 sign widget URLs (required for sign_buy_url / sign_sell_url).

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

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

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

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@codespar/mcp-moonpay0.2.2stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
currencyCode	string	是	要购买的加密货币代码（例如 btc、eth、usdc、sol）。必须是 list_currencies 返回的代码。
paymentMethod	string	否	可选的支付方式提示（例如 credit_debit_card、sepa_bank_transfer、pix）
areFeesIncluded	boolean	否	若为 true，baseCurrencyAmount 将包含 MoonPay 手续费。
baseCurrencyCode	string	是	您用于支付的法定货币（例如 usd、eur、brl、mxn）
baseCurrencyAmount	number	否	要支出的法币金额（主要单位）。必须提供此项或 quoteCurrencyAmount。
quoteCurrencyAmount	number	否	要接收的加密货币数量（主单位）。必须提供此项或 baseCurrencyAmount。

详细介绍

@codespar/mcp-moonpay

MoonPay 的 MCP 服务 — 法币与加密货币之间的出入金通道。

MoonPay 覆盖 100 多种加密资产和许多地区，支持买入（法币 → 加密货币）和卖出（加密货币 → 法币）流程。支持通过 Pix 在巴西入金。

与目录中其他服务的定位

服务	覆盖范围	方向
`@codespar/mcp-unblockpay`	BRL / MXN ↔ USDC	入金 + 出金，仅支持稳定币
`@codespar/mcp-moonpay`	100 多种加密资产，覆盖多个地区，支持巴西的 Pix	入金 + 出金
`@codespar/mcp-mercado-bitcoin`、`@codespar/mcp-bitso`	交易所订单簿	交易
`@codespar/mcp-circle`	USDC 原生通道	稳定币基础设施

当 Agent 需要更广泛的加密货币覆盖范围（不仅限于 USDC）、覆盖更多小众地区，或需要将资金兑换为当地法币的卖出流程时，请使用 MoonPay。

工具（20）

工具	用途
`get_buy_quote`	实时预览法币买入加密货币的报价。
`create_buy_transaction`	创建买入交易（法币 -> 加密货币）。
`get_buy_transaction`	根据 MoonPay ID 检索买入交易（法币 -> 加密货币）。
`list_buy_transactions`	列出买入交易，支持可选筛选条件。
`get_sell_quote`	实时预览加密货币卖出为法币的报价。
`create_sell_transaction`	创建卖出交易（加密货币 -> 法币）。
`get_sell_transaction`	根据 MoonPay ID 检索卖出交易（加密货币 -> 法币）。
`refund_sell_transaction`	申请退还一笔出金（卖出）交易。
`create_customer`	创建 MoonPay 客户（已完成 KYC 的终端用户）。
`get_customer`	根据 ID 检索 MoonPay 客户。
`get_customer_kyc_status`	获取 MoonPay 客户的 KYC 验证状态（以及任何待提交的文件要求）。
`list_customer_transactions`	列出与单个 MoonPay 客户关联的所有交易（买入 + 卖出）。
`get_transaction_receipt`	获取已完成买入或卖出交易的税务/审计级收据。
`list_currencies`	列出支持的货币（法币 + 加密货币）。
`get_currency`	根据 MoonPay 代码检索单种货币（法币或加密货币）的元数据。
`list_countries`	列出 MoonPay 支持的国家，以及各地区允许的流程（买入 / 卖出 / NFT）。
`list_payment_methods`	列出指定法币 / 国家组合支持的支付方式（例如
`get_user_country`	通过 MoonPay 的 IP 地址地理位置接口解析调用者（或指定 IP）所在的国家。
`sign_buy_url`	构建并使用 HMAC-SHA256 签名 MoonPay 买入组件 URL（buy.moonpay.com）。
`sign_sell_url`	构建并使用 HMAC-SHA256 签名 MoonPay 卖出组件 URL（sell.moonpay.com）。

安装

npm install @codespar/mcp-moonpay

环境

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

身份验证

每个请求都使用一个简单的请求头：

Authorization: Api-Key <MOONPAY_API_KEY>

沙盒或生产环境由密钥本身决定 — 基础 URL 保持不变。

运行

# 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