Bridge Rates MCP Server

An MCP server that delivers real-time cross-chain bridge rates and optimal transfer routes to support decision-making by onchain AI agents.

License Node.js Status

Features

Get Bridge Rates: Retrieve cross-chain bridge rates for token pairs, including USD values, gas costs, route providers and tags, presented in a Markdown table.
List Supported Chains: Fetch a sorted list of blockchain networks supported by LI.FI.
List Supported Bridges: Obtain a sorted list of bridges and exchanges available for cross-chain transfers.

Prerequisites

Node.js: Version 18 or higher.
npm: For dependency management.
MCP Client: An MCP-compatible client (e.g., Claude Desktop) to interact with the server.

Installation

Clone the Repository:

git clone https://github.com/kukapay/bridge-rates-mcp.git
cd bridge-rates-mcp

Install Dependencies:
```
npm install
```
Integrate with an MCP Client:Configure your MCP client (e.g., Claude Desktop) to connect to the server. For Claude Desktop, edit the configuration file (e.g., ~/Library/Application Support/Claude/claude_desktop_config.json on Mac or %APPDATA%\Claude\claude_desktop_config.json on Windows):
```
{
  "mcpServers": {
    "bridge-rates": {
      "command": "node",
      "args": ["/absolute/path/to/bridge-rates-mcp/index.js"]
    }
  }
}
```
Restart Claude Desktop and verify the tools are available (look for the hammer icon).

Tools

1. `getBridgeRates`

Fetches cross-chain bridge rates for a token pair between two chains, returning all available routes in a Markdown table.

Parameters:

fromChainId (string, required): Source chain ID (e.g., "1" for Ethereum).
toChainId (string, required): Destination chain ID (e.g., "10" for Optimism).
fromTokenAddress (string, required): Source token contract address.
toTokenAddress (string, required): Destination token contract address.
fromAmount (string, optional): Amount to bridge in the smallest token unit (default: "10000000").

Example Prompt:

What's the bridge rate from Arbitrum USDC to Optimism DAI?

Example Output:

| From Amount | From Amount USD | To Amount | To Amount USD | To Amount Min | Gas Cost USD | Providers | Tags                 |
|-------------|-----------------|-----------|---------------|---------------|--------------|-----------|----------------------|
| 10000000    | 10.00           | 9980000   | 9.98          | 9940000       | 0.2300       | hop       | RECOMMENDED,CHEAPEST |
| 10000000    | 10.00           | 9975000   | 9.97          | 9935000       | 0.2500       | connext   | None                 |

2. `getSupportedChains`

Fetches a sorted list of chains supported by LI.FI for cross-chain bridging, presented in a Markdown table.

Parameters: None.

Example Prompt:

List all supported chains for bridging.

Example Output:

| Chain Type | ID | Key | Name          | Native Token |
|------------|----|-----|---------------|--------------|
| EVM        | 1  | eth | Ethereum      | ETH          |
| EVM        | 10 | opt | Optimism      | ETH          |
| EVM        | 137| pol | Polygon       | MATIC        |
| SVM        | 101| sol | Solana        | SOL          |

3. `getSupportedBridges`

Fetches a sorted list of bridges and exchanges supported by LI.FI, presented in a Markdown table.

Parameters: None.

Example Prompt:

List all supported bridges for cross-chain bridging.

Example Output:

| Key           | Name                | Type     |
|---------------|---------------------|----------|
| across        | Across              | BRIDGE   |
| connext       | Connext             | BRIDGE   |
| hop           | Hop Protocol        | BRIDGE   |
| sushiswap     | SushiSwap           | EXCHANGE |
| uniswap       | Uniswap             | EXCHANGE |

License

This project is licensed under the MIT License. See the LICENSE file for details.

Bridge Rates MCP Server