Skip to main content
Glama
crypto-data-mcp

crypto-data-mcp

by Wh0FF24

crypto-data-mcp

CI PyPI License: MIT

Real-time cryptocurrency data for AI coding tools. An MCP server that gives Claude Code, Cursor, and other MCP-compatible tools access to live prices, market data, token info, and historical charts -- powered by CoinGecko.

Built by Whoff Agents.

Installation

Fastest: one-liner with uvx (no install needed)

uvx crypto-data-mcp

Install from PyPI

pip install crypto-data-mcp
# or
uv add crypto-data-mcp

From source

git clone https://github.com/Wh0FF24/crypto-data-mcp.git
cd crypto-data-mcp
uv sync

Related MCP server: CoinGecko MCP Server

Usage with Claude Code

Add to your Claude Code MCP config at ~/.claude/claude_desktop_config.json:

{
  "mcpServers": {
    "crypto-data": {
      "command": "uvx",
      "args": ["crypto-data-mcp"]
    }
  }
}

Or if installed via pip/uv:

{
  "mcpServers": {
    "crypto-data": {
      "command": "crypto-data-mcp"
    }
  }
}

Then in Claude Code, you can ask things like:

  • "What's the current price of Bitcoin?"

  • "Compare ETH, SOL, and AVAX prices"

  • "Show me the crypto market overview"

  • "Get me 30 days of BTC price history"

  • "What's Ethereum's all-time high?"

Available Tools

get_price

Get the current price for a single token.

Parameters:

Param

Type

Default

Description

symbol

string

required

Token symbol (BTC, ETH, SOL) or CoinGecko ID

currency

string

"usd"

Quote currency (usd, eur, gbp, etc.)

Example response:

{
  "symbol": "BTC",
  "coingecko_id": "bitcoin",
  "currency": "usd",
  "price": 67250.00,
  "price_change_24h_pct": -1.82,
  "market_cap": 1325000000000,
  "volume_24h": 28500000000,
  "last_updated_at": 1712000000
}

get_prices

Get prices for multiple tokens in one call. More efficient than calling get_price repeatedly.

Parameters:

Param

Type

Default

Description

symbols

list[string]

required

List of symbols (max 50)

currency

string

"usd"

Quote currency

Example response:

[
  { "symbol": "BTC", "price": 67250.00, "price_change_24h_pct": -1.82 },
  { "symbol": "ETH", "price": 2064.00, "price_change_24h_pct": -2.15 },
  { "symbol": "SOL", "price": 79.00, "price_change_24h_pct": -3.10 }
]

get_market_overview

Get a crypto market overview with top movers, market cap, and sentiment.

Parameters: None required.

Example response:

{
  "total_market_cap_usd": 2390000000000,
  "total_volume_24h_usd": 85000000000,
  "btc_dominance_pct": 55.95,
  "eth_dominance_pct": 11.20,
  "active_cryptocurrencies": 17887,
  "fear_greed_index": { "value": 35, "classification": "Fear" },
  "top_gainers_24h": [ "..." ],
  "top_losers_24h": [ "..." ]
}

get_token_info

Get detailed information about a token including description, supply, ATH/ATL, and multi-timeframe price changes.

Parameters:

Param

Type

Default

Description

symbol

string

required

Token symbol or CoinGecko ID

Example response:

{
  "symbol": "ETH",
  "name": "Ethereum",
  "description": "Ethereum is a decentralized...",
  "market_cap_rank": 2,
  "website": "https://www.ethereum.org/",
  "current_price_usd": 2064.00,
  "ath_usd": 4946.05,
  "ath_date": "2021-11-10T14:24:19.604Z",
  "atl_usd": 0.432979,
  "circulating_supply": 120500000,
  "total_supply": 120500000,
  "max_supply": null,
  "price_change_24h_pct": -2.15,
  "price_change_7d_pct": -5.30,
  "price_change_30d_pct": -12.40
}

get_historical_prices

Get historical price data as timestamp/price pairs for charting and analysis.

Parameters:

Param

Type

Default

Description

symbol

string

required

Token symbol or CoinGecko ID

days

int

7

Days of history (1-365)

currency

string

"usd"

Quote currency

Granularity: 5-minute for 1 day, hourly for 1-90 days, daily for 90+ days.

Example response:

{
  "symbol": "BTC",
  "currency": "usd",
  "days": 7,
  "data_points": 168,
  "prices": [
    [1711900000000, 67100.00],
    [1711903600000, 67250.00]
  ]
}

Supported Tokens

The server includes a built-in mapping for 70+ popular tokens (BTC, ETH, SOL, USDT, USDC, BNB, XRP, ADA, DOGE, AVAX, and many more). For tokens not in the built-in map, it automatically searches CoinGecko to resolve the symbol.

MCP SDK Compatibility

Works with both major versions of the Python MCP SDK: mcp 1.x and 2.x (2.0 renamed FastMCP to MCPServer; the server detects which one is installed at import time). Tested against 1.30.0 and 2.3.0.

Data Source

All data comes from the CoinGecko API (free tier). The server includes:

  • 60-second caching to reduce API calls

  • Automatic retry with backoff on rate limits

  • Graceful error handling for network issues and invalid inputs

The free CoinGecko tier allows approximately 10-30 requests per minute.

Development

# Install dependencies
uv sync

# Run tests (uses live CoinGecko API -- may hit rate limits)
uv run pytest tests/ -v

# Run the server directly
uv run crypto-data-mcp

Pricing

Free tier -- This open-source MCP server with CoinGecko data is free.

Pro tier -- Coming soon at $19/mo with:

  • Real-time WebSocket price feeds

  • DEX data (Uniswap, Raydium, Jupiter)

  • On-chain analytics

  • Wallet and portfolio tracking

  • Higher rate limits

  • Priority support

Visit whoffagents.com for updates.

Get the Next One Before It Hits GitHub

We ship a new MCP tool or agent pattern most weeks. Subscribers get early access + the build notes that don't make it into the README. → Subscribe free at whoffagents.com

From the Team That Ships in Public

We build in the open and write up what breaks:

License

MIT

  • whoff-agents — free Claude Code skills for multi-agent workflows, from the same team. Includes context-anchor skill + Atlas Starter Kit.

Available Tools

5 tools
get_historical_pricesA

Get historical price data for a cryptocurrency over a specified number of days. Returns an ordered array of [timestamp_ms, price] pairs suitable for charting, trend analysis, backtesting, or computing metrics like volatility and drawdown. Data granularity varies automatically: 5-minute intervals for 1 day, hourly for 2-90 days, and daily for 91-365 days. Use this when you need a price series rather than a single current price. For just the current price, use get_price instead. Valid range: 1 to 365 days. Accepts common symbols or CoinGecko IDs. The server retries once with a 5-second backoff on rate limits.

Inputs: symbol (required), days, currency. Returns: result

get_market_overviewA

Get a broad snapshot of the entire cryptocurrency market. Returns total market capitalisation, 24-hour trading volume, Bitcoin dominance percentage, Ethereum dominance percentage, total number of active cryptocurrencies, the Fear and Greed index (0-100, where 0 is Extreme Fear and 100 is Extreme Greed), the top 5 gainers and top 5 losers by 24-hour price change. Use this tool when you want macro context before analysing individual tokens, or when the user asks about overall market sentiment, bull/bear conditions, or which tokens are moving most. Takes no parameters. Data is sourced from CoinGecko global endpoints and the Alternative.me Fear and Greed index.

Inputs: no named parameters. Returns: result

get_priceA

Get the current price, 24-hour change, market cap, and trading volume for a single cryptocurrency token. Use this when you need live market data for one token. For multiple tokens, prefer get_prices to avoid redundant API calls. Accepts common symbols (BTC, ETH, SOL, DOGE) or full CoinGecko IDs (bitcoin, ethereum). Prices update approximately every 60 seconds due to server-side caching. Returns an error JSON if the token is not found or the CoinGecko API is temporarily unavailable.

Inputs: symbol (required), currency. Returns: result

get_pricesA

Get current prices for up to 50 cryptocurrency tokens in a single request. Always prefer this over multiple get_price calls when you need data for two or more tokens. It batches them into one CoinGecko API call and is significantly more efficient. Returns the same fields as get_price for each token. Symbols that cannot be resolved are omitted from the result without failing the entire batch. Accepts common symbols (BTC, ETH, SOL) or CoinGecko IDs. Returns an error if the list is empty or exceeds 50 tokens.

Inputs: symbols (required), currency. Returns: result

get_token_infoA

Get detailed fundamental information about a cryptocurrency token, including its project description, official website, market cap rank, all-time high and all-time low prices with dates, circulating and total supply, fully diluted valuation, and price change percentages over 24 hours, 7 days, and 30 days. Use this when you need more than just a current price, for example for fundamental analysis, understanding a token history, or answering questions about supply dynamics. For just the current price or market cap, use get_price instead. Accepts common symbols (BTC, ETH) or CoinGecko IDs. Project descriptions are truncated to 500 characters.

Inputs: symbol (required). Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.6/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: get_price for a single current price, get_prices for batch, get_market_overview for macro data, get_token_info for fundamentals, get_historical_prices for time series. No overlap.

    Naming Consistency5/5

    All tools follow the 'get_X' pattern with descriptive noun phrases (price, prices, market_overview, token_info, historical_prices), providing excellent consistency.

    Tool Count5/5

    5 tools is well-scoped for a crypto data server, covering the essential endpoints without being excessive or insufficient.

    Completeness4/5

    The set covers current prices (single/batch), market overview, token fundamentals, and historical data. Minor gaps like token search or comparison tools, but core CRUD-like operations are present.

    Related MCP Connectors

    • Your agent needs crypto prices it can rely on — spot, ranked market tables, history, OHLC, per-venue tickers, and what is trending right now. **What you can ask for** • "What is the price of these 20 tokens in USD and EUR right now?" • "Give me the top 100 by market cap with 24h and 7d change." • "Chart this coin's price over the last year, hourly." • "Where does this token trade, and at what spread per venue?" • "What is trending on CoinGecko today?" **How to use it** Point any MCP client at https://mcp.aisa.one/crypto-market-data/mcp and sign in with OAuth — there is no key to create or paste. 21 CoinGecko tools: simple price and token price by contract, supported currencies, coin list and detail, ranked markets, history, market charts and ranges, OHLC, per-coin tickers, categories, exchanges and their tickers, token data and charts, and trending. **It is also a door to the rest** The same login reaches 26 sources and 580+ operations. Price the token here, then ask the same agent what X is posting about it — without adding a second server. **What it costs** Finding and inspecting an operation is free. Running one is billed per call at API prices, with no seat and no monthly minimum, and every call takes max_price_usd so an agent cannot overspend by accident. **Where else it reaches** https://mcp.aisa.one/finance/mcp for equities, crypto and prediction markets in one place.

    • Unlock the power of real-time cryptocurrency data with our Crypto Price Insights MCP server.

    • Financial data MCP server for Claude, ChatGPT, Cursor and Codex. Real-time stock quotes, financial statements, options flow, SEC filings, insider trades, 13F holdings, macro data and market news from gloom.sh, the open-source Bloomberg Terminal alternative.

      https://api.gloom.sh/mcp
    • Unofficial CoinGecko MCP — wraps CoinGecko free API (no auth required)

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Real-time crypto market intelligence MCP. Get prices, trending coins, market overview, top coins by market cap, and portfolio value — all through natural language in Claude, Cursor, or any MCP client
      6
      MIT
    • A
      license
      A
      quality
      F
      maintenance
      An MCP server for CoinGecko that connects any MCP-compatible client to free crypto market data, providing tools for prices, market caps, trending coins, historical data, and global stats.
      8
      52 npm
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      MCP server providing market data for 15,000+ cryptocurrencies including prices, history, trends, and deep coin metadata via CoinGecko.
      130 npm
      1
      Apache 2.0