​

📕 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?

​

Remote Server (Public, Keyless)

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

​

Remote Server (Authenticated)

​

Step 1: Add the configuration

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

​

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

​

💡 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