How to add CoinGecko MCP Server to Cursor

Official CoinGecko server for real-time and historical crypto prices, market data, and on-chain analytics. Paste the config into ~/.cursor/mcp.json and restart Cursor.

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

Cursor 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 Cursor → Settings → MCP → Add new MCP server (or edit ~/.cursor/mcp.json directly).
2Paste the CoinGecko MCP Server config below into the "mcpServers" object.
3Fill in placeholder secrets, then save.
4Cursor reloads MCP servers automatically — check Settings → MCP for a green status dot.
5Ask Cursor to use one of CoinGecko MCP Server's tools to confirm it's connected.

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 Cursor

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 + Cursor FAQ

Where is the Cursor config file?

Cursor reads MCP servers from ~/.cursor/mcp.json. Paste the CoinGecko MCP Server config there under the "mcpServers" key and restart the client.

Is CoinGecko MCP Server safe to use with Cursor?

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