CoinGecko MCP 서버

Update: CoinGecko now has an official MCP server: https://docs.coingecko.com/reference/mcp-server

I recomend you use that one, as I probably won't update or keep this one current.

CoinGecko Server

A Model Context Protocol (MCP) server and OpenAI function calling service for interacting with the CoinGecko Pro API.

Features

Paginated list of supported cryptocurrencies
Coin ID lookup by name or symbol
Historical price, market cap, and volume data
OHLC (Open, High, Low, Close) candlestick data
Local coin cache with refresh capability

Installation

npm install coingecko-server

Environment Setup

Create a .env file in your project root:

COINGECKO_API_KEY=your_api_key_here

Usage with Claude Desktop

Claude Desktop provides full support for MCP features. To use this server:

Install Claude Desktop
Add to your Claude Desktop configuration:
- On macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- On Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "coingecko": {
      "command": "node",
      "args": ["/path/to/coingecko-server/build/index.js"],
      "env": {
        "COINGECKO_API_KEY": "your-api-key-here"
      }
    }
  }
}

Restart Claude Desktop

The server provides the following tools:

get-coins: Get a paginated list of supported coins
find-coin-ids: Look up CoinGecko IDs for coin names/symbols
get-historical-data: Get historical price, market cap, and volume data
get-ohlc-data: Get OHLC candlestick data
refresh-cache: Refresh the local coin list cache

Usage with OpenAI Function Calling

import { CoinGeckoService } from 'coingecko-server';
import OpenAI from 'openai';

const openai = new OpenAI();
const coinGeckoService = new CoinGeckoService(process.env.COINGECKO_API_KEY);

// Get function definitions
const functions = CoinGeckoService.getOpenAIFunctionDefinitions();

// Example: Get historical data
const response = await openai.chat.completions.create({
  model: "gpt-4-turbo-preview",
  messages: [{ role: "user", content: "Get Bitcoin's price history for the last week" }],
  functions: [functions[2]], // get_historical_data function
  function_call: "auto",
});

if (response.choices[0].message.function_call) {
  const args = JSON.parse(response.choices[0].message.function_call.arguments);
  const history = await coinGeckoService.getHistoricalData(
    args.id,
    args.vs_currency,
    args.from,
    args.to,
    args.interval
  );
}

Data Types

OHLCData

interface OHLCData {
  timestamp: number;
  open: number;
  high: number;
  low: number;
  close: number;
}

HistoricalData

interface HistoricalData {
  prices: [number, number][];
  market_caps: [number, number][];
  total_volumes: [number, number][];
}

CoinInfo

interface CoinInfo {
  id: string;
  symbol: string;
  name: string;
  platforms?: Record<string, string>;
}

Rate Limits

Please refer to the CoinGecko Pro API documentation for current rate limits and usage guidelines.

License

MIT

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

hybrid server

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

Tools

MCP와 OpenAI 함수 호출을 통해 가격 내역 및 시장 지표를 포함한 암호화폐 데이터에 액세스하기 위해 CoinGecko Pro API와 상호 작용할 수 있습니다.

Related Resources

Reddit Discussion about this server

Related MCP Servers

CoinMarketCap MCP Server
szcharlesji
-
security
A
license
-
quality
Real-time access to cryptocurrency data from the CoinMarketCap API.
Last updated -
11
1
TypeScript
MIT License
CoinMarketCap MCP
shinzo-labs
A
security
A
license
A
quality
A Model Context Protocol implementation for the CoinMarketCap API that provides standardized access to cryptocurrency market data, exchange information, and blockchain metrics.
Last updated -
26
116
32
JavaScript
MIT License
Crypto Trader MCP Tool
SaintDoresh
-
security
A
license
-
quality
Provides cryptocurrency market data using the CoinGecko API
Last updated -
11
Python
MIT License
ChainGPT MCP
kohasummons
A
security
A
license
A
quality
Enables AI agents to access crypto-related information including latest news, prices, and market trends through ChainGPT capabilities.
Last updated -
3
2
5
TypeScript
MIT License

View all related MCP servers

CoinGecko MCP Server