CoinGecko MCP server
CoinGecko's official MCP server gives agents real-time crypto prices, market data, and on-chain DEX analytics.
CoinGecko MCP is the official server for the CoinGecko API, giving an AI agent live and historical cryptocurrency market data: spot prices for thousands of coins in any fiat or crypto currency, ranked market lists with market cap and volume, full coin detail, OHLC candles and historical charts, trending coins, exchange data, NFT collections, and on-chain DEX prices, pools, and trending pairs across more than 200 networks via GeckoTerminal. It is the same data that powers CoinGecko, exposed as agent-callable tools.
The canonical setup is the public remote endpoint at https://mcp.api.coingecko.com/mcp, which is keyless — no API key or OAuth required — and ideal for quick queries against shared rate limits. The current hosted server runs in code mode: it exposes two tools, search_docs to look up the CoinGecko SDK, and execute to run typed requests against any of the API's 100-plus methods in a sandbox. It can also run locally over stdio via npx, where a CoinGecko Demo or Pro API key raises rate limits and unlocks Pro endpoints.
Quick install
Copy-paste configs are provided for all 8 supported clients. Pick your client below.
Add to ~/.claude.json
{
"mcpServers": {
"coingecko": {
"type": "http",
"url": "https://mcp.api.coingecko.com/mcp"
}
}
}claude mcp add --transport http coingecko https://mcp.api.coingecko.com/mcpAvailable tools
| Tool | Description |
|---|---|
| search_docs | Looks up documentation and guidance on the CoinGecko API and TypeScript SDK so the agent can find the right method. |
| execute | Runs typed requests against the CoinGecko SDK in a sandbox, covering prices, markets, coin detail, OHLC, trending, exchanges, NFTs, and on-chain DEX data. |
Required configuration
- COINGECKO_DEMO_API_KEYOptional
CoinGecko Demo (free) API key for higher rate limits. Optional.
- COINGECKO_PRO_API_KEYOptional
CoinGecko Pro API key to unlock Pro endpoints and higher limits. Optional.
- COINGECKO_ENVIRONMENTOptional
Selects the demo or pro API environment. Optional.
What you can do with it
Answer live market questions
An agent fetches current prices, market caps, and 24-hour changes so it can report what a coin is doing right now instead of relying on stale training data.
Research on-chain liquidity
Using GeckoTerminal data, the agent surfaces trending DEX pools and token prices across networks to help analyze a new token's liquidity and activity.
FAQ
- Is it free?
- Yes. The public remote endpoint is keyless and free for quick queries against shared rate limits; a free CoinGecko Demo key or a paid Pro key raises limits and unlocks Pro endpoints.
- Does it support remote/OAuth?
- It offers a keyless hosted endpoint at https://mcp.api.coingecko.com/mcp (no OAuth needed). The local stdio mode uses an optional API key rather than OAuth.
- How does the agent call specific endpoints?
- The current hosted server runs in code mode: the agent uses search_docs to find a method and execute to run it. The local npx server can also expose one tool per REST endpoint.