​

📕 Overview

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

MCP Demo with Claude Desktop

​

🔥 Getting Started

​

Which MCP Server Should You Use?

​

🔗 Endpoint Options

​

Primary Endpoint (HTTP Streaming)

• Public Server: https://mcp.api.coingecko.com/mcp
• Pro Server: https://mcp.pro-api.coingecko.com/mcp
• Uses HTTP streaming protocol for real-time data transfer.
• Recommended for most modern MCP clients.

​

Alternative Endpoint (SSE — Server-Sent Events)

• Public Server: https://mcp.api.coingecko.com/sse
• Pro Server: https://mcp.pro-api.coingecko.com/sse
• Uses Server-Sent Events for compatibility.
• Use this if you encounter connection issues with the primary endpoint.

​

Remote Server (Public, Keyless)

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

​

Remote Server (Authenticated)

​

Step 1: Add the configuration

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

​

Step 2: Authorize your MCP access

• 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)

{
  "mcpServers": {
    "coingecko_mcp_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 API key tier:
  • Pro API access:
    JSON

    Copy

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

  • Demo API access:
    JSON

    Copy

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

​

🚀 Connecting with Claude

​

For Claude Free Users (via Claude Desktop)

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

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/mcp
   • Authenticated access (BYOK): https://mcp.pro-api.coingecko.com/mcp
   
4. Click on ‘Add’, and you’re ready to go!

​

🚀 Connecting with ChatGPT

1. Open your profile > Connectors > Advanced Settings > Toggle Developer Mode On
2. In the Connectors modal, choose “Create” and enter the CoinGecko MCP server info
   
3. Before prompting, choose ”+” > More > Developer Mode > CoinGecko MCP tool must be turned on
   

​

💡 Example Prompts

​

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)

​

Dynamic vs. Static 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.

​

Using llms.txt