MCP Directory

CoinGecko MCP Server

Official

Official CoinGecko server for real-time and historical crypto prices, market data, and on-chain analytics.

Verified
stdio (local)
API key
TypeScript

Add to your client

Copy the config for your MCP client and paste it into its config file.

Install / run
npx -y @coingecko/coingecko-mcp

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

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

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

About CoinGecko MCP Server

The CoinGecko MCP Server is CoinGecko's official server (part of the coingecko-typescript SDK repo, published as @coingecko/coingecko-mcp) that turns the CoinGecko REST API into MCP tools for AI assistants and agents. It exposes endpoint-mapped tools so a model can fetch real-time prices, market data, historical OHLC, trending coins, categories, NFT data, and on-chain analytics.

On-chain coverage comes from CoinGecko's GeckoTerminal data, giving access to millions of tokens, pools, and DEX data across 200+ networks alongside the 15k+ coins from the core API. Because the API surface is large, the server can map one tool per endpoint or run in a dynamic-discovery mode where the model finds and invokes endpoints on demand.

It is unusually flexible on deployment. You can run it locally over stdio with npx -y @coingecko/coingecko-mcp, or connect to CoinGecko's hosted remote server over streamable HTTP / SSE. There is even a public keyless remote endpoint (https://mcp.api.coingecko.com/mcp) for quick experimentation, plus authenticated Demo and Pro endpoints for higher rate limits.

Tools & capabilities (10)

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).

NFT tools

NFT collection data including floor prices and market stats.

dynamic endpoint discovery

Optional mode that lets the model discover and invoke any CoinGecko API endpoint rather than exposing one fixed tool per endpoint.

When to use it

  • You want an AI assistant to quote live crypto prices and market caps for specific coins
  • You need historical OHLC or market-chart data for charting or backtesting analysis
  • You are tracking trending coins, gainers/losers, or category performance
  • You want on-chain DEX, pool, and token analytics across many networks via GeckoTerminal
  • You want to experiment with CoinGecko data quickly with no API key using the public remote endpoint

Quick setup

  1. 1Decide between the local server (npx) or the hosted remote endpoint
  2. 2For local: add `npx -y @coingecko/coingecko-mcp` to your MCP client config
  3. 3For authenticated access, get a free Demo or Pro API key from CoinGecko and set `COINGECKO_DEMO_API_KEY` (or `COINGECKO_PRO_API_KEY`) and `COINGECKO_ENVIRONMENT` to `demo` or `pro`
  4. 4For the remote option, point your client at `https://mcp.api.coingecko.com/mcp` (keyless) or `https://mcp.pro-api.coingecko.com/mcp` (Pro)
  5. 5Restart the client and ask for a coin price to verify the connection

Security notes

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 FAQ

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.

Does it include on-chain / DEX data?

Yes. On-chain analytics are powered by GeckoTerminal, covering pools, tokens, and DEXes across 200+ networks in addition to the core coin and market data.

Is it official?

Yes. It is published by CoinGecko as `@coingecko/coingecko-mcp` within their `coingecko-typescript` SDK repository and is Apache-2.0 licensed.

Alternatives to CoinGecko MCP Server

Official Stripe server for payments, customers, subscriptions, invoices, and billing via natural language.

Featured
Verified
stdio (local)
API key
TypeScript
12 tools
Updated 1 month agoRepo

Coinbase's AgentKit MCP extension for onchain actions: transfers, swaps, and contract calls.

Verified
stdio (local)
API key
TypeScript
9 tools
Updated 1 month agoRepo

Alpaca's official trading server for stocks, ETFs, options, and crypto in plain English.

Verified
stdio (local)
API key
Python
12 tools
Updated 26 days agoRepo