bridge-rates-mcp

bridge-rates-mcp is an MCP server designed to provide on-chain AI agents with real-time cross-chain bridge rates and optimal transfer routes to support their decision-making. The project fetches data via LI.FI and returns results in the form of Markdown tables.

Main Capabilities

The server provides three tools:

1. getBridgeRates: Fetches cross-chain bridge rates for a token pair between two chains, returns all available routes, and presents them in a Markdown table. Parameters include:

   • 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): bridge amount expressed in the token's smallest unit (default: "10000000")

2. getSupportedChains: Fetches a sorted list of cross-chain bridge chains supported by LI.FI, presented in a Markdown table. No parameters.

3. getSupportedBridges: Fetches a sorted list of bridges and exchanges supported by LI.FI, presented in a Markdown table. No parameters.

Usage

Requirements

• Node.js: version 18 or higher
• npm: for dependency management
• MCP client: an MCP-compatible client (e.g. Claude Desktop) for interacting with the server

Installation and Configuration

1. Clone the repository:

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

2. Install dependencies:

   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):

   {
     "mcpServers": {
       "bridge-rates": {
         "command": "node",
         "args": ["/absolute/path/to/bridge-rates-mcp/index.js"]
       }
     }
   }
   

   Restart Claude Desktop, and verify that the tools are available (look for the hammer icon).

Use Cases

This server is suitable for on-chain AI agents that need cross-chain transfer data, for example when making cross-chain asset transfer decisions, querying real-time rates and optimal routes.

Limitations

• Requires Node.js 18 or higher.
• Requires an MCP-compatible client to use.
• Depends on data provided by LI.FI.

License

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