What is Funding Rates Mcp

Funding-rates-mcp is an MCP server that provides real-time funding rate data across major cryptocurrency exchanges, helping users identify arbitrage opportunities.

Use cases

Use cases include real-time monitoring of funding rates for arbitrage trading, data analysis for trading strategies, and integration into trading bots for automated decision-making.

How to use

To use funding-rates-mcp, clone the repository from GitHub, set up dependencies using uv, and configure it with Claude Desktop for interactive queries. After setup, you can query funding rates through the provided MCP tool.

Key features

Key features include real-time funding rates from exchanges like Binance, OKX, Bybit, Bitget, Gate, and CoinEx, a pivoted table output for easy comparison, and integration with Claude Desktop for interactive usage.

Where to use

Funding-rates-mcp can be used in the cryptocurrency trading sector, particularly for traders looking to exploit funding rate differences across exchanges for arbitrage.

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:
      • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
      • Windows: %APPDATA%\Claude\claude_desktop_config.json
   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.