Funding Rates MCP
About
An MCP server that provides real-time funding rate data across major crypto exchanges.
Details
- Author
- kukapay
- GitHub stars
- 8
- Downloads
- 238
- Categories
- Other
Jump to
- Real-time funding rates from six major exchanges
- Pivoted table output with Divergence column
- Claude Desktop integration for interactive queries
- Optional exchange filtering per query
- Tool and prompt support via MCP
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Funding Rates MCPCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install with Python 3.10+, uv, and optionally Claude Desktop. Clone the repository, run uv sync, then configure Claude Desktop by adding the server to claude_desktop_config.json. Use the compare_funding_rates tool with required symbols parameter and optional exchanges and params to get a Markdown table.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"funding rates mcp": {
"funding-rates-mcp": {
"command": "uv",
"args": [
"sync"
]
}
}
}
}McpServers
{
"funding-rates-mcp": {
"command": "uv",
"args": [
"sync"
]
}
}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) - GitSteps
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.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
