CoinGecko Server

What is CoinGecko Server?

CoinGecko Server is a Model Context Protocol (MCP) server and OpenAI function calling service for interacting with the CoinGecko Pro API. It provides tools for querying cryptocurrency data and maintains a local coin cache with refresh capability.

How to use CoinGecko Server?

Install the package via npm, create a .env file with your COINGECKO_API_KEY, then configure the server in Claude Desktop or integrate directly with OpenAI function calling. The server exposes tools such as get-coins, find-coin-ids, get-historical-data, get-ohlc-data, and refresh-cache.

Key features of CoinGecko Server

• Paginated list of supported cryptocurrencies
• Coin ID lookup by name or symbol
• Historical price, market cap, and volume data
• OHLC candlestick data retrieval
• Local coin cache with refresh capability
• Supports both MCP and OpenAI function calling

Use cases of CoinGecko Server

• Fetch a paginated list of all supported cryptocurrencies
• Look up CoinGecko IDs by coin name or symbol
• Retrieve historical price, market cap, and volume for analysis
• Get OHLC candlestick data for charting
• Integrate cryptocurrency data into AI assistants via Claude Desktop or OpenAI

FAQ from CoinGecko Server

What API key is required?

A CoinGecko Pro API key must be set as the COINGECKO_API_KEY environment variable.

How do I configure CoinGecko Server with Claude Desktop?

Add it to your Claude Desktop configuration file (claude_desktop_config.json) with the command, path to the server build, and your API key in the environment variables.

What tools does CoinGecko Server provide?

It provides get-coins, find-coin-ids, get-historical-data, get-ohlc-data, and refresh-cache.

What are the rate limits?

Rate limits are determined by the CoinGecko Pro API; refer to the official CoinGecko API documentation for details.

Can CoinGecko Server be used outside of MCP?

Yes, it also supports OpenAI function calling via the CoinGeckoService class and its getOpenAIFunctionDefinitions method.