MCP Server for Crypto Price & Market Data. MCP (Model Context Procotol) is an open standard that allows Large Language Models (LLMs) and other AI agents to securely and intelligently interact with external data sources and tools.

The CoinGecko MCP Server is currently in beta. Beta features are still a work in progress and may have bugs. Please reach out via this form, if you have any feedback or suggestion.
Overview
The official CoinGecko MCP Server is now live, making CoinGecko data readily available to AI models and applications. With CoinGecko MCP, you can easily:
- get aggregated crypto price and market data of 15k+ coins on CoinGecko, integrated across 1,000+ exchanges.
- get on-chain DEX crypto price and liquidity data of more than 8M tokens GeckoTerminal, across 200 networks.
- discover trending coins, NFTs, categories, top gainers and new coins on CoinGecko
- discover top, trending, new pools and tokens on GeckoTerminal
- get metadata: image, links, description, categories, contract addresses, security info, and more.
- get historical price, market data, OHLCV of all cryptocurrencies.
- get list of coins of any categories like memecoin, DeFi, layer 1, AI agent, and more.

MCP Demo with Claude Desktop
Connecting Your AI to Real-World Crypto Data via MCP
- Understand Real-Time Market Context: Provide your LLMs with the latest market capitalization, prices, volumes, and trends for informed decision-making.
- Execute Data Queries: Enable your AI to "ask" for specific crypto data and receive structured responses.
- Build Smarter Agents: Develop AI agents that can access, process, and act upon CoinGecko's vast cryptocurrency dataset.
- Streamline Tool Usage: Integrate CoinGecko's data capabilities as a robust "tool" for any MCP-compatible AI client.

CoinGecko MCP - Endless Possibilities.
Getting Started
Most clients that natively support MCP can be configured using a mcp_config.json file. In these system, you just have to add the server configuration below to the file to setup an MCP Server.
- If you already have a Pro API key, we recommend you to use our local MCP server with your favourite AI applications.
- If you're new to our API and just wanna quickly try out CoinGecko MCP, you can use our Remote MCP Server (Public) easily with tools like Claude Desktop.
For Local MCP Server (requires API key):
{
"mcpServers": {
"coingecko_coingecko_typescript_api": {
"command": "npx",
"args": [
"-y",
"@coingecko/coingecko-mcp",
"--client=claude",
"--tools=dynamic"
],
"env": {
"COINGECKO_PRO_API_KEY": "My Pro API Key",
"COINGECKO_ENVIRONMENT": "pro"
}
}
}
}
- Configure the
env
based on your access tier:- For Pro API access:
-
... "env": { "COINGECKO_PRO_API_KEY": "My Pro API Key", "COINGECKO_ENVIRONMENT": "pro" } ...
-
- For Demo API access
-
... "env": { "COINGECKO_DEMO_API_KEY": "My Demo API Key", "COINGECKO_ENVIRONMENT": "demo" } ...
-
- For Pro API access:
For Public Remote MCP Server (NO API key required):
{
"mcpServers": {
"coingecko": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.api.coingecko.com/sse"
]
}
}
}
Detailed Guides
MCP Server | Details & Use Case | Integration Guide |
---|---|---|
Local MCP Server |
| CoinGecko GitHub |
Remote MCP Server - Public |
| mcp.api.coingecko.com |
Remote MCP Server - Authenticated |
| Coming Soon! |
Quick Tips for Claude Pro users
You may enable our Remote MCP directly via the chat interface or Settings.
- Click on 'Add Integrations'
- Add Server Name 'CoinGecko MCP' and MCP URL 'https://mcp.api.coingecko.com/sse'

Click on 'Add Integrations'

Insert MCP Name and Server URL

You can now access CoinGecko MCP via Claude.ai / Claude Desktop!
Example Calls:
Simple Prompts
What is the current price of Bitcoin in USD?
What is the market cap of Ethereum? How much has Solana changed in the last 24 hours? What was the all-time high price for Cardano (ADA)?What are the top 3 trending coins on CoinGecko right now?
What are the top 3 trending coins on GeckoTerminal now? What are the top DEX pools on Solana? What are the top AI coins on CoinGecko now?What is the total cryptocurrency market capitalization today?
What is the circulating supply of XRP? What is the floor price of pudgy penguin NFT? How many holders does TRUMP token have?
Advanced / Artifacts
Show me the current top 5 cryptocurrencies by market cap, including their price, 24h change, and total volume. Display this in an interactive table.
Generate a 30-day price chart for Ethereum (ETH) against USD, showing both price and trading volume."
Compare Bitcoin, Ethereum, and Solana across key metrics like current price, market cap, 24h volume, and 7-day price change. Present this in a clear, side-by-side comparison.
Show me the top 3 cryptocurrencies in the 'Decentralized Finance (DeFi)' category and the 'Gaming' category, including their current price, market cap, and 7-day change. Organize them by category in a dynamic list
Find me cryptocurrencies that are:
- In the 'Layer 1' category
- Have a market cap between $1 billion and $10 billion
- Have had a positive 7-day price change.
- Show me their symbol, name, market cap, and 7-day change.
Perform technical analysis based on past X days of Bitcoin price
Wild Ideas / Artifacts
Crypto Battle Royale - Coins fight based on market data
Crypto Slot Machine - Spin for coins, odds based on real volatilityCrypto Weather Station - Market conditions displayed as actual weather patterns
Crypto Lava Lamp - Hypnotic bubbles that move based on price movementsCrypto Personality Test - "Which crypto are you?" quiz with real market traits
Crypto Horoscope - Daily predictions based on technical analysisCrypto Price Prediction Contest
Crypto MarketCap Ranking Guessing GameDeFi Casino - Roulette, blackjack with live market odds
Crypto Horse Racing - Coins race, speed based on volume/momentumMarket Heartbeat - EKG-style monitor showing market pulse
Price Symphony - Turn charts into actual music
Tips:
Beginner guide for MCP Server
If you're totally new to MCP Server, and wish to learn how to use it with Claude Desktop, here's a recommended official quickstart guide: https://modelcontextprotocol.io/quickstart/user
Limitations with Claude
If you're using the Public Remote MCP Server with the free version of Claude, you may hit message limits easily. Please consider the following options:
- Subscribe to Claude Pro plan that allows higher message and usage limit
- OR use Local MCP Server.
Dynamic Tools or Static Tools
If you're using the Local MCP with Claude, you're given the option to enable tools=dynamic
.
- Dynamic Tools: exposing a set of tools to dynamically discover and invoke endpoints from the API
- Static Tools: exposing one tool per endpoint, and filtering as necessary
Both dynamic and static tools will have different performance depending on your specific use cases. If you only expect to use a few specific tools/endpoints, you're encouraged to try remove tools=dynamic
option. Read more here.
Using llms.txt
llms.txt
To further empower your AI models and ensure they interact with CoinGecko data responsibly and effectively, we provide an llms.txt
file. This file, located at https://docs.coingecko.com/llms.txt, follows a standard protocol that helps Large Language Models and other AI agents understand how to best query and utilize our data, providing valuable context for responsible AI behavior and data interpretation. We highly recommend utilizing this resource in your MCP or AI application integrations.
CoinGecko MCP Server is powered by Stainless.
Have any feedback or suggestion? Shoot them here: soonaik@coingecko[dot]com or fill in this form.