CoinGecko Server is a Model Context Protocol (MCP) server that exposes CoinGecko Pro data through MCP-compatible tools and an OpenAI function calling interface. It lets you fetch coin lists, look up IDs, and retrieve historical, OHLC, and market data efficiently from your own environment.

How to use

You run the CoinGecko MCP server locally and connect to it from your MCP client or OpenAI-based workflows. The server exposes a set of tools that you can invoke to fetch data from CoinGecko Pro, such as a paginated coin list, coin ID lookups, historical price data, and candlestick data. Ensure your client is configured to call the server’s functions, and provide your API key to access CoinGecko Pro.

How to install

Prerequisites you need on your machine before installing are Node.js and npm.

npm install coingecko-server
```,

Create an environment file with your CoinGecko Pro API key

echo COINGECKO_API_KEY=your_api_key_here > .env

Additional setup and running tips

After installing, start the MCP server locally using the runtime command shown in the configuration example. The server runs as a standard Node.js process and reads the API key from the environment file you created.

node /path/to/coingecko-server/build/index.js

Ensure the environment variable is loaded when starting

export COINGECKO_API_KEY=your_api_key_here node /path/to/coingecko-server/build/index.js

## Configuration and tools

The server exposes a set of tools to interact with CoinGecko Pro. You can use these tools from your MCP client or OpenAI function calling workflow. The available tools are:

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

Place your CoinGecko Pro API key in a secure environment variable. The server reads COINGECKO\_API\_KEY from the environment, so keep this key confidential and do not hard-code it in client configurations.

## Security and troubleshooting

If you encounter authentication or rate-limiting issues, verify that your API key is valid and that your environment variable is correctly loaded when starting the server. Check the terminal output for any error messages related to environment loading or network access to CoinGecko Pro.

## Available tools

### get-coins

Retrieves a paginated list of supported cryptocurrencies from CoinGecko Pro.

### find-coin-ids

Looks up CoinGecko IDs by coin name or symbol to resolve exact identifiers for queries.

### get-historical-data

Fetches historical price, market capitalization, and total volume data for a coin over a specified period.

### get-ohlc-data

Provides OHLC candlestick data for a coin over a chosen interval and timeframe.

### refresh-cache

Refreshes the local cache of coin data to keep responses up to date.