Bridge MCP Server

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