<h1>BlindPay MCP Server<img src="https://github.com/user-attachments/assets/c42b121d-adf1-467c-88ce-6f5be1efa93c" align="right" width="102"/></h1>
[](https://discord.gg/2DFKYaxjpp)
[](https://twitter.com/intent/follow?screen_name=blindpay)
[](https://www.npmjs.com/package/@blindpay/mcp)
The official [Model Context Protocol](https://modelcontextprotocol.io/) server for [BlindPay](https://blindpay.com) - Stablecoin API for global payments.
## What This MCP Server Does
This MCP server provides AI assistants (Cursor, Claude Code, Codex, etc.) with access to BlindPay's stablecoin payment infrastructure. It exposes tools that allow AI assistants to:
- Create and manage receivers (individuals/businesses)
- Process payouts and payins on multiple blockchains
- Create quotes and get FX rates
- Manage virtual accounts and blockchain wallets
- Configure webhooks and API keys
- And more...
## Prerequisites
**Get your API key and Instance ID:**
1. [Create an account on BlindPay](https://app.blindpay.com/sign-up)
2. Create a development instance
3. Go to the [BlindPay Dashboard](https://app.blindpay.com/)
4. Select your instance and click on the **API Keys** tab
5. Create a new API key
6. Copy your instance ID (format: `in_xxxxxxxxxxxx`) from the dashboard url
**Dependencies you need to have installed:**
- [Node.js](https://nodejs.org/en/download)
- [Npm](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm)
You can check if you have Node.js installed by running `node -v`. Same for Npm, you can check by running `npm -v`.
## Installation
### Cursor
One-click install:
[Add MCP to Cursor](https://cursor.com/en-US/install-mcp?name=blindpay&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBibGluZHBheS9tY3AiXSwiZW52Ijp7IkJMSU5EUEFZX0FQSV9LRVkiOiJ5b3VyLWFwaS1rZXktaGVyZSIsIkJMSU5EUEFZX0lOU1RBTkNFX0lEIjoieW91ci1pbnN0YW5jZS1pZC1oZXJlIn19Cg==)
After installation, add your API key and instance ID to `~/.cursor/mcp.json`:
```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
Run the following command in your terminal:
```bash
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
Add to your Claude Desktop configuration file:
- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
```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
Run the following command in your terminal:
```bash
codex mcp add blindpay --env BLINDPAY_API_KEY=your-api-key-here --env BLINDPAY_INSTANCE_ID=your-instance-id-here -- npx -y @blindpay/mcp
```
Or add to your `~/.codex/config.toml` (or project-scoped `.codex/config.toml`):
```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"
```
## Example Prompts
Once configured, you can ask your AI assistant to interact with 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"
```
> [!TIP]
> You can specify `BLINDPAY_INSTANCE_ID` in your initial prompt or add it as an environment variable. However, some AI tools may not detect it automatically, so you may need to include it explicitly in your prompt.
## Documentation
- [Getting Started](https://blindpay.com/docs/getting-started/overview)
- [API Reference](https://api.blindpay.com/reference)
## Support
- Email: [eric@blindpay.com](mailto:eric@blindpay.com)
- Issues: [GitHub Issues](https://github.com/blindpaylabs/blindpay-mcp/issues)
## License
This project is licensed under the [MIT License](LICENSE) - see the LICENSE file for details.
Made with ❤️ by the [BlindPay](https://blindpay.com) team
