🚀 CoinGecko API Server MCP
Seamless cryptocurrency data access for AI systems and applications
Features • Quick Start • Installation • Configuration • API Reference • MCP Integration • Pro API • Troubleshooting • License
🌟 Overview
The CoinGecko API Server MCP is a powerful, production-ready Node.js solution that provides seamless access to cryptocurrency market data through an elegant RESTful API and MCP (Marketplace Component Program) interface. It bridges AI systems like Claude with real-time crypto data while handling all the complexities of API rate limits, fallbacks, and error handling.
✨ Key Features
🔄 Dual API Support: Seamlessly integrates with both CoinGecko Free and Pro APIs
🧠 AI Integration: Full implementation of the MCP protocol for AI assistants
🛡️ Intelligent Fallback: Automatically switches between APIs to prevent rate limiting
⚡ Optimized Performance: Efficient request handling and response caching
📊 Comprehensive Data: Access to all essential cryptocurrency metrics
🔌 Simple Interface: Intuitive RESTful endpoints and JSON-RPC methods
🚦 Robust Error Handling: Clear error messages with appropriate status codes
🧩 Easy Deployment: Minimal configuration with guided setup process
📘 Extensive Documentation: Clear usage instructions and examples
🚀 Quick Start
📦 Installation
Option 1: Using npx (Recommended)
The quickest way to get started:
This will:
📥 Download and install the server
🧰 Run an interactive setup wizard
🔑 Ask for your CoinGecko API key (optional)
🚀 Start the server automatically
Option 2: Manual Installation
For more control over the installation process:
⚙️ Configuration
The server is configured using environment variables in the .env
file:
Variable | Description | Default |
| Server port |
|
| CoinGecko Pro API key (optional) | - |
| Cache duration in seconds |
|
| Logging level (error, warn, info, debug) |
|
📚 API Reference
RESTful Endpoints
Basic Endpoints
GET /api/ping
- Check API server status
Price Data
GET /api/simple/price
- Get price data for specified coinsQuery params:
ids
,vs_currencies
,include_market_cap
,include_24hr_vol
,include_24hr_change
,include_last_updated_at
,precision
Coin Data
GET /api/coins/markets
- Get market data for coinsQuery params:
vs_currency
,ids
,category
,order
,per_page
,page
,sparkline
,price_change_percentage
Market Data
GET /api/global
- Get global cryptocurrency dataGET /api/search/trending
- Get trending coins
Examples
Get Bitcoin Price in USD:
Response:
Get Top 5 Cryptocurrencies by Market Cap:
🤖 AI Integration (MCP)
This server implements the Marketplace Component Program (MCP) protocol, enabling AI systems like Claude to access cryptocurrency data.
MCP Integration Points
JSON-RPC Endpoint:
/rpc
- Handles method calls from AI clientsSchema Definition:
/mcp/schema
- Defines available tools and parameters
Available MCP Methods
ping
- Check API statusgetPrice
- Get price data for specified cryptocurrenciesgetSupportedVsCurrencies
- Get list of supported currenciesgetCoinMarkets
- Get market data for coinsgetGlobal
- Get global cryptocurrency datagetTrending
- Get trending coins
For detailed integration instructions, see MCP_INTEGRATION.md.
💎 Pro API Benefits
This server supports both the CoinGecko Pro API and the free API:
Feature | Free API | Pro API |
Rate Limit | ~30 calls/minute | ~500 calls/minute |
API Throttling | Yes | No |
Support | Community | Priority |
Data Freshness | 10-30 minutes | 1-2 minutes |
Price | Free | Subscription |
For more details about the Pro API setup, see USING_COINGECKO_PRO.md.
🔧 Troubleshooting
Issue | Solution |
Rate limiting errors | Consider upgrading to Pro API or adjust your request frequency |
Connection refused | Ensure the server is running on the specified port |
Authentication errors | Check your API key in the .env file |
Missing data | Verify the parameters in your request |
🧪 Development
🔄 How It Works
The server acts as a middleware between your applications and the CoinGecko API:
Request Routing: Handles incoming requests from RESTful and JSON-RPC clients
API Selection: Chooses between Free and Pro APIs based on configuration
Rate Limit Management: Implements intelligent request throttling
Response Processing: Formats and returns data in a consistent structure
Error Handling: Provides detailed error information for troubleshooting
📱 Use Cases
AI-Powered Financial Advisors: Enable AI systems to access real-time crypto data
Investment Dashboards: Build cryptocurrency dashboards with reliable data access
Portfolio Trackers: Create applications to monitor crypto holdings
Market Analysis Tools: Develop tools for technical and fundamental analysis
Trading Bots: Power automated trading systems with market data
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
🙏 Acknowledgments
CoinGecko for the comprehensive cryptocurrency data API
Anthropic for Claude AI and the MCP program
The open-source community for their invaluable contributions
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
A powerful and flexible Node.js Express server that provides a comprehensive interface to the CoinGecko cryptocurrency data API. This server supports both the free public API and the Pro API with automatic fallback.
- 🌟 Overview
- ✨ Key Features
- 🚀 Quick Start
- 📦 Installation
- ⚙️ Configuration
- 📚 API Reference
- 🤖 AI Integration (MCP)
- 💎 Pro API Benefits
- 🔧 Troubleshooting
- 🧪 Development
- 🔄 How It Works
- 📱 Use Cases
- 📄 License
- 🙏 Acknowledgments
Related Resources
Related MCP Servers
- AsecurityAlicenseAqualityEnables interaction with the CoinGecko Pro API to access cryptocurrency data including price history and market metrics through both MCP and OpenAI function calling.Last updated -9MIT License
- -securityAlicense-qualityA Node.js Express server that provides access to CoinGecko's cryptocurrency data through a comprehensive API interface, supporting both free and Pro APIs with automatic fallback functionality.Last updated -1MIT License
- -securityAlicense-qualityProvides cryptocurrency market data using the CoinGecko APILast updated -15MIT License
- AsecurityAlicenseAqualityAn MCP server that tracks the latest trending tokens on CoinGecko.Last updated -15MIT License