CoinGecko MCP Server

What is CoinGecko MCP Server?

CoinGecko MCP Server is CoinGecko's official hosted MCP endpoint that gives AI assistants real-time and historical crypto market data. This free, keyless version at https://mcp.api.coingecko.com/mcp needs no API key or sign-in.

CoinGecko is one of the largest independent crypto data aggregators, tracking coins, tokens, exchanges, NFTs and onchain DEX pools. Its MCP server is aimed at developers, traders, analysts and anyone who wants an assistant such as Claude or Cursor to answer market questions with live numbers instead of stale training data.

How to use CoinGecko MCP Server?

CoinGecko runs three variants of its MCP server:

• Free (keyless): https://mcp.api.coingecko.com/mcp. No authentication, shared rate limits. This is the endpoint listed on this page.
• API key (remote): https://mcp.pro-api.coingecko.com/mcp. Requires a CoinGecko API key and offers higher limits and the full tool set. On first connection a browser tab opens so you can enter your key.
• Local: the npm package @coingecko/coingecko-mcp, run on your machine with a Pro or Demo key.

Both remote servers also offer an /sse endpoint, but CoinGecko's docs say to always prefer /mcp.

Claude Code

claude mcp add --transport http coingecko https://mcp.api.coingecko.com/mcp

Run claude mcp list to confirm it is connected. To switch to your own key, add the mcp.pro-api.coingecko.com URL instead and run /mcp inside a session to authenticate.

Claude Desktop and claude.ai

Open Settings, then Connectors, choose "Add custom connector", set the name to CoinGecko and paste https://mcp.api.coingecko.com/mcp. The keyless server needs no further steps. CoinGecko's docs also show a Claude Desktop config that wraps the URL with npx mcp-remote for setups that need it.

Cursor

{
  "mcpServers": {
    "coingecko": {
      "url": "https://mcp.api.coingecko.com/mcp"
    }
  }
}

VS Code

{
  "servers": {
    "coingecko": {
      "type": "http",
      "url": "https://mcp.api.coingecko.com/mcp"
    }
  }
}

Key features of CoinGecko MCP Server

• Official server from CoinGecko, documented on docs.coingecko.com.
• Keyless remote endpoint, so you can try it in seconds without creating an account.
• Real-time and historical prices, market caps and trading volumes.
• Market intelligence such as exchange data, trending coins and market analytics.
• Onchain analytics for tokens and liquidity pools across DEXes and networks.
• Code-execution design: the agent writes short TypeScript against the official CoinGecko SDK, so a single call can combine several API requests.
• Upgrade path to a key-based server with higher limits, or a local npm server.

CoinGecko MCP Server tools

The keyless server exposes two tools that work together:

• Discover: search_docs searches the CoinGecko SDK documentation for methods, parameters and usage examples. Agents call it first to find the right endpoint for a question.
• Run: execute runs JavaScript or TypeScript that defines an async run(client) function. The function receives an initialized CoinGecko SDK client (for example client.simple.price.get(...)), and the tool returns whatever the function returns plus any console.log output.

Because the agent writes code rather than calling one fixed tool per endpoint, it can fetch, filter and compute in one step, such as pulling prices for ten coins and ranking them by 24-hour change.

Use cases of CoinGecko MCP Server

• Quick price checks: "What is the current price of Bitcoin and Ethereum in USD and EUR?"
• Market overviews: "Show me the top trending coins on CoinGecko right now."
• Historical analysis: "Get Solana's daily closing price for the last 90 days and summarize the trend."
• DeFi research: "Find the most liquid pools for this token on onchain DEXes."
• Building crypto features: let a coding agent explore the CoinGecko SDK with search_docs before writing integration code for your app.

Troubleshooting CoinGecko MCP Server

• Rate-limit errors: the keyless server uses shared rate limits. For heavier use, switch to https://mcp.pro-api.coingecko.com/mcp with your own API key.
• A tool or endpoint seems missing: the API-key server offers the full tool set, including premium endpoints available on your plan.
• Client does not support Streamable HTTP: use the /sse endpoint, or the mcp-remote wrapper shown in CoinGecko's docs.
• Usage counts against your plan: on the key-based server, each tool call can trigger one or more API requests that count toward your rate limit and credits.