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
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 registrationsrc/tools/- All MCP tools implementationsquoteSwap.ts- Cross-chain swap quotesgetSupportedChains.ts- List supported chainsgetTokensInfo.ts- Token information by chaingetOrderStatus.ts- Order status tracking
src/debridgeClient.ts- deBridge API clientsrc/types/deBridge.ts- TypeScript type definitionssrc/__tests__/- Test suite for all tools
References
- Based on deBridge API integrator example
- Uses Model Context Protocol SDK
License
MIT