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

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

Tool	Description
bridge_create_customer	Create a new individual or business customer
bridge_get_customer	Get customer details by ID
bridge_list_customers	List all customers with pagination

Wallet Operations

Tool	Description
bridge_create_wallet	Create a custodial wallet on a blockchain
bridge_get_wallet	Get wallet details
bridge_list_wallets	List all wallets for a customer

Virtual Account Operations

Tool	Description
bridge_create_virtual_account	Create a fiat deposit address that auto-converts to stablecoins
bridge_get_virtual_account	Get virtual account details
bridge_list_virtual_accounts	List all virtual accounts for a customer

Transfer Operations

Tool	Description
bridge_create_transfer	Create a transfer (fiat↔crypto, crypto↔crypto)
bridge_get_transfer	Get transfer status
bridge_list_transfers	List transfers with optional filtering

External Account Operations

Tool	Description
bridge_create_external_account	Link a bank account for payouts
bridge_get_external_account	Get external account details
bridge_list_external_accounts	List all external accounts for a customer

Webhook Operations

Tool	Description
bridge_create_webhook	Create a webhook endpoint
bridge_list_webhooks	List all webhook endpoints

Utility

Tool	Description
bridge_get_exchange_rates	Get current exchange rates

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