home / mcp / crypto mcp server

Crypto MCP Server

Provides real-time and historical crypto market data via MCP tools from major exchanges.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "kamatalarajeev-mcp": {
      "command": "python",
      "args": [
        "-m",
        "src.crypto_mcp_server.server"
      ]
    }
  }
}

You run a Python-based MCP server that delivers real-time and historical cryptocurrency market data from major exchanges. It exposes a set of practical tools you can use to fetch prices, historical OHLCV data, market summaries, and order books, all through the MCP protocol for fast, programmable access.

How to use

You access the server with an MCP client to perform common market data tasks. Start by launching the server locally, then call the available tools to retrieve real-time prices, historical data, market statistics, order books, and symbol searches. The design emphasizes simple, repeatable requests and optional caching to balance data freshness with performance.

How to install

Prerequisites: Python 3.10 or higher and pip for package management.

1. Clone the project and navigate into the directory.

2. Create a virtual environment (recommended) to isolate dependencies.

3. Install dependencies from the requirements file.

4. Run the MCP server.

Configuration and usage notes

Change the default exchange or adjust cache settings to tune performance and data freshness. The server defaults are designed to work with common needs but can be tailored to your environment.

Available tools

get_crypto_price

Fetch the current price for a given cryptocurrency trading pair, with optional use_cache to hit the cache instead of querying the exchange.

get_multiple_prices

Retrieve prices for multiple trading pairs in a single call to reduce round-trips.

get_historical_data

Obtain historical OHLCV data for a symbol and timeframe, with a limit on the number of data points.

get_market_summary

Get broad market statistics for a symbol, including 24h changes and related metrics.

get_orderbook

Access the current bid/ask order book for a trading pair with a specified limit.

search_symbols

Search available trading pairs by a query such as a partial symbol name.

get_supported_exchanges

List all exchanges supported by the MCP server.

clear_cache

Clear all cached data to force fresh queries on next requests.

get_cache_stats

Return statistics about the current cache, including hit/miss counts and sizes.