> ## 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

> Connect AI agents to real-time crypto data via the CoinGecko MCP Server

<Frame>
  <img src="https://mintcdn.com/coingecko/i9l2MT4etZGYjSx8/assets/images/cg-mcp-hero.png?fit=max&auto=format&n=i9l2MT4etZGYjSx8&q=85&s=141978717c61c4e4bbe01b9a0d237dae" noZoom width="1200" height="628" data-path="assets/images/cg-mcp-hero.png" />
</Frame>

<CardGroup cols={3}>
  <Card title="Real-Time Prices" icon="bolt">
    Live and historical prices, market caps, and trading volumes.
  </Card>

  <Card title="Market Intelligence" icon="chart-line">
    Exchange data, trending coins, and market analytics.
  </Card>

  <Card title="Onchain Analytics" icon="link">
    Token and pool data across DEXes and networks.
  </Card>
</CardGroup>

## Servers

| Server                                | Endpoint                                                                             | Details                                                                                                                                     |
| ------------------------------------- | ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------- |
| **Free (Keyless)**                    | `https://mcp.api.coingecko.com/mcp`                                                  | No API key needed.<br />Shared rate limits.                                                                                                 |
| **Use your API key**                  | <span style={{whiteSpace: 'nowrap'}}>`https://mcp.pro-api.coingecko.com/mcp`</span>  | [CoinGecko API key](https://www.coingecko.com/en/api/pricing) required.<br />Higher limits, full tool set.                                  |
| **[Local](#setup-your-local-server)** | [`@coingecko/coingecko-mcp`](https://www.npmjs.com/package/@coingecko/coingecko-mcp) | Pro or Demo API key.<br />Runs on your machine. [GitHub →](https://github.com/coingecko/coingecko-typescript/tree/main/packages/mcp-server) |

<Tip>
  * Both servers support `/mcp` (Streamable HTTP) and `/sse` (Server-Sent Events).
  * Always prefer `/mcp` — only fall back to `/sse` if your client doesn't support Streamable HTTP.
</Tip>

> See the full list of [available tools and methods](/ai-integration/mcp-tools).

## Connect to Remote Server

<Tabs>
  <Tab title="Claude Web">
    <Steps>
      <Step title="Add connector">
        Go to [Settings > Connectors](https://claude.ai/customize/connectors?modal=add-custom-connector) on claude.ai.

        <Frame>
          <img src="https://mintcdn.com/coingecko/i9l2MT4etZGYjSx8/assets/images/claude-web-add-connector.png?fit=max&auto=format&n=i9l2MT4etZGYjSx8&q=85&s=a84535ddeb7ba690a2678e4bd7600d17" width="1233" height="838" data-path="assets/images/claude-web-add-connector.png" />
        </Frame>
      </Step>

      <Step title="Enter server details">
        * **Name:** `CoinGecko`
        * **Remote MCP server URL:**

          | Server               | URL                                     |
          | -------------------- | --------------------------------------- |
          | **Free (Keyless)**   | `https://mcp.api.coingecko.com/mcp`     |
          | **Use your API key** | `https://mcp.pro-api.coingecko.com/mcp` |

        Click **Add**.

        Using your API key opens a browser tab to enter it on first connection.<br />
        [Get an API key →](https://www.coingecko.com/en/api/pricing)
      </Step>
    </Steps>
  </Tab>

  <Tab title="Claude Desktop">
    <Steps>
      <Step title="Open config">
        Edit `claude_desktop_config.json` ([find this file](https://modelcontextprotocol.io/docs/develop/connect-local-servers)).
      </Step>

      <Step title="Add server">
        <CodeGroup>
          ```json Free (Keyless) theme={null}
          {
            "mcpServers": {
              "coingecko": {
                "command": "npx",
                "args": [
                  "mcp-remote",
                  "https://mcp.api.coingecko.com/mcp"
                ]
              }
            }
          }
          ```

          ```json Use your API key theme={null}
          {
            "mcpServers": {
              "coingecko": {
                "command": "npx",
                "args": [
                  "mcp-remote",
                  "https://mcp.pro-api.coingecko.com/mcp"
                ]
              }
            }
          }
          ```
        </CodeGroup>

        Requires [Node.js](https://nodejs.org/en/download).

        Using your API key opens a browser tab to enter it on first connection.<br />
        [Get an API key →](https://www.coingecko.com/en/api/pricing)
      </Step>

      <Step title="Restart Claude Desktop">
        Restart to load the new server.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Claude Code">
    <Steps>
      <Step title="Add server">
        <CodeGroup>
          ```bash Free (Keyless) theme={null}
          claude mcp add --transport http \
            coingecko https://mcp.api.coingecko.com/mcp
          ```

          ```bash Use your API key theme={null}
          claude mcp add --transport http \
            coingecko https://mcp.pro-api.coingecko.com/mcp
          ```
        </CodeGroup>

        <Note>
          If **using your API key**, run `/mcp` inside a Claude Code session to authenticate:

          ```bash Example Session theme={null}
          ❯ /mcp

            Manage MCP servers
            1 server

            ❯ coingecko · △ needs authentication

            ↑↓ to navigate · Enter to confirm · Esc to cancel
          ```
        </Note>
      </Step>

      <Step title="Verify">
        ```bash theme={null}
        claude mcp list
        ```
      </Step>
    </Steps>
  </Tab>
</Tabs>

## Setup your Local Server

Run the server on your machine using [`@coingecko/coingecko-mcp`](https://www.npmjs.com/package/@coingecko/coingecko-mcp). Requires [Node.js](https://nodejs.org/en/download).

<Tabs>
  <Tab title="Claude Desktop">
    <Steps>
      <Step title="Open config">
        Edit `claude_desktop_config.json` ([find this file](https://modelcontextprotocol.io/docs/develop/connect-local-servers)).
      </Step>

      <Step title="Add server">
        <CodeGroup>
          ```json Pro API Key theme={null}
          {
            "mcpServers": {
              "coingecko": {
                "command": "npx",
                "args": [
                  "-y",
                  "@coingecko/coingecko-mcp"
                ],
                "env": {
                  "COINGECKO_PRO_API_KEY": "YOUR_API_KEY",
                  "COINGECKO_ENVIRONMENT": "pro"
                }
              }
            }
          }
          ```

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

        > Replace `YOUR_API_KEY` with your actual API key.<br />
        > [Get a free Demo key or upgrade to Pro →](https://www.coingecko.com/en/api/pricing)
      </Step>

      <Step title="Restart Claude Desktop">
        Restart to load the new server.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Claude Code">
    <Steps>
      <Step title="Add server">
        <CodeGroup>
          ```bash Pro API Key theme={null}
          claude mcp add coingecko \
            -e COINGECKO_PRO_API_KEY=YOUR_API_KEY \
            -e COINGECKO_ENVIRONMENT=pro \
            -- npx -y @coingecko/coingecko-mcp
          ```

          ```bash Demo API Key theme={null}
          claude mcp add coingecko \
            -e COINGECKO_DEMO_API_KEY=YOUR_API_KEY \
            -e COINGECKO_ENVIRONMENT=demo \
            -- npx -y @coingecko/coingecko-mcp
          ```
        </CodeGroup>

        > Replace `YOUR_API_KEY` with your actual API key.<br />
        > [Get a free Demo key or upgrade to Pro →](https://www.coingecko.com/en/api/pricing)
      </Step>

      <Step title="Verify">
        ```bash theme={null}
        claude mcp list
        ```
      </Step>
    </Steps>
  </Tab>
</Tabs>

## FAQ

<AccordionGroup>
  <Accordion title="What's the difference between Free and API key servers?">
    The Free server requires no authentication and uses shared rate limits. The API key server gives you higher rate limits and access to the full tool set — including premium endpoints available on your [CoinGecko plan](https://www.coingecko.com/en/api/pricing).
  </Accordion>

  <Accordion title="When should I use a local server instead of remote?">
    Use a local server if you need full control over the runtime, want to avoid browser-based OAuth, or prefer passing your API key via environment variables instead of the browser auth flow.
  </Accordion>

  <Accordion title="What's the difference between /mcp and /sse endpoints?">
    `/mcp` uses Streamable HTTP — the newer, recommended transport. `/sse` uses Server-Sent Events, an older protocol. Always prefer `/mcp` unless your client only supports SSE.
  </Accordion>

  <Accordion title="Which AI clients are supported?">
    Any client that supports the [Model Context Protocol](https://modelcontextprotocol.io) — including Claude (Web, Desktop, Code), Cursor, Windsurf, and others. The setup steps on this page use Claude as an example, but the endpoints and configs work with any MCP-compatible client.
  </Accordion>

  <Accordion title="Do MCP requests count toward my API rate limit?">
    Yes. Each tool call the AI makes through MCP triggers one or more API requests, which count toward your plan's rate limit and credits.
  </Accordion>
</AccordionGroup>

***

<Card title="Share Feedback" icon="comment" href="https://docs.google.com/forms/d/e/1FAIpQLSf06DOBauiZ8XS6NwWXUUwhFluH7jKHOAa3y4VsrkyGbLKyfA/viewform">
  Help us improve MCP — share your suggestions and feedback.
</Card>