CoinGecko API Server MCP

MIT License
1

Integrations

  • Built as a Node.js Express server that provides a comprehensive interface to the CoinGecko cryptocurrency data API.

  • Supports installation through Git cloning as part of the manual setup process.

  • Repository hosted on GitHub, allowing users to clone and install the server manually.

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

This is the fastest way to get started:

npx coingecko-api-server

The interactive setup will:

  1. Ask where to install the server
  2. Clone the repository
  3. Install dependencies
  4. Prompt for your CoinGecko API key (optional)
  5. 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:

VariableDescriptionDefault
PORTThe port the server will listen on3000
COINGECKO_API_KEYYour 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
  • 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

Market Data

  • GET /api/global - Get global cryptocurrency data
  • GET /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:

  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 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

-
security - not tested
A
license - permissive license
-
quality - not tested

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

A 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.

  1. Quick Start
    1. Features
      1. Setup Options
        1. Option 1: Using npx (Recommended)
        2. Option 2: Manual Setup
      2. Configuration
        1. API Endpoints
          1. Basic Endpoints
          2. Price Data
          3. Coin Data
          4. Market Data
        2. MCP Integration Information
          1. Pro API vs Free API
            1. Development
              1. License
                1. Acknowledgments

                  Related MCP Servers

                  • A
                    security
                    A
                    license
                    A
                    quality
                    Enables 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 -
                    5
                    5
                    JavaScript
                    MIT License
                    • Apple
                  • -
                    security
                    A
                    license
                    -
                    quality
                    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.
                    Last updated -
                    3
                    JavaScript
                    MIT License
                  • -
                    security
                    A
                    license
                    -
                    quality
                    An MCP server that integrates with the Freqtrade cryptocurrency trading bot.
                    Last updated -
                    16
                    Python
                    MIT License

                  View all related MCP servers

                  ID: dt6erxxput