README.md•4.38 kB
# 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.
[](https://discord.gg/aRnuu2eJ)
## 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
1. **Clone the Repository**:
```bash
git clone https://github.com/kukapay/bridge-rates-mcp.git
cd bridge-rates-mcp
```
2. **Install Dependencies**:
```bash
npm install
```
3. **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):
```json
{
"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](LICENSE) file for details.