Crypto Orderbook MCP

Crypto Orderbook MCP

Real-time crypto order book analytics for AI agents and trading systems.

10
Stars
5
Forks
10
Watchers
0
Issues
Crypto Orderbook MCP provides an MCP-compatible server that analyzes order book depth and imbalance across major cryptocurrency exchanges. It empowers AI agents and trading systems with unified, real-time market structure insights. Users can calculate and compare key order book metrics such as bid/ask depth and imbalance across multiple platforms using straightforward tools. The server returns data in structured formats for seamless integration with AI-enabled workflows.

Key Features

Calculates order book bid and ask depth for specified trading pairs and exchanges
Computes order book imbalance metrics
Facilitates cross-exchange comparison of order book data
Returns results in structured JSON or Markdown formats
Supports multiple major exchanges including Binance, Kraken, Coinbase, Bitfinex, Okx, and Bybit
Easy integration as an MCP server for AI model context
Real-time data acquisition and processing
Designed for use with Python 3.10+ and uv package manager
Empowers AI agents and trading systems with live market insights
Unified interface for various exchange APIs

Use Cases

Empowering AI trading agents with real-time order book metrics
Comparing liquidity and depth across multiple crypto exchanges
Building market surveillance or monitoring dashboards
Integrating structured market data into automated trading systems
Supporting quantitative research on liquidity and market structure
Enabling algorithmic strategy development based on order book imbalance
Assisting in arbitrage analysis with cross-exchange data
Providing key market context for natural language interface tools
Facilitating risk assessment with live exchange order book analytics
Enhancing transparency for trading infrastructure and bot operators

README

Crypto Orderbook MCP

An MCP server that analyzes order book depth and imbalance across major crypto exchanges, empowering AI agents and trading systems with real-time market structure insights.

License Python Status

Features

  • Order Book Metrics: Calculate bid/ask depth and imbalance for a specified trading pair on a given exchange.
  • Cross-Exchange Comparison: Compare order book depth and imbalance across multiple exchanges in a unified Markdown table.
  • Supported Exchanges: Binance, Kraken, Coinbase, Bitfinex, Okx, Bybit

Installation

Prerequisites

  • Python 3.10 or higher
  • uv (Python package and project manager)

Setup

  1. Clone the Repository

    bash
    git clone https://github.com/kukapay/crypto-orderbook-mcp.git
    cd crypto-orderbook-mcp
    
  2. Install Dependencies

    Use uv to install the required packages:

    bash
    uv sync
    
  3. Configure the MCP Client(Claude Desktop)

    "mcpServers": { 
      "crypto-orderbook-mcp": { 
        "command": "uv", 
        "args": [ "--directory", "/absolute/path/to/crypto-orderbook-mcp", "run", "main.py" ]
      } 
    }
    

Usage

The server provides two main tools:

  1. calculate_orderbook: Computes bid depth, ask depth, and imbalance for a trading pair on a specified exchange.
  2. compare_orderbook: Compares bid depth, ask depth, and imbalance across multiple exchanges, returning a Markdown table.

Example: Calculate Order Book Metrics

Prompt: "Calculate the order book metrics for BTC/USDT on Binance with a 1% depth range."

Expected Output (JSON object):

json
{
  "exchange": "binance",
  "symbol": "BTC/USDT",
  "bid_depth": 123.45,
  "ask_depth": 234.56,
  "imbalance": 0.1234,
  "mid_price": 50000.0,
  "timestamp": 1698765432000
}

Example: Compare Order Book Across Exchanges

Prompt: "Compare the order book metrics for BTC/USDT across Binance, Kraken, and OKX with a 1% depth range."

Expected Output (Markdown table):

markdown
| exchange | bid_depth | ask_depth | imbalance |
|----------|-----------|-----------|-----------|
| binance  |    123.45 |    234.56 |    0.1234 |
| kraken   |     89.12 |    178.34 |    0.0987 |
| okx      |    145.67 |    256.78 |    0.1345 |

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 83 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

  • Funding Rates MCP

    Funding Rates MCP

    Real-time crypto funding rate comparison via Model Context Protocol

    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.

    • 6
    • MCP
    • kukapay/funding-rates-mcp
  • Crypto Trending MCP Server

    Crypto Trending MCP Server

    Real-time trending cryptocurrency data via Model Context Protocol tools.

    Crypto Trending MCP Server tracks and monitors the latest trending tokens on CoinGecko, providing real-time insights into the most popular cryptocurrencies. It exposes MCP tools and prompts, such as a Markdown generator for trending token data and a parser prompt for extracting and analyzing the results with AI models. The solution is built for seamless integration with clients like Claude Desktop and allows natural language querying of current crypto trends. Its lightweight and extensible design supports easy deployment and extension.

    • 6
    • MCP
    • kukapay/crypto-trending-mcp
  • cryptopanic-mcp-server

    cryptopanic-mcp-server

    Provides real-time cryptocurrency news to AI agents via Model Context Protocol.

    cryptopanic-mcp-server delivers up-to-date cryptocurrency news to AI agents by integrating with the CryptoPanic API. It exposes an MCP-compliant server with a tool for fetching news or media headlines, supporting customization via API keys and configuration files. The implementation is intended for streamlined context integration into AI workflows, enhancing agent awareness with current crypto market updates.

    • 59
    • MCP
    • kukapay/cryptopanic-mcp-server
  • Crypto Projects MCP Server

    Crypto Projects MCP Server

    AI-accessible server that delivers comprehensive cryptocurrency project data in structured formats.

    Crypto Projects MCP Server provides AI agents with detailed cryptocurrency project data sourced from Mobula.io, accessible via the Model Context Protocol (MCP). It offers both raw JSON and formatted Markdown outputs, making project information easy to parse and consume by large language models. The server features language customization and returns organized details including price, market data, tokenomics, links, investors, and more. Integration with tools like Claude Desktop is supported for seamless AI interactions.

    • 0
    • MCP
    • kukapay/crypto-projects-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
  • Crypto Portfolio MCP

    Crypto Portfolio MCP

    Real-time crypto portfolio management and analysis via MCP.

    Crypto Portfolio MCP is an MCP server that enables users and AI agents to track, manage, and optimize cryptocurrency portfolio allocations with live Binance price integration. It allows querying of portfolio status, addition of holdings, price fetching, value history chart generation, and portfolio analysis suggestions. The server provides persistent storage using SQLite and exposes API-like tools for seamless interaction through an MCP client. Designed for integration with platforms like Claude Desktop, it facilitates dynamic crypto asset management and insight generation.

    • 9
    • MCP
    • kukapay/crypto-portfolio-mcp
  • Didn't find tool you were looking for?

    Be as detailed as possible for better results