crypto-market-mcp

Crypto Market Data MCP Server

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

Requirements

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

Search coins by name or ticker symbol.

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

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.

Deployment (Smithery)

This server is configured for Smithery. The smithery.yaml is included — just connect your GitHub repo on Smithery and it’ll work out of the box.

Pricing & Licensing

$19/month for premium support or self-hosted deployment assistance.

License

MIT