How to add CoinGecko MCP Server to Claude Desktop

Official CoinGecko server for real-time and historical crypto prices, market data, and on-chain analytics. Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.

Last updated June 15, 2026 · 250★ · stdio · apikey · official

Claude Desktop config for CoinGecko MCP Server

npx -y @coingecko/coingecko-mcp

{
  "mcpServers": {
    "coingecko-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@coingecko/coingecko-mcp"
      ],
      "env": {
        "COINGECKO_PRO_API_KEY": "<your-coingecko-pro-api-key>"
      }
    }
  }
}

Setup steps

1Open Claude Desktop → Settings → Developer → Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
2Paste the CoinGecko MCP Server config below under the top-level "mcpServers" key.
3Fill in any placeholder secrets (API keys, paths) in the snippet.
4Save the file, then fully quit and reopen Claude Desktop.
5Open a chat and confirm CoinGecko MCP Server's tools appear under the 🔌 tools menu.

Before you start

Node.js 20 LTS or later (for the local stdio server via npx)
Optionally a CoinGecko API key — a free Demo key (100 calls/min, 10k calls/month) or a Pro key — from the CoinGecko API pricing page; no key is needed for the public keyless remote endpoint
An MCP-compatible client such as Claude Desktop, Cursor, or VS Code

What CoinGecko MCP Server can do in Claude Desktop

get_simple_price

Returns current price for one or more coins in the requested fiat/crypto currencies.

get_coins_markets

Returns market data (price, market cap, volume, 24h change) for a list of coins.

get_coins_id

Returns full metadata for a coin: description, logo, links, contract addresses, and market data.

get_coins_id_ohlc

Returns historical OHLC candlestick data for a coin over a time range.

get_coins_id_market_chart

Returns historical price, market cap, and volume time series for a coin.

get_search_trending

Returns trending coins, NFTs, and categories on CoinGecko.

get_coins_categories

Lists crypto categories (DeFi, Meme, Layer 1, AI agents, etc.) with market data.

onchain / GeckoTerminal tools

On-chain analytics endpoints for networks, DEXes, pools, and tokens powered by GeckoTerminal (8M+ tokens across 200+ networks).

Security

Read-only market-data access with no funds at risk; the keyless public remote has shared rate limits unsuitable for production. Keep any Pro API key in env, not in args.

CoinGecko MCP Server + Claude Desktop FAQ

Where is the Claude Desktop config file?

Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_config.json. Paste the CoinGecko MCP Server config there under the "mcpServers" key and restart the client.

Is CoinGecko MCP Server safe to use with Claude Desktop?

Read-only market-data access with no funds at risk; the keyless public remote has shared rate limits unsuitable for production. Keep any Pro API key in env, not in args.

Do I need an API key?

Not for the public keyless remote endpoint at `https://mcp.api.coingecko.com/mcp`. The local server and the authenticated Demo/Pro remote endpoints use a CoinGecko API key for dedicated rate limits.

Is there a free tier?

Yes. CoinGecko's Demo API plan is free for all users with a stable 100 calls/min and a 10,000-call monthly cap; you can generate a Demo key from the API pricing page.

Can I run it remotely instead of locally?

Yes. CoinGecko hosts a remote MCP server over streamable HTTP / SSE, including a keyless public endpoint and authenticated Demo and Pro endpoints, so you do not have to run the npx process locally.

View repo Full CoinGecko MCP Server page