kukapay/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**:
2. **Set Up Dependencies with uv**:
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:
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.").