Funding Rates MCP

Funding Rates MCP

Real-time crypto funding rate comparison via Model Context Protocol

6
Stars
7
Forks
6
Watchers
1
Issues
Provides a Model Context Protocol (MCP) server delivering real-time funding rate data across major cryptocurrency exchanges. Enables agents and applications to query and compare funding rates, identify arbitrage opportunities, and output pivoted tables with calculated divergences. Integrates seamlessly with Claude Desktop for interactive AI-driven analysis.

Key Features

Fetches real-time funding rates from multiple exchanges including Binance, OKX, Bybit, Bitget, Gate, and CoinEx
Exposes an MCP-compliant server for programmatic and agent-based queries
Outputs pivoted Markdown tables with symbols, exchanges, and divergence columns
Supports integration with Claude Desktop for interactive natural language queries
Provides tools for comparing funding rates across customizable symbol and exchange lists
Allows additional API parameters for flexible data retrieval
Includes a prompt generator for natural language query construction
Demonstrates easy configuration for Claude Desktop environments
Supports automated and manual query invocation
Active status with up-to-date dependencies and setup

Use Cases

Arbitrage detection across cryptocurrency exchanges
Automated trading decision support based on funding rate comparisons
Integration into AI agents requiring current market funding data
Market monitoring dashboards for funding rate divergence analysis
Enhancing trading strategies with real-time exchange funding differences
Natural language research on crypto funding across various platforms
Benchmarks for market making bots using up-to-date funding rates
Risk monitoring by comparing extreme funding divergences
Educational tools for learning about funding rates in the crypto market
Testing and demonstrating Model Context Protocol capabilities with financial data

README

Funding Rates MCP

An MCP server that provides real-time funding rate data across major crypto exchanges, enabling agents to detect arbitrage opportunities.

Discord GitHub License Python Version Status

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:

    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 file for details.

Star History

Star History Chart

Repository Owner

kukapay
kukapay

User

Repository Details

Language Python
Default Branch main
Size 84 KB
Contributors 1
License MIT License
MCP Verified Nov 12, 2025

Programming Languages

Python
100%

Tags

Join Our Newsletter

Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.

We respect your privacy. Unsubscribe at any time.

Related MCPs

Discover similar Model Context Protocol servers

  • Coincap MCP

    Coincap MCP

    Query live cryptocurrency data through Coincap's public API for desktop AI tools.

    Coincap MCP provides seamless access to cryptocurrency market data from Coincap's public API without requiring API keys or registration. Designed to integrate with Claude Desktop using the Model Context Protocol (MCP), it enables users to query crypto asset prices, market capitalization, and a list of available assets. Installation and configuration are streamlined through Smithery or direct setup. The tool includes sample prompts and exposes specialized tools for crypto price lookup and asset listing.

    • 89
    • MCP
    • QuantGeekDev/coincap-mcp
  • Twelve Data MCP Server

    Twelve Data MCP Server

    Seamless AI-powered access to financial market data via the Twelve Data API.

    Twelve Data MCP Server provides a Model Context Protocol-compliant server for integrating and accessing Twelve Data’s financial market API. It enables users and AI agents to retrieve historical data, real-time quotes, and instrument metadata for stocks, forex, and crypto using natural language or endpoint calls. The system leverages AI-driven routing, including OpenAI GPT-4o, to intelligently map plain English queries to relevant API endpoints for structured or conversational workflows. Integration options are available for platforms like Claude Desktop and VS Code, with flexible local or remote deployment.

    • 43
    • MCP
    • twelvedata/mcp
  • Hyperliquid Info MCP Server

    Hyperliquid Info MCP Server

    Real-time Hyperliquid perp DEX data and analytics via MCP.

    Provides an MCP-compliant server interface for accessing real-time user and market data from the Hyperliquid perpetual DEX. Enables bots, dashboards, and analytics platforms to query user positions, trading history, order books, and funding details seamlessly. Designed for integration with platforms like Claude Desktop and supports ISO 8601 time filtering.

    • 23
    • MCP
    • kukapay/hyperliquid-info-mcp
  • Fantasy Premier League MCP Server

    Fantasy Premier League MCP Server

    Enables rich access to Fantasy Premier League data via the Model Context Protocol.

    Fantasy Premier League MCP Server is a Model Context Protocol (MCP) server that provides streamlined access to Fantasy Premier League (FPL) data, including player statistics, team information, and gameweek details. It allows users to interact with and compare FPL player data, search teams and players, and integrate seamlessly with Claude Desktop and other MCP-compatible clients. Designed for both quick CLI usage and deep AI integration, it ensures comprehensive coverage for FPL enthusiasts and AI-powered desktop tools.

    • 65
    • MCP
    • rishijatia/fantasy-pl-mcp
  • Bitcoin MCP Server

    Bitcoin MCP Server

    Real-time Bitcoin blockchain data server for MCP clients.

    Provides tools to deliver real-time Bitcoin blockchain data for use with Model Context Protocol (MCP) clients. Offers specialized endpoints for querying blockchain addresses, transactions, UTXOs, and block information by interfacing with the mempool.space API. Supports easy installation and integration with popular MCP clients, enabling seamless access to blockchain analytics.

    • 0
    • MCP
    • JamesANZ/bitcoin-mcp
  • Uniswap V3 Price MCP Server

    Uniswap V3 Price MCP Server

    Real-time Uniswap V3 token price server for AI agents and DeFi automation.

    Uniswap V3 Price MCP Server delivers real-time token prices from Uniswap V3 across major EVM-compatible networks, including Ethereum, Polygon, Arbitrum, and Optimism. Optimized for AI agents and DeFi automation, it queries token prices in USD or other stablecoins, with optional conversion via CryptoCompare. The server is designed for compatibility with MCP clients, enabling seamless and standardized integrations. Environment setup is straightforward, leveraging Infura endpoints and Node.js.

    • 2
    • MCP
    • kukapay/uniswap-price-mcp
  • Didn't find tool you were looking for?

    Be as detailed as possible for better results