Fetches real-time funding rate data from Binance for cryptocurrency trading pairs, enabling arbitrage opportunity detection.
Provides a Discord community for support and discussions related to the funding rates MCP server.
Hosts the repository for the funding rates MCP server, allowing users to access the source code and documentation.
Retrieves current funding rates from OKX exchange for cryptocurrency trading pairs to identify potential arbitrage opportunities.
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
Clone the Repository:
git clone https://github.com/kukapay/funding-rates-mcp.git cd funding-rates-mcpSet Up Dependencies with uv:
uv syncConfiguring Claude Desktop:
To use with Claude Desktop:
Edit the Claude configuration file:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
Windows:
%APPDATA%\Claude\claude_desktop_config.json
Add the MCP server:
{ "mcpServers": { "funding-rates-mcp": { "command": "uv", "args": ["--directory", "/absolute/path/to/funding-rates-mcp", "run", "funding-rates-mcp"] } } }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.
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
funding-rates-mcp
Related MCP Servers
- MIT License
- MIT License