CoinGecko MCP Server

🚧
CoinGecko MCP Server is currently in beta and may have bugs. Please reach out via this 👉 feedback form 👈, if you have any feedback or suggestion.

📕 Overview

The official CoinGecko MCP Server is now live, making CoinGecko data readily available to AI models and applications. With CoinGecko MCP, you can easily:

get aggregated crypto price and market data of 15k+ coins on CoinGecko, integrated across 1,000+ exchanges.
get on-chain DEX crypto price and liquidity data of more than 8M tokens GeckoTerminal, across 200 networks.
discover trending coins, NFTs, categories, top gainers and new coins on CoinGecko
discover top, trending, new pools and tokens on GeckoTerminal
get metadata: image, links, description, categories, contract addresses, security info, and more.
get historical price, market data, OHLCV of all cryptocurrencies.
get list of coins of any categories like memecoin, DeFi, layer 1, AI agent, and more.

Connecting Your AI to Real-World Crypto Data via MCP

Understand Real-Time Market Context: Provide your LLMs with the latest market capitalization, prices, volumes, and trends for informed decision-making.
Execute Data Queries: Enable your AI to "ask" for specific crypto data and receive structured responses.
Build Smarter Agents: Develop AI agents that can access, process, and act upon CoinGecko's vast cryptocurrency dataset.
Streamline Tool Usage: Integrate CoinGecko's data capabilities as a robust "tool" for any MCP-compatible AI client.

CoinGecko MCP Server Demo — CoinGecko MCP - Endless Possibilities.

🔥 Getting Started

Most MCP-compatible clients can be configured using a JSON config file (commonly named mcp_config.json, but this varies by client — e.g. claude_desktop_config.json for Claude). Just add the appropriate server configuration to get started.

If you're new to our API, use the Public Remote MCP Server 1️⃣ — NO API key required. Works out of the box with tools like Claude Desktop.
If you have a Pro or Demo API key, run a Local MCP Server 2️⃣ for more control and higher rate limits. Just point your client config to the local path and include your credentials.

📘
Important Notes

Make sure your device has node installed. You can download it from https://nodejs.org/en/download

For more info, feel free to check out the tutorial video below.

1️⃣ For Public Remote MCP Server (No API key required):

Add the following configurations into mcp_config.json
- ‼️ This depends on your LLM client
  eg. Claude usesclaude_desktop_config.json. You can locate the config file here: https://modelcontextprotocol.io/quickstart/user#2-add-the-filesystem-mcp-server

{
  "mcpServers": {
    "coingecko_api_remote": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.api.coingecko.com/sse"
      ]
    }
  }
}

Here's a quick 3-minute tutorial guide to setup CoinGecko MCP with Claude Desktop (Free plan):

2️⃣ For Local MCP Server (requires Pro/Demo API key):

Add the following configurations into mcp_config.json
- ‼️ This depends on your LLM client
  eg. Claude usesclaude_desktop_config.json. You can locate the config file here: https://modelcontextprotocol.io/quickstart/user#2-add-the-filesystem-mcp-server

{
  "mcpServers": {
    "coingecko_api_local": {
      "command": "npx",
      "args": [
        "-y",
        "@coingecko/coingecko-mcp"
      ],
      "env": {
        "COINGECKO_PRO_API_KEY": "YOUR_PRO_API_KEY",
        "COINGECKO_ENVIRONMENT": "pro"
      }
    }
  }
}

Configure the env based on your access tier 👇

Replace YOUR_**_API_KEY with your CoinGecko API key

For Pro API access:

...
      "env": {
        "COINGECKO_PRO_API_KEY": "YOUR_PRO_API_KEY",
        "COINGECKO_ENVIRONMENT": "pro"
      }
...

For Demo API access:

...
      "env": {
        "COINGECKO_DEMO_API_KEY": "YOUR_DEMO_API_KEY",
        "COINGECKO_ENVIRONMENT": "demo"
      }
...

What do we offer now?

MCP Server	Details & Use Case	Integration Guide
Remote MCP Server - Public	Connect instantly to our hosted server. This keyless option is excellent for testing remote connections and basic public-facing applications. API Key authentication not required, rate limited for shared use.	mcp.api.coingecko.com
Local MCP Server	Run an instance directly on your machine. This is ideal for local development, desktop AI applications (e.g., with Claude Desktop), and personal projects. Supports CoinGecko Demo and Pro-API key authentication for higher limits. Get your API keys here.	CoinGecko GitHub
Remote MCP Server - Authenticated	This hosted solution will offer higher rate limits and enhanced reliability by leveraging your CoinGecko Demo or Pro-API key. Ideal for production applications and scalable cloud deployments.	Coming Soon! Join waitlist 👉 here.

Quick Tips for Claude Pro users

You may enable our Remote MCP directly via the chat interface or Settings.

Click on 'Add Integrations'
Add Server Name 'CoinGecko MCP' and MCP URL 'https://mcp.api.coingecko.com/sse'

You can now access CoinGecko MCP via Claude.ai / Claude Desktop!

Example Calls:

Simple Prompts

What is the current price of Bitcoin in USD?
What is the market cap of Ethereum? How much has Solana changed in the last 24 hours? What was the all-time high price for Cardano (ADA)?

What are the top 3 trending coins on CoinGecko right now?
What are the top 3 trending coins on GeckoTerminal now? What are the top DEX pools on Solana? What are the top AI coins on CoinGecko now?

What is the total cryptocurrency market capitalization today?
What is the circulating supply of XRP? What is the floor price of pudgy penguin NFT? How many holders does TRUMP token have?

Advanced / Artifacts

Show me the current top 5 cryptocurrencies by market cap, including their price, 24h change, and total volume. Display this in an interactive table.

Generate a 30-day price chart for Ethereum (ETH) against USD, showing both price and trading volume."

Compare Bitcoin, Ethereum, and Solana across key metrics like current price, market cap, 24h volume, and 7-day price change. Present this in a clear, side-by-side comparison.

Show me the top 3 cryptocurrencies in the 'Decentralized Finance (DeFi)' category and the 'Gaming' category, including their current price, market cap, and 7-day change. Organize them by category in a dynamic list

Find me cryptocurrencies that are:

In the 'Layer 1' category

Have a market cap between $1 billion and $10 billion

Have had a positive 7-day price change.

Show me their symbol, name, market cap, and 7-day change.

Perform technical analysis based on past X days of Bitcoin price

Wild Ideas / Artifacts

Crypto Battle Royale - Coins fight based on market data
Crypto Slot Machine - Spin for coins, odds based on real volatility

Crypto Weather Station - Market conditions displayed as actual weather patterns
Crypto Lava Lamp - Hypnotic bubbles that move based on price movements

Crypto Personality Test - "Which crypto are you?" quiz with real market traits
Crypto Horoscope - Daily predictions based on technical analysis

Crypto Price Prediction Contest
Crypto MarketCap Ranking Guessing Game

DeFi Casino - Roulette, blackjack with live market odds
Crypto Horse Racing - Coins race, speed based on volume/momentum

Market Heartbeat - EKG-style monitor showing market pulse
Price Symphony - Turn charts into actual music

Tips:

Beginner guide for MCP Server

If you're totally new to MCP Server, and wish to learn how to use it with Claude Desktop, here's a recommended official quickstart guide: https://modelcontextprotocol.io/quickstart/user

Limitations with Claude

If you're using the Public Remote MCP Server with the free version of Claude, you may hit message limits easily. Please consider the following options:

Subscribe to Claude Pro plan that allows higher message and usage limit
OR use Local MCP Server.

Dynamic Tools or Static Tools

If you're using the Local MCP with Claude, you're given the option to enable tools=dynamic.

Dynamic Tools: exposing a set of tools to dynamically discover and invoke endpoints from the API
Static Tools: exposing one tool per endpoint, and filtering as necessary

Both dynamic and static tools will have different performance depending on your specific use cases. If you only expect to use a few specific tools/endpoints, you're encouraged to try remove tools=dynamic option. Read more here.

Using `llms.txt`

To further empower your AI models and ensure they interact with CoinGecko data responsibly and effectively, we provide an llms.txt file. This file, located at https://docs.coingecko.com/llms.txt, follows a standard protocol that helps Large Language Models and other AI agents understand how to best query and utilize our data, providing valuable context for responsible AI behavior and data interpretation. We highly recommend utilizing this resource in your MCP or AI application integrations.

CoinGecko MCP Server is powered by Stainless.

Have any feedback or suggestion? Shoot them here: soonaik@coingecko[dot]com or fill in this 👉 feedback form 👈.