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

Deploy 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

支持与 CoinGecko Pro API 交互，通过 MCP 和 OpenAI 函数调用访问加密货币数据，包括价格历史记录和市场指标。

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 -
14
1
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
40
32
MIT License
Crypto Trader MCP Tool
SaintDoresh
-
security
A
license
-
quality
Provides cryptocurrency market data using the CoinGecko API
Last updated -
11
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
1
5
MIT License

View all related MCP servers

CoinGecko MCP Server

CoinGecko Server

Features

Installation

Environment Setup

Usage with Claude Desktop

Usage with OpenAI Function Calling

Data Types

OHLCData

HistoricalData

CoinInfo

Rate Limits

License

Tools

Related Resources

Related MCP Servers

CoinMarketCap MCP Server

CoinMarketCap MCP

Crypto Trader MCP Tool

ChainGPT MCP

Appeared in Searches

New MCP Servers

MCP directory API