CoinGecko API Server MCP
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.
Quick Start
# Install and run with npx
npx coingecko-api-server
# Or clone and install manually
git clone https://github.com/GaplyDev01/coingecko-api-server.git
cd coingecko-api-server
npm install
npm run setup
npm start
Features
Dual API Support: Seamlessly works with both CoinGecko Free and Pro APIs
Automatic Fallback: Falls back to free API during development
RESTful Endpoints: Simple and intuitive API interface
Robust Error Handling: Detailed error messages and proper status codes
Simple Setup: Quick installation with guided setup
Comprehensive Documentation: Clear usage instructions
Setup Options
Option 1: Using npx (Recommended)
This is the fastest way to get started:
npx coingecko-api-server
The interactive setup will:
- Ask where to install the server
- Clone the repository
- Install dependencies
- Prompt for your CoinGecko API key (optional)
- Configure your server port
Option 2: Manual Setup
If you prefer to set up manually:
# Clone the repository
git clone https://github.com/GaplyDev01/coingecko-api-server.git
cd coingecko-api-server
# Install dependencies
npm install
# Run the setup script
npm run setup
# Start the server
npm start
Configuration
The server can be configured using environment variables in the .env
file:
Variable | Description | Default |
---|---|---|
PORT | The port the server will listen on | 3000 |
COINGECKO_API_KEY | Your CoinGecko Pro API key | - |
API Endpoints
The server provides access to all essential CoinGecko API endpoints:
Basic Endpoints
GET /api/ping
- Check CoinGecko API status
Price Data
GET /api/simple/price
- Get price data for specified coins- Query params:
ids
,vs_currencies
,include_market_cap
,include_24hr_vol
,include_24hr_change
,include_last_updated_at
,precision
- Query params:
GET /api/simple/supported_vs_currencies
- Get list of supported vs currencies
Coin Data
GET /api/coins/markets
- Get market data for coins- Query params:
vs_currency
,ids
,category
,order
,per_page
,page
,sparkline
,price_change_percentage
- Query params:
Market Data
GET /api/global
- Get global cryptocurrency dataGET /api/search/trending
- Get trending coins
Full API documentation can be found in the CoinGecko API Documentation.
MCP Integration Information
This is an MCP (Marketplace Component Program) server compatible with AI systems like Claude. To use this server in Claude Desktop:
- Start the CoinGecko API server locally
- In Claude Desktop, install the MCP by providing the server URL (e.g.,
http://localhost:3000
) - Claude can now access cryptocurrency data through the MCP interface
The server implements the full MCP specification with JSON-RPC 2.0:
- JSON-RPC 2.0 Endpoint:
/rpc
- Handles all method calls from AI clients - Schema Definition:
/mcp/schema
- Defines available tools and parameters - Standardized Communication: Follows MCP protocol for seamless AI integration
For detailed integration instructions, see MCP_INTEGRATION.md.
Pro API vs Free API
This server supports both the CoinGecko Pro API and the free API:
- Pro API: Higher rate limits, no throttling, additional endpoints. Requires an API key.
- Free API: Limited to ~30 calls/minute with potential rate limiting.
The server automatically detects if an API key is provided and uses the appropriate API. If no key is provided, it will fall back to the free API, which is ideal for development or personal use.
For more details about the Pro API setup, see USING_COINGECKO_PRO.md.
Development
# Run in development mode with hot reload
npm run dev
The server uses direct fetch calls to the CoinGecko API, ensuring compatibility with both free and Pro versions.
License
This project is licensed under the MIT License - see the LICENSE file for details.
Acknowledgments
- CoinGecko for the cryptocurrency data API
- Anthropic for Claude AI and the MCP program
CoinGecko API Server
Project Details
- GaplyDev01/coingecko-mcp-server
- MIT License
- Last Updated: 3/20/2025
Recomended MCP Servers
MCP Server for kubernetes management and analyze workload status
mcp metabase
MCP Server for structured and standardized querying of watch-related metadata such as brands, families, and reference details from...
A Model Context Protocol Server for AI models to interface with the Tesla Fleet API.

Developer-friendly MCP server bridging Kafka and Pulsar protocols—built with by StreamNative for an agentic, streaming-first future.
MCP (Model Context Protocol) server for Dumpling AI
MCP server for Netlify integration - manage Netlify sites through Model Context Protocol
A FastMCP server implementation for the Semantic Scholar API, providing comprehensive access to academic paper data, author information,...