It just works, bring your CoinGecko API key and prompt away!
Use this URL in your MCP client configuration to connect directly to the server.
Connect once. Access everything. Bitcoin prices, DeFi pools, NFT collections, market data across a million cryptocurrencies.
🌐 Beta Public Access: This server is publicly available and require your own CoinGecko API key.
Getting Started
Visit the CoinGecko MCP documentation for a step-by-step guide on how to connect with this MCP.
If you are using Claude Pro, you may refer to the connectors guide as another method to connect with the MCP.
What This Server Provides
Your AI doesn't just know about crypto – it lives in it. Real-time prices become as natural as asking the time. Historical charts appear with a thought. Market analysis flows like conversation.
🚀 Ready to use: No setup required – just connect to our hosted server and start querying live crypto data immediately. Works with Claude Desktop, n8n, and any MCP-compatible application.
Capabilities
Comprehensive cryptocurrency data access through a single, powerful interface.
💰 Real-time Pricing
Get instant access to current prices, market caps, and trading volumes across thousands of cryptocurrencies
📊 Market Analytics
Comprehensive market data including rankings, trends, and statistical analysis tools
📈 Historical Data
Access historical price charts, OHLCV data, and long-term market trend analysis
🔍 Search & Discovery
Powerful search capabilities to find cryptocurrencies, trending coins, and emerging projects
🎨 NFT Analytics
Complete NFT collection data including floor prices, trading volumes, and marketplace statistics
⛓️ DeFi & On-chain
Explore DeFi pools, liquidity data, token analytics, and multi-chain network information
🔄 Live Updates
Real-time data streams with automatic updates and event-driven notifications
Quick Start
Get up and running in minutes with our simple configuration process.
Prerequisites
- MCP-compatible client – Claude Desktop, n8n, or other MCP-enabled applications
- Node.js and npx – Required for the mcp-remote package
Integration Instructions
How to connect this MCP server to your favorite clients.
Claude.ai
- Open Claude Web
- Go to Settings → Integrations
- Click "+ Add Integration"
- Add the MCP server URL:
https://mcp.pro-api.coingecko.com/sse
Claude Desktop
Claude Desktop requires using the mcp-remote
package to connect to remote MCP servers:
- Edit your Claude Desktop configuration file:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:
%APPDATA%\\Claude\\claude_desktop_config.json
- macOS:
- Add the following configuration:
{ "mcpServers": { "coingecko_coingecko_typescript_api": { "command": "npx", "args": ["-y", "mcp-remote@latest", "https://mcp.pro-api.coingecko.com/sse"] } } }
- Restart Claude Desktop to see the MCP server connection (look for the hammer icon)
Cursor
- Edit your Cursor MCP configuration file at
~/.cursor/mcp.json
- Add the following configuration:
{ "mcpServers": { "coingecko_coingecko_typescript_api": { "command": "npx", "args": ["-y", "mcp-remote@latest", "https://mcp.pro-api.coingecko.com/sse"] } } }
Windsurf
- Edit your Windsurf configuration file at
~/.codeium/windsurf/mcp_config.json
- Add the following configuration:
{ "mcpServers": { "coingecko_coingecko_typescript_api": { "command": "npx", "args": ["-y", "mcp-remote@latest", "https://mcp.pro-api.coingecko.com/sse"] } } }
Troubleshooting
- Ensure you have Node.js 18 or higher installed
- Try clearing MCP authentication cache:
rm -rf ~/.mcp-auth
- Restart your MCP client application
- Check client logs for error messages
Frequently Asked Questions
Quick answers to common questions about setting up and using the CoinGecko MCP Server.
Setup & Configuration
Make sure you restart your MCP client completely after adding the configuration. The client needs to reload to discover the new server and its tools.
For Claude Desktop, quit the app entirely and reopen it. Simply refreshing or starting a new conversation won't pick up configuration changes.
First, check your internet connection and verify that https://mcp.pro-api.coingecko.com/sse is accessible from your browser.
Some corporate firewalls or restrictive networks may block this endpoint. If you're on a work network, you may need to ask your IT team to whitelist the domain.
You can also try testing the connection with: curl https://mcp.pro-api.coingecko.com/sse
Ensure Node.js is properly installed on your system. You can check by running node --version and npm --version in your terminal.
Test if the mcp-remote package is accessible by running: npx mcp-remote --version
If you get permission errors, try clearing the npm cache: npm cache clean --force
API Keys & Rate Limits
Yes, you need to provide your own CoinGecko API key to access the server. This is required to authenticate your requests and ensure you stay within your rate limits.
Compatibility & Debugging
The server works with any MCP-compatible client that supports remote servers. All CoinGecko tools are available automatically.
Tested and confirmed working with Claude Desktop, n8n, and other modern MCP implementations.
Most clients load the tool definitions without additional configuration.
Claude Desktop logs:
# macOS ~/Library/Logs/Claude/mcp*.log # Windows %LOCALAPPDATA%\\Claude\\Logs\\ # Linux ~/.local/share/Claude/logs/
For other MCP clients, consult your client's documentation for log file locations.
Check if the tools are being loaded properly by asking your MCP client to list available tools.
Ensure you're using natural language queries rather than trying to call functions directly.
Try simple queries first like "What's the current price of Bitcoin?" before attempting complex multi-step operations.
Usage & Features
You can access comprehensive crypto data including real-time prices, market caps, trading volumes, historical charts, exchange information, NFT collection data, DeFi pools, trending coins, and much more.
The server provides tools covering everything from basic price queries to advanced on-chain analytics.
Data is updated in real-time directly from CoinGecko's live API. Price data is typically updated every few minutes, while market data refresh rates vary by endpoint.
The server provides the same fresh data you'd get from CoinGecko's website and official API.
Yes by bringing your own key, you can use this server for commercial and production applications, but please note that it is currently in beta.
Please obtain your own CoinGecko API key to ensure higher rate limits and compliance with CoinGecko's terms of service.
Example Usage
See what's possible with natural language queries.
Once configured, you can interact with cryptocurrency data through natural language. Here are some example queries:
- "What's the current price of Bitcoin?" - "Show me the top 10 cryptocurrencies by market cap" - "What is bitcoin all time high price?" - "Do a technical analysis on Bitcoin historical price since the beginning of time. Let me know what your initial findings are." - "What are the trending coins today?" - "Find information about Solana including market data" - "Show me the top NFT collection market data" - "What are the top DEX pools on Solana?"