crypto-data-mcp
This MCP server provides real-time cryptocurrency market data from CoinGecko for AI coding tools.
Get current price, 24-hour change, market cap, and volume for a single token.
Batch-fetch prices for up to 50 tokens in one efficient request.
Retrieve a market overview with total market cap, volume, BTC/ETH dominance, active coin count, Fear & Greed index, and top gainers/losers.
Get detailed token fundamentals including description, website, rank, ATH/ATL, supply, FDV, and 24h/7d/30d price changes.
Fetch historical price series from 1 to 365 days as timestamp/price pairs, with automatic 5-minute, hourly, or daily granularity.
Resolve common symbols or CoinGecko IDs, with 60-second caching, retry/backoff on rate limits, and graceful error handling.
Provides real-time and historical market data for Bitcoin including current price, 24-hour price changes, market capitalization, trading volume, all-time high/low statistics, and historical price charts with configurable timeframes.
Provides comprehensive market data for Ethereum including current price, multi-timeframe price changes (24h/7d/30d), market cap, circulating supply, all-time high/low prices with dates, and historical price data for charting.
Provides market data and price information for XRP including current valuation, 24-hour price movements, trading volume, market capitalization, and access to historical price charts.
crypto-data-mcp
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-mcpInstall from PyPI
pip install crypto-data-mcp
# or
uv add crypto-data-mcpFrom source
git clone https://github.com/Wh0FF24/crypto-data-mcp.git
cd crypto-data-mcp
uv syncRelated 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 |
| string | required | Token symbol (BTC, ETH, SOL) or CoinGecko ID |
| string |
| 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 |
| list[string] | required | List of symbols (max 50) |
| string |
| 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 |
| 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 |
| string | required | Token symbol or CoinGecko ID |
| int |
| Days of history (1-365) |
| string |
| 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-mcpPricing
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
Related
whoff-agents — free Claude Code skills for multi-agent workflows, from the same team. Includes context-anchor skill + Atlas Starter Kit.
Available Tools
5 toolsget_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
Scored across 5 tools
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.
All tools follow the 'get_X' pattern with descriptive noun phrases (price, prices, market_overview, token_info, historical_prices), providing excellent consistency.
5 tools is well-scoped for a crypto data server, covering the essential endpoints without being excessive or insufficient.
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.
Unofficial CoinGecko MCP — wraps CoinGecko free API (no auth required)
Related MCP Servers
- AlicenseAqualityDmaintenanceReal-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 client6MIT
- AlicenseAqualityFmaintenanceAn 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.852 npmMIT
- AlicenseNot gradedqualityBmaintenanceMCP server providing market data for 15,000+ cryptocurrencies including prices, history, trends, and deep coin metadata via CoinGecko.130 npm1Apache 2.0
- FlicenseAqualityDmaintenanceAn MCP server that enables AI agents to fetch real-time cryptocurrency prices and market data using the CoinGecko API.13-