
CoinGecko MCP Server
OfficialOfficial CoinGecko server for real-time and historical crypto prices, market data, and on-chain analytics.
Add to your client
Copy the config for your MCP client and paste it into its config file.
npx -y @coingecko/coingecko-mcpPaste 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_priceReturns current price for one or more coins in the requested fiat/crypto currencies.
get_coins_marketsReturns market data (price, market cap, volume, 24h change) for a list of coins.
get_coins_idReturns full metadata for a coin: description, logo, links, contract addresses, and market data.
get_coins_id_ohlcReturns historical OHLC candlestick data for a coin over a time range.
get_coins_id_market_chartReturns historical price, market cap, and volume time series for a coin.
get_search_trendingReturns trending coins, NFTs, and categories on CoinGecko.
get_coins_categoriesLists crypto categories (DeFi, Meme, Layer 1, AI agents, etc.) with market data.
onchain / GeckoTerminal toolsOn-chain analytics endpoints for networks, DEXes, pools, and tokens powered by GeckoTerminal (8M+ tokens across 200+ networks).
NFT toolsNFT collection data including floor prices and market stats.
dynamic endpoint discoveryOptional 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
- 1Decide between the local server (npx) or the hosted remote endpoint
- 2For local: add `npx -y @coingecko/coingecko-mcp` to your MCP client config
- 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`
- 4For the remote option, point your client at `https://mcp.api.coingecko.com/mcp` (keyless) or `https://mcp.pro-api.coingecko.com/mcp` (Pro)
- 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.
Coinbase's AgentKit MCP extension for onchain actions: transfers, swaps, and contract calls.
Alpaca's official trading server for stocks, ETFs, options, and crypto in plain English.
Compare CoinGecko MCP Server with: