BlindPay

BlindPay MCP 服务

适用于 BlindPay 的官方 Model Context Protocol 服务——面向全球支付的稳定币 API。

此 MCP 服务的功能

此 MCP 服务让 AI 助手（Cursor、Claude Code、Codex 等）能够访问 BlindPay 的稳定币支付基础设施。它提供的工具可让 AI 助手：

• 创建和管理收款方（个人／企业）
• 在多个区块链上处理付款和收款
• 创建报价并获取外汇汇率
• 管理虚拟账户和区块链钱包
• 配置 Webhook 和 API 密钥
• 以及更多……

两种连接方式

	远程服务（推荐）	本地 npx 服务
URL／命令	https://mcp.blindpay.com/mcp	npx -y @blindpay/mcp
身份验证	使用 BlindPay 账户通过 OAuth 2.1 登录（PKCE）	BLINDPAY_API_KEY 环境变量
传输方式	Streamable HTTP	stdio
适用范围	Claude、ChatGPT、Cursor、VS Code、Grok，以及任何支持远程连接的客户端	任何 stdio MCP 客户端

两种方式都提供相同的工具、相同的服务说明（调用顺序、单位、测试金额）以及位于 blindpay://webhooks/events 的相同 Webhook 事件资源。远程服务无需 API 密钥：客户端会打开浏览器，你登录并选择一个实例，令牌的权限范围将限定为你在该实例上的角色。

工具配置

在本地服务上设置 BLINDPAY_MCP_PROFILE，以选择要公开的工具：

配置	工具	适用场景
full（默认）	所有公开的 API 操作，包括付款和转账	使用 AI 编码助手进行开发或运营
readonly	仅限 GET 操作：状态、余额、历史记录。不包含钱包签名消息、Webhook 密钥和 Webhook 门户访问工具；并且会像 /mcp/readonly 一样从 JSON 响应中移除 trace_id	面向消费者的助手，或任何不希望使用资金转移工具的场合

每个工具都带有 MCP 注释（readOnlyHint、destructiveHint、idempotentHint），这些注释根据 HTTP 动词确定，因此客户端可以自行控制确认流程。

前置条件（仅限本地服务）

获取 API 密钥和 Instance ID：

1. 在 BlindPay 创建账户
2. 创建开发实例
3. 前往 BlindPay Dashboard
4. 选择你的实例并点击 API Keys 选项卡
5. 创建新的 API 密钥
6. 从控制面板 URL 中复制 Instance ID（格式：in_xxxxxxxxxxxx）

需要安装的依赖项：

• Node.js
• Npm

运行 node -v 可检查是否已安装 Node.js。Npm 也一样，可运行 npm -v 进行检查。

安装

Cursor

一键安装（使用 API 密钥的远程服务）：

将 ~/.cursor/mcp.json 中的 YOUR_BLINDPAY_API_KEY 替换为从控制面板获取的密钥。Cursor 的 OAuth 登录需要动态客户端注册，而 BlindPay 的登录不支持此功能，因此远程服务会改用 API 密钥作为 bearer token。plugins/cursor 中的 Cursor 插件可配置这两个端点。

一键安装（使用 API 密钥的本地服务）：

将 MCP 添加到 Cursor

安装后，将 API 密钥和实例 ID 添加到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "blindpay": {
      "command": "npx",
      "args": ["-y", "@blindpay/mcp"],
      "env": {
        "BLINDPAY_API_KEY": "your-api-key-here",
        "BLINDPAY_INSTANCE_ID": "your-instance-id-here"
      }
    }
  }
}

Claude Code

作为插件（远程服务、OAuth、无需 API 密钥）：

claude plugin marketplace add blindpaylabs/blindpay-mcp
claude plugin install blindpay@blindpay

或作为普通 MCP 服务：

claude mcp add --transport http blindpay https://mcp.blindpay.com/mcp

使用 API 密钥的本地服务：

claude mcp add --transport stdio blindpay --env BLINDPAY_API_KEY=your-api-key-here --env BLINDPAY_INSTANCE_ID=your-instance-id-here -- npx -y @blindpay/mcp

Claude Desktop

将以下内容添加到 Claude Desktop 配置文件：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "blindpay": {
      "command": "npx",
      "args": ["-y", "@blindpay/mcp"],
      "env": {
        "BLINDPAY_API_KEY": "your-api-key-here",
        "BLINDPAY_INSTANCE_ID": "your-instance-id-here"
      }
    }
  }
}

Codex

远程服务（OAuth、无需 API 密钥）：

codex mcp add blindpay --url https://mcp.blindpay.com/mcp

使用 API 密钥的本地服务：

codex mcp add blindpay --env BLINDPAY_API_KEY=your-api-key-here --env BLINDPAY_INSTANCE_ID=your-instance-id-here -- npx -y @blindpay/mcp

或添加到 ~/.codex/config.toml（或项目范围的 .codex/config.toml）：

[mcp_servers.blindpay]
command = "npx"
args = ["-y", "@blindpay/mcp"]

[mcp_servers.blindpay.env]
BLINDPAY_API_KEY = "your-api-key-here"
BLINDPAY_INSTANCE_ID = "your-instance-id-here"

VS Code

点击顶部的 在 VS Code 中安装徽章，或添加到 .vscode/mcp.json：

{
  "servers": {
    "blindpay": {
      "type": "http",
      "url": "https://mcp.blindpay.com/mcp"
    }
  }
}

图库条目上线后，你也可以在扩展视图中搜索 @mcp blindpay。

Windsurf

添加到 ~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "blindpay": {
      "serverUrl": "https://mcp.blindpay.com/mcp"
    }
  }
}

Raycast

在 Raycast 中打开 Model Context Protocol Registry 扩展，搜索 BlindPay 并点击 Install Server。或者使用 Cursor 部分中的本地配置，通过 Manage Servers → Add Server 手动安装。

Claude（claude.ai / Claude Desktop，远程）

在 Settings → Connectors → Add custom connector 中，粘贴 https://mcp.blindpay.com/mcp 并完成登录。面向消费级目录时，只会公开只读工具。

ChatGPT

在 Settings → Connectors → Advanced 中启用 Developer Mode，然后点击 Create，使用 https://mcp.blindpay.com/mcp 和 OAuth 身份验证创建连接器。

Grok

**Grok Build 插件（推荐）：**从 xAI 插件市场安装 blindpay。该插件包含两个远程 HTTP MCP 端点：

服务	URL	范围
blindpay	https://mcp.blindpay.com/mcp	完整（读写）
blindpay-readonly	https://mcp.blindpay.com/mcp/readonly	只读

两者都使用 OAuth 2.1（PKCE）登录你的 BlindPay 账户，无需粘贴 API 密钥。

**自定义连接器（付费 Grok 版本）：**前往 https://grok.com/connectors → New Connector → Custom，输入 https://mcp.blindpay.com/mcp（或只读 URL），将客户端凭据留空，并在提示时完成 BlindPay 登录。

Cline

让 Cline 从 https://github.com/blindpaylabs/blindpay-mcp 安装 BlindPay MCP 服务。它会遵循 llms-install.md。

Gemini CLI

gemini extensions install https://github.com/blindpaylabs/blindpay-mcp

Docker

在容器中运行基于此仓库构建的本地 stdio 服务：

docker build -t blindpay-mcp .
docker run -i --rm -e BLINDPAY_API_KEY=your-api-key-here -e BLINDPAY_INSTANCE_ID=your-instance-id-here blindpay-mcp

其他 MCP 客户端

远程：将客户端指向 https://mcp.blindpay.com/mcp（Streamable HTTP，通过 /.well-known/oauth-protected-resource 进行 OAuth 2.1 发现）。 本地：设置 BLINDPAY_API_KEY，通过 stdio 运行 npx -y @blindpay/mcp。

示例提示词

配置完成后，你可以让 AI 助手与 BlindPay 交互：

"Get me a quote for sending 1000 USDC to a bank account in Brazil"

"List all my recent payouts from the last 7 days"

"Create a virtual account for receiver with ID re_xxxxxxxxxxxx"

"Show me the available payment rails"

"Get all receivers for instance in_xxxxxxxxxxxx"

提示

设置 BLINDPAY_INSTANCE_ID 后，所有作用域限定于实例的工具都会像远程服务一样自动填入实例 ID；模型发送的值会被忽略。若未设置，请在提示词中提供实例 ID。

文档

• 入门指南
• API 参考

支持

• 电子邮件：[email protected]
• 问题反馈：GitHub Issues

许可证

本项目采用 MIT License 许可，详情请参阅 LICENSE 文件。

由 BlindPay 团队倾心打造 ❤️