> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coingecko.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CoinGecko MCP Server

> Connect AI agents and LLM clients to live CoinGecko crypto data using the Model Context Protocol (MCP). Supports 76+ tools for prices, market data, onchain analytics, NFTs, and more.

<img src="https://mintcdn.com/coingecko/b3Fla9Sm0TsVrJN4/images/reference/63500e3-image.png?fit=max&auto=format&n=b3Fla9Sm0TsVrJN4&q=85&s=02ca3c105f2e635a6f2c7d055295f0d0" alt="" width="1200" height="628" data-path="images/reference/63500e3-image.png" />

<Warning>
  **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](https://docs.google.com/forms/d/e/1FAIpQLSf06DOBauiZ8XS6NwWXUUwhFluH7jKHOAa3y4VsrkyGbLKyfA/viewform).
</Warning>

## Overview

The official CoinGecko MCP Server makes live crypto data available to your AI models and applications. With 76+ tools covering 1M+ assets across 200+ networks, you can empower your agents to:

* **Access real-time market data**: Get aggregated prices, market cap, and trading volume for 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.

👉 See the [full list of MCP tools](/docs/ai-agent-hub/mcp-tools) available to your AI agents.

## Choose Your Server

| Server Type                  | Best For                                                                                                                                                                                             | Endpoints                             | Status      |
| ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------- | ----------- |
| **Remote (Public, Keyless)** | First-time users, quick tests, and basic queries. Connect instantly without registration. Subject to shared rate limits.                                                                             | Primary: `/mcp`<br />Fallback: `/sse` | Public Beta |
| **Remote (Authenticated)**   | Scalable apps and AI agent integrations. Unlocks 76+ tools under your Demo/Pro plan with higher, reliable rate limits. Get your API key [here](https://www.coingecko.com/en/api/pricing).            | Primary: `/mcp`<br />Fallback: `/sse` | Public Beta |
| **Local Server**             | Local development and desktop AI apps. Build and test even without an active internet connection. Requires a Demo or Pro API key. Get your API key [here](https://www.coingecko.com/en/api/pricing). | Local instance                        | Beta        |

## Server URLs and Transports

Each remote server supports two transports. **Streamable HTTP is the primary transport** recommended for all modern MCP clients.

| Server     | Streamable HTTP (recommended)           | SSE (fallback)                          |
| ---------- | --------------------------------------- | --------------------------------------- |
| **Public** | `https://mcp.api.coingecko.com/mcp`     | `https://mcp.api.coingecko.com/sse`     |
| **Pro**    | `https://mcp.pro-api.coingecko.com/mcp` | `https://mcp.pro-api.coingecko.com/sse` |

<Note>
  Most modern MCP clients support Streamable HTTP natively. Use the SSE fallback only if your client does not support it or you experience connection issues.
</Note>

## Quick Start

<Note>
  ### Prerequisites

  * Make sure your device has `node` installed. You can download it from [nodejs.org/download](https://nodejs.org/en/download)
  * An MCP-compatible client — see [Supported Clients](#supported-clients) below.
</Note>

### Remote Server (Public)

The easiest way to get started — no API key required. Add the following to your client's MCP config file.

<Note>
  The config file name and location depend on your client. Find yours at [modelcontextprotocol.io/quickstart](https://modelcontextprotocol.io/quickstart/user#2-add-the-filesystem-mcp-server).
</Note>

<CodeGroup>
  ```json Native URL (recommended) theme={null}
  {
    "mcpServers": {
      "coingecko_mcp": {
        "url": "https://mcp.api.coingecko.com/mcp"
      }
    }
  }
  ```

  ```json Legacy (mcp-remote bridge) theme={null}
  {
    "mcpServers": {
      "coingecko_mcp": {
        "command": "npx",
        "args": [
          "-y",
          "mcp-remote",
          "https://mcp.api.coingecko.com/mcp"
        ]
      }
    }
  }
  ```
</CodeGroup>

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

<iframe className="w-full aspect-video rounded-xl" src="https://www.youtube.com/embed/PDYJvtKok0E" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />

### Remote Server (Authenticated)

To access more tools and higher rate limits, use your CoinGecko API key with our hosted BYOK server. Get your API key [here](https://www.coingecko.com/en/api/pricing).

**Step 1: Add the configuration**

<CodeGroup>
  ```json Native URL (recommended) theme={null}
  {
    "mcpServers": {
      "coingecko_mcp": {
        "url": "https://mcp.pro-api.coingecko.com/mcp"
      }
    }
  }
  ```

  ```json Legacy (mcp-remote bridge) theme={null}
  {
    "mcpServers": {
      "coingecko_mcp": {
        "command": "npx",
        "args": [
          "-y",
          "mcp-remote",
          "https://mcp.pro-api.coingecko.com/mcp"
        ]
      }
    }
  }
  ```
</CodeGroup>

**Step 2: Authorize your MCP access**

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

<img src="https://mintcdn.com/coingecko/b3Fla9Sm0TsVrJN4/images/reference/0fd54e7-image.png?fit=max&auto=format&n=b3Fla9Sm0TsVrJN4&q=85&s=c40d3876ad3b12c0c3177231e8642bf7" alt="" width="1627" height="1611" data-path="images/reference/0fd54e7-image.png" />

* 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](https://www.coingecko.com/en/api/pricing).

* You can also toggle between dynamic/static tools here. Learn more in [Advanced Configuration](#advanced-configuration).

### Local Server

For local development and maximum control, run the MCP server directly on your machine.

<CodeGroup>
  ```json Pro API key theme={null}
  {
    "mcpServers": {
      "coingecko_mcp_local": {
        "command": "npx",
        "args": [
          "-y",
          "@coingecko/coingecko-mcp"
        ],
        "env": {
          "COINGECKO_PRO_API_KEY": "YOUR_PRO_API_KEY",
          "COINGECKO_ENVIRONMENT": "pro"
        }
      }
    }
  }
  ```

  ```json Demo API key theme={null}
  {
    "mcpServers": {
      "coingecko_mcp_local": {
        "command": "npx",
        "args": [
          "-y",
          "@coingecko/coingecko-mcp"
        ],
        "env": {
          "COINGECKO_DEMO_API_KEY": "YOUR_DEMO_API_KEY",
          "COINGECKO_ENVIRONMENT": "demo"
        }
      }
    }
  }
  ```
</CodeGroup>

✨ Don't have an API key yet? Get your free Demo key or upgrade to Pro — read more [here](https://www.coingecko.com/en/api/pricing).

## Supported Clients

CoinGecko MCP works with any MCP-compatible client. The following have been tested:

| Client            | Native URL Support | Setup Guide                                    |
| ----------------- | ------------------ | ---------------------------------------------- |
| Claude.ai         | Yes                | [See below](#claude-ai--claude-desktop)        |
| Claude Code       | Yes                | [Setup guide](/docs/ai-agent-hub/claude-code)  |
| Cursor            | Yes                | [Setup guide](/docs/ai-agent-hub/cursor)       |
| VS Code (Copilot) | Yes                | —                                              |
| OpenAI Codex      | Via mcp-remote     | [Setup guide](/docs/ai-agent-hub/openai-codex) |
| Gemini CLI        | Yes                | —                                              |
| Kiro              | Yes                | [Setup guide](/docs/ai-agent-hub/kiro)         |
| ChatGPT           | Yes                | [See below](#chatgpt)                          |
| Warp              | Yes                | —                                              |
| Zed               | Yes                | —                                              |
| Amp               | Yes                | —                                              |
| OpenCode          | Yes                | —                                              |

<Tip>
  Don't see your client? Any MCP-compatible client that supports remote servers should work. Use the native URL config or the mcp-remote bridge from [Quick Start](#quick-start) above.
</Tip>

<AccordionGroup>
  <Accordion title="Claude.ai / Claude Desktop">
    ### For Claude Free Users (via Claude Desktop)

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

    1. **Locate `claude_desktop_config.json`**: Follow the instructions [here](https://modelcontextprotocol.io/quickstart/user) to find the file on your system.
    2. **Add a server config**: Copy and paste one of the server configs from [Quick Start](#quick-start) above.
    3. **Restart Claude Desktop**: Close and reopen the app for the changes to take effect.

    ### For Claude Pro Users

    <Check>
      You can also follow the same steps as Free users by modifying the `claude_desktop_config.json` file.
    </Check>

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

           <img src="https://mintcdn.com/coingecko/b3Fla9Sm0TsVrJN4/images/reference/5cd6a58-image.png?fit=max&auto=format&n=b3Fla9Sm0TsVrJN4&q=85&s=73013011cc734857c113270206f71e7b" alt="" width="1606" height="1122" data-path="images/reference/5cd6a58-image.png" />

    2. Click on 'Add custom connector'.

           <img src="https://mintcdn.com/coingecko/b3Fla9Sm0TsVrJN4/images/reference/1459ea5-image.png?fit=max&auto=format&n=b3Fla9Sm0TsVrJN4&q=85&s=63c2c7bc4254c52ba263b9617aae51bd" alt="" width="1843" height="988" data-path="images/reference/1459ea5-image.png" />

    3. Enter the remote MCP server URL:

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

           <img src="https://mintcdn.com/coingecko/b3Fla9Sm0TsVrJN4/images/reference/b465d51-image.png?fit=max&auto=format&n=b3Fla9Sm0TsVrJN4&q=85&s=075452b45aa6696f046084f5a23d610b" alt="" width="1146" height="899" data-path="images/reference/b465d51-image.png" />

    4. Click 'Add', and you're ready to go!
  </Accordion>

  <Accordion title="ChatGPT">
    OpenAI ChatGPT requires [developer mode](https://platform.openai.com/docs/guides/developer-mode) to be enabled.

    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.

           <Frame>
             <img
               src="https://mintcdn.com/coingecko/-YWykcjHRtoo7cBr/images/reference/mcp-open-ai-chatgpt-1.png?fit=max&auto=format&n=-YWykcjHRtoo7cBr&q=85&s=19b9da2451dbb287b3e14bbd1bb1d6c4"
               style={{
        width: "400px", height: "auto"
       }}
               width="921"
               height="1330"
               data-path="images/reference/mcp-open-ai-chatgpt-1.png"
             />
           </Frame>

    3. Before prompting, choose **+** > More > Developer Mode > enable the CoinGecko MCP tool.

           <Frame>
             <img
               src="https://mintcdn.com/coingecko/-YWykcjHRtoo7cBr/images/reference/mcp-open-ai-chatgpt-2.png?fit=max&auto=format&n=-YWykcjHRtoo7cBr&q=85&s=2dbce0217b55c42f75bcf72b1840261c"
               style={{
        width: "500px", height: "auto"
       }}
               width="1604"
               height="404"
               data-path="images/reference/mcp-open-ai-chatgpt-2.png"
             />
           </Frame>
  </Accordion>
</AccordionGroup>

## API Plans and Rate Limits

The Public server uses **shared rate limits** across all users — suitable for development, testing, and light usage. For production or high-volume applications, use the Authenticated or Local server with your own API key.

| Feature             | Demo ([Guide here](https://support.coingecko.com/hc/en-us/articles/21880397454233-User-Guide-How-to-sign-up-for-CoinGecko-Demo-API-and-generate-an-API-key)) | Pro                                                                                                                                                                                                                                                                                                          |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Rate Limit**      | 30 calls/min                                                                                                                                                 | Starts at 500 calls/min                                                                                                                                                                                                                                                                                      |
| **Monthly Credits** | 10,000                                                                                                                                                       | Starts at 500,000                                                                                                                                                                                                                                                                                            |
| **Historical Data** | Past 1 year                                                                                                                                                  | From 2013 until now                                                                                                                                                                                                                                                                                          |
| **MCP Tools**       | Limited access                                                                                                                                               | Full access, including exclusive tools:<br />- [Top Gainers & Losers](/reference/coins-top-gainers-losers)<br />- [NFTs Collection Historical Chart](/reference/nfts-id-market-chart)<br />- [🔥 Megafilter for Pools](/reference/pools-megafilter)<br />- [Pools by Category ID](/reference/pools-category) |

🔥 Ready to upgrade? Explore [our API plans](https://www.coingecko.com/en/api/pricing).

## Advanced Configuration

### Dynamic vs. Static Tools

When running the CoinGecko MCP server, you can choose how your LLM client discovers tools:

* **Static (Default)**: The AI receives a complete list of tools and their functions upfront. Faster for specific, known tasks.
* **Dynamic**: The AI first queries the server for available tools based on a keyword search, then learns how to use them. More flexible but can be slower.

For a deeper dive, read the [official documentation](https://www.stainless.com/changelog/mcp-dynamic-tools) from Stainless.

### Using `llms.txt`

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

## Troubleshooting

<AccordionGroup>
  <Accordion title="Tools not appearing after adding config">
    Restart your MCP client completely — simply refreshing the page or starting a new conversation is not enough. The client must fully reload to discover the new server and its tools.

    Also verify:

    * The config file is saved and is valid JSON.
    * The server name (`coingecko_mcp`) does not conflict with an existing server entry.
  </Accordion>

  <Accordion title="Connection timeout or network errors">
    * Check your internet connection and verify the endpoint URL is reachable.
    * If you're on a corporate network, your firewall may be blocking the endpoint. Ask IT to whitelist `mcp.api.coingecko.com` (or `mcp.pro-api.coingecko.com`).
    * Try switching to the SSE fallback endpoint — e.g., `https://mcp.api.coingecko.com/sse`.
  </Accordion>

  <Accordion title="npx or mcp-remote errors">
    * Verify Node.js is installed: run `node --version` and `npm --version`.
    * Test mcp-remote directly: `npx mcp-remote --version`.
    * If you see permission errors, clear the npm cache: `npm cache clean --force`.
    * Consider switching to the native `"url"` config — no `npx` required — if your client supports it.
  </Accordion>

  <Accordion title="OAuth browser window not opening (Authenticated server)">
    * Ensure your client supports browser-based OAuth. Not all MCP clients do.
    * Try restarting the client — the OAuth window opens on the first connection attempt after adding the config.
    * Check that your system has a default browser configured.
  </Accordion>

  <Accordion title="Queries return unexpected or empty results">
    * Ask your AI client to **list available tools** to confirm the server is connected and tools are loaded.
    * Use natural language queries rather than function-call syntax.
    * Start with simple queries (e.g., "What is the price of Bitcoin?") before complex ones.
    * Confirm you are using the correct server tier — some tools require a Pro API key.
  </Accordion>

  <Accordion title="Where can I find debug logs?">
    | Platform                 | Log location                     |
    | ------------------------ | -------------------------------- |
    | Claude Desktop (macOS)   | `~/Library/Logs/Claude/mcp*.log` |
    | Claude Desktop (Windows) | `%LOCALAPPDATA%\Claude\Logs\`    |
    | Claude Desktop (Linux)   | `~/.local/share/Claude/logs/`    |

    For other MCP clients, check their documentation for log file locations.
  </Accordion>
</AccordionGroup>

## 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.
>
>   <img src="https://mintcdn.com/coingecko/b3Fla9Sm0TsVrJN4/images/reference/9ef35ab-image.png?fit=max&auto=format&n=b3Fla9Sm0TsVrJN4&q=85&s=76c2d6cbda125a20f3d2d4ee8bd5b840" alt="" width="2915" height="1884" data-path="images/reference/9ef35ab-image.png" />
>
> * Generate a 30-day price chart for Ethereum (ETH) against USD, showing both price and trading volume.
>
>   <img src="https://mintcdn.com/coingecko/b3Fla9Sm0TsVrJN4/images/reference/249fc22-image.png?fit=max&auto=format&n=b3Fla9Sm0TsVrJN4&q=85&s=b92c7f7e4c503e7d5b1e285f0901c850" alt="" width="2904" height="1886" data-path="images/reference/249fc22-image.png" />

### Creative and Fun Ideas

> * Create a quiz to tell me which cryptocurrency I am based on my personality.
>
>   <img src="https://mintcdn.com/coingecko/b3Fla9Sm0TsVrJN4/images/reference/fb09018-image.png?fit=max&auto=format&n=b3Fla9Sm0TsVrJN4&q=85&s=9849ef5a53aedccf2ac0c9bc39ee5953" alt="" width="2909" height="1887" data-path="images/reference/fb09018-image.png" />
>
>   Try it here: [claude.ai/public/artifacts](https://claude.ai/public/artifacts/586275b9-9ff8-4d9f-9b43-0c080f6e9c80)
>
> * Build a Wordle-style game where the answer is a crypto asset's name or symbol, like 'BITCOIN' or 'SHIBA'.
>
>   <img src="https://mintcdn.com/coingecko/b3Fla9Sm0TsVrJN4/images/reference/911e973-image.png?fit=max&auto=format&n=b3Fla9Sm0TsVrJN4&q=85&s=106f6fba2b90c2264b706535c748f323" alt="" width="2903" height="1888" data-path="images/reference/911e973-image.png" />
>
>   Try it here: [claude.ai/public/artifacts](https://claude.ai/public/artifacts/41efabb7-76b9-43c7-8349-cbbe1d52a022)

***

CoinGecko MCP Server is powered by [Stainless](https://www.stainless.com/) ✱

Have feedback, a cool idea, or need help? Reach out to `eason.lim@coingecko[dot]com` or fill in [this feedback form](https://docs.google.com/forms/d/e/1FAIpQLSf06DOBauiZ8XS6NwWXUUwhFluH7jKHOAa3y4VsrkyGbLKyfA/viewform).