mcp-unblockpay

Name: mcp-unblockpay
Author: codespar

本地服务

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

代码仓库

关于 mcp-unblockpay

mcp-unblockpay 是 UnblockPay 的 MCP 服务，用于法币与稳定币之间的跨境收付款，覆盖客户、钱包、报价、代收和代付流程。适合需要通过 AI 工具发起跨境支付的开发者和财务团队。

主要功能

01客户与 KYC 认证管理
02稳定币钱包创建与查询
03外汇与手续费报价锁定
04法币转稳定币代收
05稳定币转法币代付
06交易状态查询与取消

适用场景

01通过 AI 助手发起 BRL、USD、EUR 或 MXN 的跨境付款
02查询与取消待处理的跨境交易
03在沙箱环境中测试稳定币收付款流程

MCP 相关

该项目是 MCP 服务，向 MCP 客户端暴露 13 个用于客户、钱包、报价和交易的工具，通过 API 密钥访问 UnblockPay v1 接口。

配置

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

mcp.json · 通用配置

{
  "mcpServers": {
    "codespar-mcp-unblockpay": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-unblockpay"
      ],
      "env": {
        "UNBLOCKPAY_API_KEY": "<UNBLOCKPAY_API_KEY>",
        "UNBLOCKPAY_BASE_URL": "<UNBLOCKPAY_BASE_URL>"
      }
    }
  }
}

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

需要配置的环境变量

UNBLOCKPAY_API_KEY密钥API key from the UnblockPay dashboard

UNBLOCKPAY_BASE_URLOptional API base URL. Defaults to https://api.unblockpay.com/v1. Set to https://api.sandbox.unblockpay.com/v1 to hit the sandbox.

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

安装包

npm@codespar/mcp-unblockpay0.3.1stdio

工具

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

参数	类型	必填	说明
type	enum	是	Customer 类型individual \| business
email	string	否
tax_id	string	否	BRA 企业使用 CNPJ，USA 使用 EIN，MEX 使用 RFC，等等。
address	object	否
address.city	string	否
address.state	string	否
address.country	string	否	3 位 ISO 代码
address.postal_code	string	否
address.street_line_1	string	否
address.street_line_2	string	否
country	string	是	3 位 ISO 3166-1 alpha-3 国家代码（BRA、USA、MEX）
last_name	string	否	type=individual 时必填
first_name	string	否	type=individual 时必填
phone_number	string	否	E.164 格式，例如 +5511999999999
date_of_birth	string	否	ISO 日期（YYYY-MM-DD）。type=individual 时必填
business_legal_name	string	否	type=business 时必填
date_of_incorporation	string	否	ISO 日期（YYYY-MM-DD）。type=business 时必填

详细介绍

@codespar/mcp-unblockpay

UnblockPay 的 MCP 服务——通过 Customer → Wallet → Quote → Payin/Payout 实现法币 ↔ 稳定币跨境交易

快速开始

Claude Desktop

添加到 ~/.config/claude/claude_desktop_config.json：

{
  "mcpServers": {
    "unblockpay": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-unblockpay"],
      "env": {
        "UNBLOCKPAY_API_KEY": "your-key"
      }
    }
  }
}

Claude Code

claude mcp add unblockpay -- npx @codespar/mcp-unblockpay

Cursor / VS Code

添加到 .cursor/mcp.json 或 .vscode/mcp.json：

{
  "servers": {
    "unblockpay": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-unblockpay"],
      "env": {
        "UNBLOCKPAY_API_KEY": "your-key"
      }
    }
  }
}

工具（13 个）

工具	用途
`create_customer`	创建个人或企业客户（KYC 主体）。企业客户必须提供 `date_of_incorporation`。
`list_customers`	列出操作员 API 密钥下的客户（v1 分页约定要求必须提供 `limit`）。
`verify_customer`	触发 KYC 验证检查。此操作具有幂等性（客户已获批时返回 422 `customer_cannot_be_verified`）。
`get_verification_details`	轮询 KYC 状态——返回 `customer_status: pending \| approved \| rejected \| partially_rejected`。
`create_wallet`	为已获批的客户创建稳定币钱包。
`list_wallets`	列出操作员 API 密钥下的钱包。
`create_external_account`	登记法币收款账户（BRL Pix、USD wire、EUR SEPA、MXN SPEI）。通过 `create_payout` 上的 `pix_key + document` 快捷方式发起 BRL Pix 付款时可跳过此步骤。
`list_external_accounts`	列出操作员 API 密钥下的外部账户。
`create_quote`	锁定 5 分钟有效的外汇汇率和手续费报价。在 `sender` 或 `receiver` 其中一方传入 `amount`，不能同时传入。
`create_payin`	创建法币 → 稳定币入金，并引用 `quote_id`。返回存款说明（巴西适用 `<Pix Copy & Paste EMV>`）。
`create_payout`	创建稳定币 → 法币付款，并引用 `quote_id`。顶层必须提供 `customer_id`。
`get_transaction`	轮询交易状态。生命周期：`awaiting_deposit → processing → completed`（或 `failed / refunded / cancelled / error`）。
`cancel_transaction`	取消交易。仅当状态为 `awaiting_deposit` 时有效。

身份验证

UnblockPay 使用 API 密钥，并将其原样传入 Authorization 标头（不加 Bearer 前缀）。服务会为你设置该标头——你只需通过 UNBLOCKPAY_API_KEY 提供密钥。

沙盒 / 测试

UnblockPay 提供独立的沙盒环境用于测试。设置 UNBLOCKPAY_BASE_URL=https://api.sandbox.unblockpay.com/v1，并使用沙盒签发的 API 密钥，即可将服务指向沙盒环境。

获取凭据

登录 app.unblockpay.com（或参阅文档）
在控制面板中生成 API 密钥
设置 UNBLOCKPAY_API_KEY 环境变量 4.（仅限沙盒）同时设置 UNBLOCKPAY_BASE_URL=https://api.sandbox.unblockpay.com/v1

环境变量

变量	必填	说明
`UNBLOCKPAY_API_KEY`	是	从 UnblockPay 控制面板获取的 API 密钥
`UNBLOCKPAY_BASE_URL`	否	默认为 `https://api.unblockpay.com/v1`。沙盒环境请设置为 `https://api.sandbox.unblockpay.com/v1`。

路线图

以上 13 个工具对应 UnblockPay 当前的 v1 API。UnblockPay 扩展 API 范围后，我们也会添加新工具。

想要贡献？提交 PR，或申请工具。

链接

企业版

需要为 Agent 付款提供治理、预算限额和审计跟踪？CodeSpar Enterprise 在这些 MCP 服务的基础上增加了策略引擎、付款路由和合规模板。

许可证

MIT

支持 Markdown

登录后评论

基本信息

作者: codespar
语言: node
版本: 0.3.1
传输方式: stdio
收录时间: 2026年6月22日
最近更新: 4 周前
官方 Registry: io.github.codespar/mcp-unblockpay

报告问题

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。