🚧

Welcome to the CoinGecko MCP Server!

CoinGecko MCP Server is currently in Beta. We're constantly improving, and your feedback is crucial. Please share any thoughts or suggestions via this feedback form.

📕 Overview

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

• Access real-time market data: Get aggregated prices, market cap, and trading volume for over 15k+ coins on CoinGecko, integrated across 1,000+ exchanges.
• Dive into onchain analytics: Query onchain DEX price and liquidity data for more than 8M tokens across 200+ networks via GeckoTerminal.
• Discover market trends: Instantly find trending coins, new token listings, top gainers/losers, and popular NFT collections.
• Retrieve rich metadata: Pull essential details like project descriptions, logos, social links, contract addresses, security info, and more.
• Analyze historical performance: Access historical price, market data, and OHLCV for any cryptocurrency.
• Explore crypto categories: Effortlessly list coins within specific sectors like Meme, DeFi, Layer 1, AI agent, and more.

🔥 Getting Started

Connecting your AI to CoinGecko is simple. We offer several MCP server options to fit your needs, from keyless access for testing to authenticated connections for production applications.

Most MCP-compatible clients, like Claude Desktop, Gemini CLI, and Cursor, can be configured using a simple JSON file (e.g., claude_desktop_config.json)

📘

Prerequisites

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

Which MCP Server Should You Use?

Here's a breakdown of the available options to help you choose the right one:

Remote Server (Public, Keyless)

The easiest way to get started. Just add the following to your client's mcp_config.json file.

📘

Client-Specific Config

The file name and location depend on your client. Find your config file here: modelcontextprotocol.io/quickstart

Add the following configuration to your mcp_config.json:

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

Here's a quick 2-minute tutorial for setting up the public server with Claude Desktop:

Remote Server (Authenticated)

To access more tools and higher rate limits, use your CoinGecko API key with our hosted "Bring Your Own Key" (BYOK) server. Get your API key here

Step 1: Add the configuration

Add the following configuration to your mcp_config.json:

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

Step 2: Authorize your MCP access

After adding the config, the first time your client tries to use the CoinGecko MCP, a new browser tab will open, redirecting you to our authentication page:

• Simply paste in your CoinGecko API key, and authorize to link your key to the MCP session.

  ✨ Don't have an API key yet? Upgrade to Pro today! Read more here.

• You can also toggle between dynamic/static tools here. Learn more about Dynamic Tools.

Local Server (API Key Required)

For local development and maximum control, run the MCP server directly on your machine. This method offers the rate limits based on your API plan.

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

✨ Don't have an API key yet? Get your free Demo key or upgrade to Pro! Read more here.

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

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

  • Demo API access:
    JSON

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

Join our MCP Hackathon to win amazing prizes!

🚀 Connecting with Claude

Connecting CoinGecko MCP to Claude is straightforward. The method varies slightly depending on your Claude plan.

For Claude Free Users (via Claude Desktop)

You must use the Claude Desktop app and modify the configuration file.

1. Locateclaude_desktop_config.json: Follow the instructions here to find the file on your system.
2. Add a server config: Copy and paste one of the server configs above that matches your use case.
3. Restart Claude Desktop: Close and reopen the app for the changes to take effect.

For Claude Pro Users

👍

Tips

You can also follow the same steps as the Free users by modifying the claude_desktop_config.json file.

1. In Claude (claude.ai or the Desktop app), click on 'Add connectors' in your chat.

   

2. Click on 'Add custom connector'

   

3. Remote MCP server URL:

   • Keyless access: https://mcp.api.coingecko.com/sse
   • Authenticated access (BYOK): https://mcp.pro-api.coingecko.com/sse
   

4. Click on 'Add', and you're ready to go!

💡 Example Prompts

Tap into the full potential of CoinGecko data — use these prompts to kickstart your next AI build.

Simple Queries

• What is the current price of Bitcoin in USD?
• What is the market cap of Ethereum?
• What are the top 3 trending coins on CoinGecko right now?
• What are the top AI coins on GeckoTerminal now?
• What is the floor price of the Pudgy Penguins NFT collection?

Advanced Queries

• Show me the current top 10 cryptocurrencies by market cap. Include 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.

  

Creative and Fun Ideas

• Create a quiz to tell me which cryptocurrency I am based on my personality.

  

  Try it here: claude.ai/public/artifacts

• Build a Wordle-style game where the answer is a crypto asset's name or symbol, like 'BITCOIN' or 'SHIBA'.

  

  Try it here: claude.ai/public/artifacts

⚙️ Tips

API Key Differences (Demo vs. Pro)

Choosing between a Demo and Pro key for your MCP server impacts your access to data and tools.

🔥 Ready to upgrade? Explore our API plans.

Dynamic vs. Static Tools

When running our CoinGecko MCP server, you can choose how the LLM client discovers tools.

• Static (Default): The AI is given a complete list of tools and their functions upfront. This is faster for specific, known tasks.
• Dynamic: The AI first asks the server for available tools based on a keyword search, then learns how to use them. This is flexible but can be slower.

For a deeper dive, read the official documentation from Stainless.

Using llms.txt

To help AI models interact with CoinGecko data effectively, we provide an llms.txt file at docs.coingecko.com/llms.txt. This file gives models context on how to best query our API, ensuring more accurate and efficient data retrieval. We recommend utilizing this in your integrations.

CoinGecko MCP Server is powered by Stainless ✱

Have feedback, a cool idea, or need help? Reach out to soonaik@coingecko[dot]com or fill in this feedback form.