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

Create a customer: bridge_create_customer
Create a wallet: bridge_create_wallet (e.g., Solana)
Create a virtual account: bridge_create_virtual_account (USD → USDC)
Share the bank details with the customer to deposit fiat
Bridge auto-converts and sends USDC to the wallet

Off-ramp: Stablecoin to Fiat

Create external account: bridge_create_external_account (link bank)
Create transfer: bridge_create_transfer (bridge_wallet → ach)
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