Gaplydev01 Coingecko MCP Server

🚀 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 an automatic fallback feature.

🚀 Quick Start

# Install and run using 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 use both CoinGecko's free and Pro APIs.
• 🔙 Automatic Fallback: Automatically fallback to the free API during development.
• 🔌 RESTful Endpoints: Simple and intuitive API interfaces.
• 🛡️ Robust Error Handling: Detailed error messages and correct status codes.
• 🧩 Easy Setup: Quick installation and guided setup.
• 📝 Comprehensive Documentation: Clear usage instructions.

📦 Installation

Option 1: Using npx (Recommended)

This is the fastest way:

npx coingecko-api-server

The interactive setup will:

1. Ask for the location to install the server.
2. Clone the repository.
3. Install dependencies.
4. Prompt for your CoinGecko API key (optional).
5. Configure the server port.

Option 2: Manual Setup

If you prefer manual setup:

# 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

📚 Documentation

Configuration

The server can be configured via environment variables in the .env file:

API Endpoints

The server provides access to all necessary CoinGecko API endpoints:

Basic Endpoints

• GET /api/ping - Check the status of the CoinGecko API

Price Data

• GET /api/simple/price - Get price data for specified coins

  • Query parameters: ids, vs_currencies, include_market_cap, include_24hr_vol, include_24hr_change, include_last_updated_at, precision

• GET /api/simple/supported_vs_currencies - Get a list of supported vs currencies

Coin Data

• GET /api/coins/markets - Get coin market data
  • Query parameters: vs_currency, ids, category, order, per_page, page, sparkline, price_change_percentage

Market Data

• GET /api/global - Get global cryptocurrency data
• GET /api/search/trending - Get trending coins

The full API documentation can be found in the CoinGecko API Documentation.

💻 Usage Examples

MCP Integration Information

This is an MCP (Market Component Plan) server compatible with AI systems like Claude. To use this server in Claude Desktop:

1. Start the CoinGecko API server locally.
2. In Claude Desktop, install the MCP by providing the server URL (e.g., http://localhost:3000).
3. Claude can now access the API compatible with both the free and Pro versions.

# Run in development mode with hot reloading
npm run dev

The server uses direct fetch calls to access the CoinGecko API, ensuring compatibility with both the free and Pro versions.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• CoinGecko for providing the cryptocurrency data API.
• Anthropic for providing Claude AI and the MCP plan.