The CoinGecko MCP Server provides a Model Context Protocol and OpenAI function calling service for interacting with the CoinGecko Pro API. With this server, you can:
Get a paginated list of supported cryptocurrencies
Look up CoinGecko IDs by name or symbol
Access historical price, market cap, and volume data for specific coins within a date range
Retrieve OHLC (Open, High, Low, Close) candlestick data for a specific time range
Manually refresh the local coin cache when stale data is observed
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@CoinGecko MCP Server get Bitcoin's price history for the last 7 days"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.
A Model Context Protocol (MCP) server and OpenAI function calling service for interacting with the CoinGecko Pro API.
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
Related MCP server: mcp-coinmarketcap
npm install coingecko-serverCreate a .env file in your project root:
COINGECKO_API_KEY=your_api_key_hereClaude 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
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
);
}interface OHLCData {
timestamp: number;
open: number;
high: number;
low: number;
close: number;
}interface HistoricalData {
prices: [number, number][];
market_caps: [number, number][];
total_volumes: [number, number][];
}interface CoinInfo {
id: string;
symbol: string;
name: string;
platforms?: Record<string, string>;
}Please refer to the CoinGecko Pro API documentation for current rate limits and usage guidelines.
MIT
This server cannot be deployed
Your agent needs crypto prices it can rely on — spot, ranked market tables, history, OHLC, per-venue tickers, and what is trending right now. **What you can ask for** • "What is the price of these 20 tokens in USD and EUR right now?" • "Give me the top 100 by market cap with 24h and 7d change." • "Chart this coin's price over the last year, hourly." • "Where does this token trade, and at what spread per venue?" • "What is trending on CoinGecko today?" **How to use it** Point any MCP client at https://mcp.aisa.one/crypto-market-data/mcp and sign in with OAuth — there is no key to create or paste. 21 CoinGecko tools: simple price and token price by contract, supported currencies, coin list and detail, ranked markets, history, market charts and ranges, OHLC, per-coin tickers, categories, exchanges and their tickers, token data and charts, and trending. **It is also a door to the rest** The same login reaches 26 sources and 580+ operations. Price the token here, then ask the same agent what X is posting about it — without adding a second server. **What it costs** Finding and inspecting an operation is free. Running one is billed per call at API prices, with no seat and no monthly minimum, and every call takes max_price_usd so an agent cannot overspend by accident. **Where else it reaches** https://mcp.aisa.one/finance/mcp for equities, crypto and prediction markets in one place.
CoinGecko MCP — wraps CoinGecko free API (no auth required)
Live and historical cryptocurrency prices via CoinGecko free API.
CoinGecko-backed live prices, market caps, DeFi metrics — no per-user API key needed.
