funding-rates-mcp

# Funding Rates MCP An MCP server that provides real-time funding rate data across major crypto exchanges, enabling agents to detect arbitrage opportunities. [](https://discord.gg/aRnuu2eJ)    ## 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](https://github.com/astral-sh/uv) for dependency management - [Claude Desktop](https://www.anthropic.com/claude) (optional, for interactive queries) - Git ### Steps 1. **Clone the Repository**: ```bash git clone https://github.com/kukapay/funding-rates-mcp.git cd funding-rates-mcp ``` 2. **Set Up Dependencies with uv**: ```bash 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: ```json { "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](LICENSE) file for details.