Bridge MCP Server

An MCP (Model Context Protocol) server that wraps the Bridge.xyz stablecoin infrastructure API, enabling AI assistants to interact with Bridge's payment and stablecoin services.

Features

• Customer Management: Create and manage individual/business customers with KYC/KYB

• Wallet Operations: Create custodial wallets on Solana, Ethereum, Polygon, and Base

• Virtual Accounts: Set up fiat deposit addresses that auto-convert to stablecoins

• Transfers: Move money between fiat and crypto (on-ramp, off-ramp, crypto-to-crypto)

• External Accounts: Link bank accounts for payouts

• Webhooks: Subscribe to Bridge events

• Exchange Rates: Get current conversion rates

Related MCP server: BlindPay MCP Server

Installation

npm install @lnflash/bridge-mcp

Or clone and build from source:

git clone https://github.com/lnflash/bridge-mcp.git
cd bridge-mcp
npm install
npm run build

Configuration

Set your Bridge API key as an environment variable:

export BRIDGE_API_KEY="your-api-key-here"

# Optional: Use sandbox environment
export BRIDGE_BASE_URL="https://api.sandbox.bridge.xyz/v0"

Usage with Claude Desktop

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "bridge": {
      "command": "npx",
      "args": ["@lnflash/bridge-mcp"],
      "env": {
        "BRIDGE_API_KEY": "your-api-key-here"
      }
    }
  }
}

Or if installed locally:

{
  "mcpServers": {
    "bridge": {
      "command": "node",
      "args": ["/path/to/bridge-mcp/dist/index.js"],
      "env": {
        "BRIDGE_API_KEY": "your-api-key-here"
      }
    }
  }
}

Available Tools

Customer Operations

Wallet Operations

Virtual Account Operations

Transfer Operations

External Account Operations

Webhook Operations

Utility

Example Workflows

On-ramp: Fiat to Stablecoin

1. Create a customer: bridge_create_customer

2. Create a wallet: bridge_create_wallet (e.g., Solana)

3. Create a virtual account: bridge_create_virtual_account (USD → USDC)

4. Share the bank details with the customer to deposit fiat

5. Bridge auto-converts and sends USDC to the wallet

Off-ramp: Stablecoin to Fiat

1. Create external account: bridge_create_external_account (link bank)

2. Create transfer: bridge_create_transfer (bridge_wallet → ach)

3. Monitor status: bridge_get_transfer

Supported Currencies

Fiat

• USD (ACH, Wire)

• EUR (SEPA)

• MXN (SPEI)

• BRL (PIX)

• GBP

Stablecoins

• USDC

• USDB (Bridge's native stablecoin)

• EURC

Blockchains

• Ethereum

• Polygon

• Solana

• Base

Development

# Watch mode
npm run dev

# Build
npm run build

# Run
npm start

License

MIT

Links

• Bridge.xyz

• Bridge API Docs

• MCP Protocol