Bridge Rates MCP Server

1# Bridge Rates MCP Server
2 
3An MCP server that delivers real-time cross-chain bridge rates and optimal transfer routes to support decision-making by onchain AI agents.
4 
5[![Discord](https://img.shields.io/discord/1353556181251133481?cacheSeconds=3600)](https://discord.gg/aRnuu2eJ)
6![License](https://img.shields.io/badge/license-MIT-blue.svg)
7![Node.js](https://img.shields.io/badge/Node.js-18.x-green.svg)
8![Status](https://img.shields.io/badge/status-active-brightgreen.svg)
9 
10## Features
11 
12- **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.
13- **List Supported Chains**: Fetch a sorted list of blockchain networks supported by LI.FI.
14- **List Supported Bridges**: Obtain a sorted list of bridges and exchanges available for cross-chain transfers.
15 
16## Prerequisites
17 
18- **Node.js**: Version 18 or higher.
19- **npm**: For dependency management.
20- **MCP Client**: An MCP-compatible client (e.g., Claude Desktop) to interact with the server.
21 
22## Installation
23 
241. **Clone the Repository**:
25   ```bash
26   git clone https://github.com/kukapay/bridge-rates-mcp.git
27   cd bridge-rates-mcp
28   ```
29 
302. **Install Dependencies**:
31   ```bash
32   npm install
33   ```
34 
353. **Integrate with an MCP Client**:
36   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):
37   ```json
38   {
39     "mcpServers": {
40       "bridge-rates": {
41         "command": "node",
42         "args": ["/absolute/path/to/bridge-rates-mcp/index.js"]
43       }
44     }
45   }
46   ```
47   Restart Claude Desktop and verify the tools are available (look for the hammer icon).
48 
49## Tools
50 
51### 1. `getBridgeRates`
52Fetches cross-chain bridge rates for a token pair between two chains, returning all available routes in a Markdown table.
53 
54**Parameters**:
55- `fromChainId` (string, required): Source chain ID (e.g., "1" for Ethereum).
56- `toChainId` (string, required): Destination chain ID (e.g., "10" for Optimism).
57- `fromTokenAddress` (string, required): Source token contract address.
58- `toTokenAddress` (string, required): Destination token contract address.
59- `fromAmount` (string, optional): Amount to bridge in the smallest token unit (default: "10000000").
60 
61**Example Prompt**:
62```
63What's the bridge rate from Arbitrum USDC to Optimism DAI?
64```
65 
66**Example Output**:
67```
68| From Amount | From Amount USD | To Amount | To Amount USD | To Amount Min | Gas Cost USD | Providers | Tags                 |
69|-------------|-----------------|-----------|---------------|---------------|--------------|-----------|----------------------|
70| 10000000    | 10.00           | 9980000   | 9.98          | 9940000       | 0.2300       | hop       | RECOMMENDED,CHEAPEST |
71| 10000000    | 10.00           | 9975000   | 9.97          | 9935000       | 0.2500       | connext   | None                 |
72```
73 
74### 2. `getSupportedChains`
75Fetches a sorted list of chains supported by LI.FI for cross-chain bridging, presented in a Markdown table.
76 
77**Parameters**: None.
78 
79**Example Prompt**:
80```
81List all supported chains for bridging.
82```
83 
84**Example Output**:
85```
86| Chain Type | ID | Key | Name          | Native Token |
87|------------|----|-----|---------------|--------------|
88| EVM        | 1  | eth | Ethereum      | ETH          |
89| EVM        | 10 | opt | Optimism      | ETH          |
90| EVM        | 137| pol | Polygon       | MATIC        |
91| SVM        | 101| sol | Solana        | SOL          |
92```
93 
94### 3. `getSupportedBridges`
95Fetches a sorted list of bridges and exchanges supported by LI.FI, presented in a Markdown table.
96 
97**Parameters**: None.
98 
99**Example Prompt**:
100```
101List all supported bridges for cross-chain bridging.
102```
103 
104**Example Output**:
105```
106| Key           | Name                | Type     |
107|---------------|---------------------|----------|
108| across        | Across              | BRIDGE   |
109| connext       | Connext             | BRIDGE   |
110| hop           | Hop Protocol        | BRIDGE   |
111| sushiswap     | SushiSwap           | EXCHANGE |
112| uniswap       | Uniswap             | EXCHANGE |
113```
114 
115## License
116 
117This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
118