CoinGecko

You have a capable Node.js MCP server that exposes CoinGecko cryptocurrency data through a modular API interface. It supports both the free and Pro CoinGecko APIs with automatic fallback, offers RESTful endpoints for price, market, and global data, and integrates with AI systems via the MCP standard for direct method calls.

How to use

You can access cryptocurrency data by connecting your MCP client to the CoinGecko MCP server. The server provides a set of stable endpoints to fetch current prices, market data, global stats, and trending coins. When you configure your client, you simply point it to the MCP server that you are running locally or remotely, and you can call the available tools as defined by the MCP schema. The server handles the underlying CoinGecko API interactions and returns structured results suitable for AI-driven workflows.

How to install

Prerequisites: You need Node.js and npm (or npx) installed on your system. Ensure you have network access to install dependencies and run the server.

Option 1 — Quick start with npx (recommended):

npx coingecko-api-server

Option 2 — Manual setup (clone and install):

git clone https://github.com/GaplyDev01/coingecko-api-server.git
cd coingecko-api-server
npm install
npm run setup
npm start

Configuration

The server reads its configuration from environment variables. You can set these in a .env file or in your hosting environment.

Key variables you will encounter:

PORT: The port the server will listen on. Default is 3000.

COINGECKO_API_KEY: Your CoinGecko Pro API key. This is optional; if not provided, the server will use the Free API with automatic fallback.

Security and notes

The server supports both Pro and Free CoinGecko APIs. If you provide a Pro API key, you gain higher rate limits and access to Pro endpoints; otherwise, you experience standard rate limits with automatic fallback when appropriate.

Troubleshooting and tips

If you encounter rate limiting, verify whether a Pro API key is configured and ensure your client respects the upstream API limits. When developing locally, you can rely on the Free API with automatic fallback to avoid blocked requests during development.

Examples and usage patterns

Use the MCP interface to request price data, market data, and global stats. The server exposes endpoints that your MCP client can invoke through the MCP JSON-RPC channel, returning structured results ready for your AI workflows.

Available tools

GET /api/ping

Check the CoinGecko API status to verify connectivity and availability.

GET /api/simple/price

Retrieve price data for specified coins in chosen currencies with optional market cap and volume details.

GET /api/simple/supported_vs_currencies

List all currencies supported for price conversions.

GET /api/coins/markets

Fetch market data for listed coins, including price, market cap, and sparkline options.

GET /api/global

Get global cryptocurrency market data including total market cap and 24h volume.

GET /api/search/trending

Return the currently trending coins based on activity and interest.