deBridge MCP Server

A Model Context Protocol (MCP) server that provides cross-chain swap quotes using deBridge DLN protocol.

Features

• Get crosschain swap quotes between different blockchain networks

• Read only operations (no transaction signing required)

• Fast quote fetching via deBridge API

Related MCP server: onchainos MCP Server

Installation

bun install

Usage

Running the MCP Server

Start the server for use with Claude Desktop or other MCP clients:

bun run dev

Testing

Run the test suite:

bun test

Building

Build the TypeScript project:

bun run build

Start the compiled server:

bun run start

MCP Tools

1. quoteSwap

Get best cross-chain route and calldata for a potential swap via deBridge DLN.

Parameters:

• srcChainId - Source chain ID (e.g., '42161' for Arbitrum)

• srcToken - Token address on source chain (ERC20)

• amount - Amount in smallest units (wei / token decimals)

• dstChainId - Destination chain ID (e.g., '1' for Ethereum mainnet)

• dstToken - Token address on destination chain (ERC20)

• userAddress (optional) - Sender's wallet address (enables tx data generation)

• recipientAddress (optional) - Recipient address on destination chain

Modes:

• Preview mode (without addresses): Returns only estimation, no tx data

• Full mode (with userAddress): Returns estimation + transaction data ready to sign

Response includes:

• Summary with estimated destination amount and fees

• Token information (symbol, decimals)

• Transaction preview (to, data, value)

• Raw estimation data from deBridge

2. getSupportedChains

Get list of supported blockchain networks for cross-chain swaps.

Parameters: None

Response includes:

• Array of supported chains with chain IDs and names

• Total number of supported chains

3. getTokensInfo

Get information about tokens available on a specific blockchain network.

Parameters:

• chainId - Chain ID to query (e.g., '1' for Ethereum, '56' for BSC)

Response includes:

• List of available tokens with addresses, symbols, and decimals

• Total token count for the chain

4. getOrderStatus

Check the status of a cross-chain order by its order ID.

Parameters:

• orderId - Order ID obtained from creating an order

Response includes:

• Order status (Created, Fulfilled, etc.)

• Source and destination chain transaction hashes

• Order link for tracking

• Error information if applicable

Environment Variables

Optional environment variables:

• DLN_API_BASE - Custom deBridge API base URL (default: https://dln.debridge.finance/v1.0)

Examples

1. Get quote for USDC swap from Arbitrum to Ethereum (Preview Mode)

{
  "srcChainId": "42161",
  "srcToken": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
  "amount": "1000000",
  "dstChainId": "1",
  "dstToken": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
}

2. Get quote with transaction data (Full Mode)

{
  "srcChainId": "42161",
  "srcToken": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
  "amount": "1000000",
  "dstChainId": "1",
  "dstToken": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
  "userAddress": "0xYourWalletAddress"
}

3. Get supported chains

No parameters needed - just call getSupportedChains

4. Get available tokens on Ethereum

{
  "chainId": "1"
}

5. Check order status

{
  "orderId": "0x..."
}

Architecture

• src/index.ts - MCP server setup and tool registration

• src/tools/ - All MCP tools implementations

  • quoteSwap.ts - Cross-chain swap quotes

  • getSupportedChains.ts - List supported chains

  • getTokensInfo.ts - Token information by chain

  • getOrderStatus.ts - Order status tracking

• src/debridgeClient.ts - deBridge API client

• src/types/deBridge.ts - TypeScript type definitions

• src/__tests__/ - Test suite for all tools

References

• Based on deBridge API integrator example

• Uses Model Context Protocol SDK

License

MIT