coingecko-mcp-server

CoinGecko MCP Server

An MCP server for CoinGecko — connect any MCP-compatible client to free crypto market data.

What is this?

An MCP (Model Context Protocol) server that gives AI assistants and agents access to CoinGecko's free crypto market data API — prices, market caps, trending coins, historical data, and global stats — through natural language.

Use it with Claude Desktop, Cursor, Windsurf, Cline, Continue, or any MCP-compatible client to ask questions about crypto markets, compare tokens, and track prices.

Why use this?

• No API key required — CoinGecko's free tier works out of the box (rate-limited to ~27 calls/min)
• 8 built-in tools — covers the most common crypto data queries
• Clean markdown output — results read naturally in chat
• Rate-limited automatically — respects free tier limits, retries on 429

Tools

Tool	Description
search_coins	Search for cryptocurrencies by name or symbol
get_prices	Get current prices, market caps, and 24h changes for one or more coins
get_market_overview	Get top N coins by market cap with full stats
get_trending	Get currently trending coins (last 24h search volume)
get_coin_details	Get detailed info about a specific coin (description, links, market data, categories)
get_price_history	Get historical price data (daily, weekly, monthly, yearly)
get_global_stats	Get global crypto market stats (total MCap, BTC dominance, active cryptos)
get_token_price_comparison	Compare prices and stats of multiple tokens side-by-side

Quick Start

1. Install

npm install -g coingecko-mcp-server

Or run directly with npx:

npx -y coingecko-mcp-server

2. Configure your MCP client

Add to your MCP client config (e.g. claude_desktop_config.json):

{
  "mcpServers": {
    "coingecko": {
      "command": "npx",
      "args": ["-y", "coingecko-mcp-server"]
    }
  }
}

Or with global install:

{
  "mcpServers": {
    "coingecko": {
      "command": "coingecko-mcp-server"
    }
  }
}

3. Use it

Ask your AI assistant things like:

• "What's the current price of Bitcoin and Ethereum?"
• "Show me the top 10 coins by market cap"
• "What's trending on CoinGecko right now?"
• "Compare Solana, Avalanche, and Polkadot"
• "How has Bitcoin performed over the last 30 days?"
• "What's the total crypto market cap and BTC dominance?"
• "Search for AI-related crypto tokens"
• "Tell me about Chainlink — categories, links, market data"

Example Output

get_trending

🔥 Trending Coins (last 24h):

1. Bitcoin (BTC) — Rank #1 | MCap: $1,340.2B | 24h: +2.1%
2. Ethereum (ETH) — Rank #2 | MCap: $412.8B | 24h: +1.8%
3. Solana (SOL) — Rank #5 | MCap: $78.4B | 24h: +4.3%
...

get_token_price_comparison

Token Comparison (USD):

| Coin | Price | MCap | 24h | 7d | Vol |
|------|-------|------|-----|-----|-----|
| Bitcoin (BTC) | $67,234 | $1,340.2B | +2.1% | +5.3% | $28,400M |
| Ethereum (ETH) | $3,456 | $412.8B | +1.8% | +3.1% | $14,200M |
| Solana (SOL) | $178.5 | $78.4B | +4.3% | +12.1% | $3,800M |

Requirements

• Node.js 18+
• No API key needed (CoinGecko free tier)

Rate Limits

The server automatically rate-limits requests to ~27 calls/minute to stay within CoinGecko's free tier. If you have a CoinGecko Pro API key, you can set the COINGECKO_API_KEY environment variable for higher limits:

{
  "mcpServers": {
    "coingecko": {
      "command": "coingecko-mcp-server",
      "env": {
        "COINGECKO_API_KEY": "your_key_here"
      }
    }
  }
}

Development

git clone https://github.com/nova/coingecko-mcp-server.git
cd coingecko-mcp-server
npm install
npm run build
npm start

License

MIT