Title: CoinGecko MCP - CoinGecko API
URL Source: https://docs.coingecko.com/docs/mcp-server
Markdown Content:
Documentation Index
Fetch the complete documentation index at:/llms.txt
Use this file to discover all available pages before exploring further.
Skip to main content
CoinGecko API home page
Search...
Ctrl K
Search...
Navigation
MCP
CoinGecko MCP
OverviewAI IntegrationPro API ReferenceDemo API ReferenceWebSocketWebhooksChangelog
Core Tools
Coding Agents
Platforms
On this page
Core Tools
MCP
CoinGecko MCP
Copy page Copy page
Connect AI agents to real-time crypto data via the CoinGecko MCP Server
Copy page Copy page
Real-Time Prices
Live and historical prices, market caps, and trading volumes.
Market Intelligence
Exchange data, trending coins, and market analytics.
Onchain Analytics
Token and pool data across DEXes and networks.
Servers
| Server | Endpoint | Details |
|---|
| Free (Keyless) | https://mcp.api.coingecko.com/mcp | No API key needed. Shared rate limits. |
| Use your API key | https://mcp.pro-api.coingecko.com/mcp | CoinGecko API key required. Higher limits, full tool set. |
| Local | @coingecko/coingecko-mcp | Pro or Demo API key. Runs on your machine. GitHub → |
- Both servers support
/mcp (Streamable HTTP) and /sse (Server-Sent Events).
- Always prefer
/mcp — only fall back to /sse if your client doesn’t support Streamable HTTP.
See the full list of available tools and methods.
Connect to Remote Server
- Claude Web
- Claude Desktop
- Claude Code
1
Add connector
Go to Settings > Connectors on claude.ai.
2
Enter server details
- Name:
CoinGecko
- Remote MCP server URL:| Server | URL |
| --- | --- |
| Free (Keyless) |
https://mcp.api.coingecko.com/mcp |
| Use your API key | https://mcp.pro-api.coingecko.com/mcp |
Click Add.Using your API key opens a browser tab to enter it on first connection.
Get an API key →
1
Open config
Edit claude_desktop_config.json (find this file).
2
Add server
Free (Keyless)
Use your API key
{
"mcpServers": {
"coingecko": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.api.coingecko.com/mcp"
]
}
}
}
{
"mcpServers": {
"coingecko": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.pro-api.coingecko.com/mcp"
]
}
}
}
Requires Node.js.Using your API key opens a browser tab to enter it on first connection.
Get an API key →
3
Restart Claude Desktop
Restart to load the new server.
1
Add server
Free (Keyless)
Use your API key
claude mcp add --transport http \
coingecko https://mcp.api.coingecko.com/mcp
claude mcp add --transport http \
coingecko https://mcp.pro-api.coingecko.com/mcp
If using your API key, run /mcp inside a Claude Code session to authenticate:
Example Session
❯ /mcp
Manage MCP servers
1 server
❯ coingecko · △ needs authentication
↑↓ to navigate · Enter to confirm · Esc to cancel
2
Verify
claude mcp list
Setup your Local Server
Run the server on your machine using @coingecko/coingecko-mcp. Requires Node.js.
- Claude Desktop
- Claude Code
1
Open config
Edit claude_desktop_config.json (find this file).
2
Add server
Pro API Key
Demo API Key
{
"mcpServers": {
"coingecko": {
"command": "npx",
"args": [
"-y",
"@coingecko/coingecko-mcp"
],
"env": {
"COINGECKO_PRO_API_KEY": "YOUR_API_KEY",
"COINGECKO_ENVIRONMENT": "pro"
}
}
}
}
{
"mcpServers": {
"coingecko": {
"command": "npx",
"args": [
"-y",
"@coingecko/coingecko-mcp"
],
"env": {
"COINGECKO_DEMO_API_KEY": "YOUR_API_KEY",
"COINGECKO_ENVIRONMENT": "demo"
}
}
}
}
Replace YOUR_API_KEY with your actual API key.
Get a free Demo key or upgrade to Pro →
3
Restart Claude Desktop
Restart to load the new server.
1
Add server
Pro API Key
Demo API Key
claude mcp add coingecko \
-e COINGECKO_PRO_API_KEY=YOUR_API_KEY \
-e COINGECKO_ENVIRONMENT=pro \
-- npx -y @coingecko/coingecko-mcp
claude mcp add coingecko \
-e COINGECKO_DEMO_API_KEY=YOUR_API_KEY \
-e COINGECKO_ENVIRONMENT=demo \
-- npx -y @coingecko/coingecko-mcp
Replace YOUR_API_KEY with your actual API key.
Get a free Demo key or upgrade to Pro →
2
Verify
claude mcp list
FAQ
What's the difference between Free and API key servers?
The Free server requires no authentication and uses shared rate limits. The API key server gives you higher rate limits and access to the full tool set — including premium endpoints available on your CoinGecko plan.
When should I use a local server instead of remote?
Use a local server if you need full control over the runtime, want to avoid browser-based OAuth, or prefer passing your API key via environment variables instead of the browser auth flow.
What's the difference between /mcp and /sse endpoints?
/mcp uses Streamable HTTP — the newer, recommended transport. /sse uses Server-Sent Events, an older protocol. Always prefer /mcp unless your client only supports SSE.
Which AI clients are supported?
Any client that supports the Model Context Protocol — including Claude (Web, Desktop, Code), Cursor, Windsurf, and others. The setup steps on this page use Claude as an example, but the endpoints and configs work with any MCP-compatible client.
Do MCP requests count toward my API rate limit?
Yes. Each tool call the AI makes through MCP triggers one or more API requests, which count toward your plan’s rate limit and credits.
Was this page helpful?
Yes No
OverviewDocs MCP
githubxlinkedin
Powered by This documentation is built and hosted on Mintlify, a developer documentation platform
Cookie Settings
We process your personal information to measure and improve our sites and service, to assist our marketing campaigns and to provide personalised content and advertising. By clicking the button on the right, you can exercise your privacy rights. For more information see our privacy noticeMore information
Your Privacy Rights Accept Cookies
Do Not Sell or Share My Personal Data
When you visit our website, we store cookies on your browser to collect information. The information collected might relate to you, your preferences or your device, and is mostly used to make the site work as you expect it to and to provide a more personalized web experience. However, you can choose not to allow certain types of cookies, which may impact your experience of the site and the services we are able to offer. Click on the different category headings to find out more and change our default settings according to your preference. You cannot opt-out of our First Party Strictly Necessary Cookies as they are deployed in order to ensure the proper functioning of our website (such as prompting the cookie banner and remembering your settings, to log into your account, to redirect you when you log out, etc.). For more information about the First and Third Party Cookies used please follow this link.
More information
Allow All
Manage Consent Preferences
Strictly Necessary Cookies
Always Active
These cookies are necessary for the website to function and cannot be switched off in our systems. They are usually only set in response to actions made by you which amount to a request for services, such as setting your privacy preferences, logging in or filling in forms. You can set your browser to block or alert you about these cookies, but some parts of the site will not then work. These cookies do not store any personally identifiable information.
Opt Out of Sale of Sharing/Targeted Advertising
As a California consumer, you have the right to opt-out from the sale or sharing of your personal information at any time across business platform, services, businesses and devices. You can opt-out of the sale and sharing of your personal information by using this toggle switch. As a Virginia, Utah, Colorado and Connecticut consumer, you have the right to opt-out from the sale of your personal data and the processing of your personal data for targeted advertising. You can opt-out of the sale of your personal data and targeted advertising by using this toggle switch. For more information on your rights as a United States consumer see our privacy notice.
Cookie List
Clear
Apply Cancel
Consent Leg.Interest
Confirm My Choices