Bridge Rates MCP

🚀 Bridge Rates MCP Server

An MCP server that provides real-time cross-chain bridge rates and optimal transfer routes, supporting AI agent decision-making.

🚀 Quick Start

This Bridge Rates MCP Server offers real - time cross - chain bridge rates and optimal transfer routes, enabling AI agents to make decisions.

✨ Features

• Get Bridge Rates: Retrieve cross - chain bridge rates between token pairs, including USD value, gas fees, route providers, and labels, presented in a Markdown table.
• List Supported Chains: Obtain a sorted list of blockchain networks supported by LI.FI.
• List Supported Bridges: Get a sorted list of available cross - chain transfer bridges and exchanges.

📦 Installation

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.

Steps

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 the MCP client: Configure your MCP client (e.g., Claude Desktop) to connect to the server. Here is an example configuration path:

   http://localhost:7001
   

💻 Usage Examples

Basic Usage

Get Bridge Rates

• Description: Retrieve cross - chain bridge rates between token pairs.

• Parameters:

  • srcChainId (required): Source chain ID.
  • srcTokenAddress (required): Source token address (Evm address).
  • destChainId (required): Destination chain ID.
  • destTokenAddress (optional): Destination token address (Evm address).

• Example:

  curl --location 'http://localhost:7001/' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "method": "getBridgeRates",
    "params": {
        "srcChainId": "5",
        "srcTokenAddress": "0x123456789abcdef",
        "destChainId": "1",
        "destTokenAddress": "0xabcd1234efghijk"
    }
  

}'

- **Result**:
```json
{
  "rates": [
    {
      "bridgeKey": "hop",
      "sourceAmount": "1.0",
      "destinationAmount": "0.95",
      "feeRate": "0.05"
    },
    {
      "bridgeKey": "connext",
      "sourceAmount": "1.0",
      "destinationAmount": "0.97",
      "feeRate": "0.03"
    }
  ]
}

List Supported Chains

• Description: Obtain a list of blockchain networks supported by LI.FI.
• Example:

  curl --location 'http://localhost:7001/' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "method": "getSupportedChains"
  

}'

- **Result**:
```json
{
  "chains": [
    {
      "key": "ethereum",
      "name": "Ethereum Mainnet",
      "network": "mainnet"
    },
    {
      "key": "polygon",
      "name": "Polygon Mainnet",
      "network": "mainnet"
    }
  ]
}

List Supported Bridges

• Description: Get a list of bridges and exchanges supported by LI.FI.
• Example:

  curl --location 'http://localhost:7001/' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "method": "getSupportedBridges"
  

}'

- **Result**:
```json
{
  "bridges": [
    {
      "key": "hop",
      "name": "Hop Protocol",
      "type": "BRIDGE"
    },
    {
      "key": "sushiswap",
      "name": "SushiSwap",
      "type": "EXCHANGE"
    }
  ]
}

📄 License

This project is open - sourced under the MIT License. See the LICENSE file for details.