An MCP (Model Context Protocol) server that provides real-time cryptocurrency market data using the CoinGecko API — completely free, no API key required (50 requests/min).

Features

Live prices — current price, market cap, 24h volume, 24h change for any coin
Top coins — ranked by market cap (customizable count)
Search — find coins by name or symbol
Trending — see what's hot on CoinGecko right now
Historical data — price charts over custom time ranges (1 day to 1 year)

Requirements

Python 3.10+
pip

Installation

pip install -r requirements.txt

Usage

Start the MCP server

python server.py

The server communicates over stdio — it's designed to be used by MCP-compatible clients (e.g., Claude Desktop, Cursor, VS Code via @modelcontextprotocol).

Client Configuration

Add to your MCP client config:

{
  "mcpServers": {
    "crypto-market-data": {
      "command": "python",
      "args": ["/path/to/crypto-market-mcp/server.py"]
    }
  }
}

Tools

1. `crypto_price`

Get real-time price + market data for a specific coin.

Parameter	Type	Default	Description
`coin_id`	string	—	CoinGecko coin ID (e.g. `bitcoin`, `ethereum`)
`vs_currency`	string	`usd`	Target currency (usd, eur, gbp, jpy, etc.)

2. `crypto_top`

List top N coins by market cap.

Parameter	Type	Default	Description
`limit`	number	`10`	Number of coins (1–100)
`vs_currency`	string	`usd`	Target currency

3. `crypto_search`

Search coins by name or ticker symbol.

Parameter	Type	Default	Description
`query`	string	—	Name or symbol (e.g. `sol`)

4. `crypto_trending`

See what's trending on CoinGecko right now. No parameters.

5. `crypto_historical`

Get historical price data points for a coin.

Parameter	Type	Default	Description
`coin_id`	string	—	CoinGecko coin ID
`days`	number	`7`	Days of history (1, 7, 14, 30, 90, 180, 365)

Rate Limits

CoinGecko free tier allows 50 calls per minute per IP. This server does not add caching — consider adding a reverse proxy or cache if you exceed that rate.