Funding Rates MCP

1# Funding Rates MCP
2 
3An MCP server that provides real-time funding rate data across major crypto exchanges, enabling agents to detect arbitrage opportunities. 
4 
5[![Discord](https://img.shields.io/discord/1353556181251133481?cacheSeconds=3600)](https://discord.gg/aRnuu2eJ)
6![GitHub License](https://img.shields.io/github/license/kukapay/funding-rates-mcp)
7![Python Version](https://img.shields.io/badge/python-3.10+-blue)
8![Status](https://img.shields.io/badge/status-active-brightgreen.svg)
9 
10## Features
11 
12- **Real-Time Funding Rates**: Fetches current funding across Binance, OKX, Bybit, Bitget, Gate and CoinEx.
13- **Pivoted Table Output**: Displays symbols as rows, exchanges as columns, and includes a `Divergence` column for max funding rate difference.
14- **Claude Desktop Integration**: Runs as an MCP server for interactive queries.
15 
16## Installation
17 
18### Prerequisites
19- Python 3.10+
20- [uv](https://github.com/astral-sh/uv) for dependency management
21- [Claude Desktop](https://www.anthropic.com/claude) (optional, for interactive queries)
22- Git
23 
24### Steps
251. **Clone the Repository**:
26   ```bash
27   git clone https://github.com/kukapay/funding-rates-mcp.git
28   cd funding-rates-mcp
29   ```
30 
312. **Set Up Dependencies with uv**:
32   ```bash
33   uv sync
34   ```
35 
363. **Configuring Claude Desktop**：
37 
38    To use with Claude Desktop:
39    1. Edit the Claude configuration file:
40       - **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
41       - **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
42    2. Add the MCP server:
43       ```json
44       {
45         "mcpServers": {
46           "funding-rates-mcp": {
47             "command": "uv",
48             "args": ["--directory", "/absolute/path/to/funding-rates-mcp", "run", "funding-rates-mcp"]
49           }
50         }
51       }
52       ```
53    3. Restart Claude Desktop. Look for the hammer icon to confirm integration.
54 
55## Usage
56    
57### Tools
58 
59The server provides the following MCP tool for querying funding rates:
60 
61- **`compare_funding_rates`**:
62  - **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.
63  - **Parameters**:
64    - `symbols` (List[str]): List of trading pairs (e.g., `["BTC/USDT:USDT", "ETH/USDT:USDT"]`). Required.
65    - `exchanges` (List[str], optional): List of exchanges to compare (e.g., `["binance", "okx"]`). Defaults to all supported exchanges (`binance`, `okx`, `bybit`, `bitget`, `gate`, `coinex`).
66    - `params` (Dict, optional): Additional parameters for the API call. Defaults to `{}`.
67  - **Returns**: A Markdown table with symbols as rows, exchanges as columns, funding rates as values (formatted as percentages), and a `Divergence` column.
68  - **Example**: See the Examples section below.
69 
70### Prompts
71 
72The server includes the following MCP prompt for generating natural language queries:
73 
74- **`compare_funding_rates_prompt`**:
75  - **Description**: Generates a natural language prompt for comparing funding rates across all supported exchanges, suitable for Claude Desktop input.
76  - **Parameters**:
77    - `symbols` (List[str]): List of trading pairs (e.g., `["BTC/USDT:USDT", "ETH/USDT:USDT"]`). Required.
78  - **Returns**: A string prompt (e.g., "Compare the funding rates for BTC/USDT:USDT, ETH/USDT:USDT across binance, okx, bybit, bitget, gate, coinex.").
79  - **Usage**: Used internally by Claude Desktop to interpret user queries or for testing in MCP Inspector.
80 
81### Examples
82#### Compare Funding Rates
83- **Input** (in Claude Desktop):  
84  "Compare funding rates for BTC/USDT:USDT and ETH/USDT:USDT across all exchanges."
85- **Output**:
86  ```
87  Current funding rates:
88 
89  | Symbol\Exchange | binance   | okx       | bybit     | bitget    | gate      | coinex    | Divergence |
90  |-----------------|-----------|-----------|-----------|-----------|-----------|-----------|------------|
91  | BTC/USDT:USDT   | 0.005161% | 0.007548% | 0.010000% | 0.002900% | -0.019200% | -0.035013% | 0.045013%  |
92  | ETH/USDT:USDT   | 0.010000% | 0.005839% | 0.010000% | 0.010000% | -0.008200% | 0.000000%  | 0.018200%  |
93  ```
94 
95#### Compare Specific Exchanges
96- **Input** (in Claude Desktop):  
97  "Compare funding rates for SOL/USDT:USDT on Binance, OKX, and Bybit."
98- **Output**:
99  ```
100  Current funding rates:
101 
102  | Symbol\Exchange | binance   | okx       | bybit     | Divergence |
103  |-----------------|-----------|-----------|-----------|------------|
104  | SOL/USDT:USDT   | -0.015312% | -0.003639% | -0.004467% | 0.011673%  |
105  ```
106 
107## License
108 
109This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
110 
111 
112