Funding Rates MCP

An MCP server that provides real-time funding rate data across major crypto exchanges, enabling agents to detect arbitrage opportunities.

Features

• Real-Time Funding Rates: Fetches current funding across Binance, OKX, Bybit, Bitget, Gate and CoinEx.
• Pivoted Table Output: Displays symbols as rows, exchanges as columns, and includes a `Divergence` column for max funding rate difference.
• Claude Desktop Integration: Runs as an MCP server for interactive queries.

Installation

Prerequisites

• Python 3.10+
• uv for dependency management
• Claude Desktop (optional, for interactive queries)
• Git

Steps

1. Clone the Repository:

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

2. Set Up Dependencies with uv:

uv sync

3. Configuring Claude Desktop：

To use with Claude Desktop:

1. Edit the Claude configuration file:

2. Add the MCP server:

{
         "mcpServers": {
           "funding-rates-mcp": {
             "command": "uv",
             "args": ["--directory", "/absolute/path/to/funding-rates-mcp", "run", "funding-rates-mcp"]
           }
         }
       }

3. Restart Claude Desktop. Look for the hammer icon to confirm integration.

Usage

Tools

The server provides the following MCP tool for querying funding rates:

• `compare_funding_rates`:
  • Description: Compares current funding rates for multiple symbols across specified exchanges, returning a pivoted Markdown table with a `Divergence` column showing the maximum funding rate difference for each symbol.
  • Parameters:
    • `symbols` (List[str]): List of trading pairs (e.g., `["BTC/USDT:USDT", "ETH/USDT:USDT"]`). Required.
    • `exchanges` (List[str], optional): List of exchanges to compare (e.g., `["binance", "okx"]`). Defaults to all supported exchanges (`binance`, `okx`, `bybit`, `bitget`, `gate`, `coinex`).
    • `params` (Dict, optional): Additional parameters for the API call. Defaults to `{}`.
  • Returns: A Markdown table with symbols as rows, exchanges as columns, funding rates as values (formatted as percentages), and a `Divergence` column.
  • Example: See the Examples section below.

Prompts

The server includes the following MCP prompt for generating natural language queries:

• `compare_funding_rates_prompt`:
  • Description: Generates a natural language prompt for comparing funding rates across all supported exchanges, suitable for Claude Desktop input.
  • Parameters:
    • `symbols` (List[str]): List of trading pairs (e.g., `["BTC/USDT:USDT", "ETH/USDT:USDT"]`). Required.
  • Returns: A string prompt (e.g., "Compare the funding rates for BTC/USDT:USDT, ETH/USDT:USDT across binance, okx, bybit, bitget, gate, coinex.").
  • Usage: Used internally by Claude Desktop to interpret user queries or for testing in MCP Inspector.

Examples

Compare Funding Rates

• Input (in Claude Desktop):

"Compare funding rates for BTC/USDT:USDT and ETH/USDT:USDT across all exchanges."

• Output:

Current funding rates:

  | Symbol\Exchange | binance   | okx       | bybit     | bitget    | gate      | coinex    | Divergence |
  |-----------------|-----------|-----------|-----------|-----------|-----------|-----------|------------|
  | BTC/USDT:USDT   | 0.005161% | 0.007548% | 0.010000% | 0.002900% | -0.019200% | -0.035013% | 0.045013%  |
  | ETH/USDT:USDT   | 0.010000% | 0.005839% | 0.010000% | 0.010000% | -0.008200% | 0.000000%  | 0.018200%  |

Compare Specific Exchanges

• Input (in Claude Desktop):

"Compare funding rates for SOL/USDT:USDT on Binance, OKX, and Bybit."

• Output:

Current funding rates:

  | Symbol\Exchange | binance   | okx       | bybit     | Divergence |
  |-----------------|-----------|-----------|-----------|------------|
  | SOL/USDT:USDT   | -0.015312% | -0.003639% | -0.004467% | 0.011673%  |

License

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