🤖 CoinGecko MCP Server (Beta)

🚧

The CoinGecko MCP Server is currently in beta. Beta features are still a work in progress and may have bugs. Please reach out via this 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.

Getting Started

Most clients that natively support MCP can be configured using a mcp_config.json file. In these system, you just have to add the server configuration below to the file to setup an MCP Server.

• If you already have a Pro API key, we recommend you to use our local MCP server with your favourite AI applications.
• If you're new to our API and just wanna quickly try out CoinGecko MCP, you can use our Remote MCP Server (Public) easily with tools like Claude Desktop.

For Local MCP Server (requires API key):

{
  "mcpServers": {
    "coingecko_coingecko_typescript_api": {
      "command": "npx",
      "args": [
        "-y",
        "@coingecko/coingecko-mcp",
        "--client=claude",
        "--tools=dynamic"
      ],
      "env": {
        "COINGECKO_PRO_API_KEY": "My Pro API Key",
        "COINGECKO_ENVIRONMENT": "pro"
      }
    }
  }
}

• Configure the env based on your access tier:
  • For Pro API access:
    • JSON

      ...
            "env": {
              "COINGECKO_PRO_API_KEY": "My Pro API Key",
              "COINGECKO_ENVIRONMENT": "pro"
            }
      ...

  • For Demo API access
    • JSON

      ...
            "env": {
              "COINGECKO_DEMO_API_KEY": "My Demo API Key",
              "COINGECKO_ENVIRONMENT": "demo"
            }
      ...

For Public Remote MCP Server (NO API key required):

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

Detailed Guides

Quick Tips for Claude Pro users

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

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

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 form.