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

Welcome to the CoinGecko MCP Server!CoinGecko MCP Server is currently in Beta. We're constantly improving, and your feedback is crucial. Please share any thoughts or suggestions via this feedback form.
π Overview
The official CoinGecko MCP Server is now live, making CoinGecko data readily available to your AI models and applications. With the CoinGecko MCP, you can empower your agents to:
- Access real-time market data: Get aggregated prices, market cap, and trading volume for over 15k+ coins on CoinGecko, integrated across 1,000+ exchanges.
- Dive into onchain analytics: Query onchain DEX price and liquidity data for more than 8M tokens across 200+ networks via GeckoTerminal.
- Discover market trends: Instantly find trending coins, new token listings, top gainers/losers, and popular NFT collections.
- Retrieve rich metadata: Pull essential details like project descriptions, logos, social links, contract addresses, security info, and more.
- Analyze historical performance: Access historical price, market data, and OHLCV for any cryptocurrency.
- Explore crypto categories: Effortlessly list coins within specific sectors like Meme, DeFi, Layer 1, AI agent, and more.

MCP Demo with Claude Desktop
π₯ Getting Started
Connecting your AI to CoinGecko is simple. We offer several MCP server options to fit your needs, from keyless access for testing to authenticated connections for production applications.
Most MCP-compatible clients, like Claude Desktop, Gemini CLI, and Cursor, can be configured using a simple JSON file (e.g., claude_desktop_config.json
)
Prerequisites
- Make sure your device has
node
installed. You can download it from nodejs.org/download
Which MCP Server Should You Use?
Here's a breakdown of the available options to help you choose the right one:
MCP Server Type | Best For | Setup Details |
---|---|---|
Remote Server (Public, Keyless) |
| mcp.api.coingecko |
Remote Server |
| mcp.pro-api.coingecko |
Local Server |
| npmjs/coingecko-mcp |
Remote Server (Public, Keyless)
The easiest way to get started. Just add the following to your client's mcp_config.json
file.
Client-Specific ConfigThe file name and location depend on your client. Find your config file here: modelcontextprotocol.io/quickstart
Add the following configuration to your mcp_config.json
:
{
"mcpServers": {
"coingecko_mcp": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.api.coingecko.com/sse"
]
}
}
}
Here's a quick 2-minute tutorial for setting up the public server with Claude Desktop:
Remote Server (Authenticated)
To access more tools and higher rate limits, use your CoinGecko API key with our hosted "Bring Your Own Key" (BYOK) server. Get your API key here
Step 1: Add the configuration
Add the following configuration to your mcp_config.json
:
{
"mcpServers": {
"coingecko_mcp": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.pro-api.coingecko.com/sse"
]
}
}
}
Step 2: Authorize your MCP access
After adding the config, the first time your client tries to use the CoinGecko MCP, a new browser tab will open, redirecting you to our authentication page:

-
Simply paste in your CoinGecko API key, and authorize to link your key to the MCP session.
β¨ Don't have an API key yet? Upgrade to Pro today! Read more here.
-
You can also toggle between dynamic/static tools here. Learn more about Dynamic Tools.
Local Server (API Key Required)
For local development and maximum control, run the MCP server directly on your machine. This method offers the rate limits based on your API plan.
{
"mcpServers": {
"coingecko_mcp_local": {
"command": "npx",
"args": [
"-y",
"@coingecko/coingecko-mcp"
],
"env": {
"COINGECKO_PRO_API_KEY": "YOUR_PRO_API_KEY",
"COINGECKO_ENVIRONMENT": "pro"
}
}
}
}
β¨ Don't have an API key yet? Get your free Demo key or upgrade to Pro! Read more here.
- Configure the
env
based on your API key tier:- Pro API access:
... "env": { "COINGECKO_PRO_API_KEY": "YOUR_PRO_API_KEY", "COINGECKO_ENVIRONMENT": "pro" } ...
- Demo API access:
... "env": { "COINGECKO_DEMO_API_KEY": "YOUR_DEMO_API_KEY", "COINGECKO_ENVIRONMENT": "demo" } ...
- Pro API access:
Join our MCP Hackathon to win amazing prizes!
π Connecting with Claude
Connecting CoinGecko MCP to Claude is straightforward. The method varies slightly depending on your Claude plan.
For Claude Free Users (via Claude Desktop)
You must use the Claude Desktop app and modify the configuration file.
- Locate
claude_desktop_config.json
: Follow the instructions here to find the file on your system. - Add a server config: Copy and paste one of the server configs above that matches your use case.
- Restart Claude Desktop: Close and reopen the app for the changes to take effect.
For Claude Pro Users
TipsYou can also follow the same steps as the Free users by modifying the
claude_desktop_config.json
file.
-
In Claude (claude.ai or the Desktop app), click on 'Add connectors' in your chat.
-
Click on 'Add custom connector'
-
Remote MCP server URL:
- Keyless access:
https://mcp.api.coingecko.com/sse
- Authenticated access (BYOK):
https://mcp.pro-api.coingecko.com/sse
- Keyless access:
-
Click on 'Add', and you're ready to go!
π‘ Example Prompts
Tap into the full potential of CoinGecko data βΒ use these prompts to kickstart your next AI build.
Simple Queries
- What is the current price of Bitcoin in USD?
- What is the market cap of Ethereum?
- What are the top 3 trending coins on CoinGecko right now?
- What are the top AI coins on GeckoTerminal now?
- What is the floor price of the Pudgy Penguins NFT collection?
Advanced Queries
Show me the current top 10 cryptocurrencies by market cap. Include 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.
![]()
Creative and Fun Ideas
Create a quiz to tell me which cryptocurrency I am based on my personality.
![]()
Try it here: claude.ai/public/artifacts
Build a Wordle-style game where the answer is a crypto asset's name or symbol, like 'BITCOIN' or 'SHIBA'.
![]()
Try it here: claude.ai/public/artifacts
βοΈ Tips
API Key Differences (Demo vs. Pro)
Choosing between a Demo and Pro key for your MCP server impacts your access to data and tools.
Feature | Demo β see our guide | Pro |
---|---|---|
Rate Limit | 30 calls/min | Starts at 500 calls/min |
Monthly Credits | 10,000 | Starts at 500,000 |
Historical Data | Past 1 year | From 2013 until now |
MCP Tools | Limited access | Full access, including exclusive tools: |
π₯ Ready to upgrade? Explore our API plans.
Dynamic vs. Static Tools
When running our CoinGecko MCP server, you can choose how the LLM client discovers tools.
- Static (Default): The AI is given a complete list of tools and their functions upfront. This is faster for specific, known tasks.
- Dynamic: The AI first asks the server for available tools based on a keyword search, then learns how to use them. This is flexible but can be slower.
For a deeper dive, read the official documentation from Stainless.
Using llms.txt
llms.txt
To help AI models interact with CoinGecko data effectively, we provide an llms.txt
file at docs.coingecko.com/llms.txt. This file gives models context on how to best query our API, ensuring more accurate and efficient data retrieval. We recommend utilizing this in your integrations.
CoinGecko MCP Server is powered by Stainless β±
Have feedback, a cool idea, or need help? Reach out to soonaik@coingecko[dot]com
or fill in this feedback form.