# CoinGecko MCP Server Documentation

Source: https://mcp.api.coingecko.com

## Summary

CoinGecko's MCP Server gives MCP-compatible AI clients access to live crypto data, including prices, historical charts, DeFi pools, NFT collections and exchange data, without requiring an API key. The page says the server covers over 1 million assets and 76+ tools, and it is accessible over HTTP and SSE endpoints. It is listed as a beta public service with shared rate limits that may change depending on overall activity. The page recommends the Pro MCP server, which uses a user's own CoinGecko API key, for heavy use and production applications.

## Article

CoinGecko MCP Server Free Crypto Data for AI, No Key Required

It just works, no keys required.

Connect any MCP-compatible AI to live prices, historical charts, DeFi pools, NFT collections, and more — over a million assets, available instantly in natural language.

76+ tools 1M+ assets No API key needed HTTP & SSE

Endpoints

Primary · streamable-http · recommended for all modern clients

Fallback · use if your client doesn't handle streaming well

🌐 Beta Public Access: This server is publicly available and doesn't require your own CoinGecko API key. However, to ensure fair usage, rate limits apply and may change depending on overall activity.

For heavy use, we recommend using the Pro MCP server by bringing your own CoinGecko API key for higher rate limits and availability.

Protocol Support: If you've got a client that natively supports the current MCP specification, you can connect directly to /mcp. You may use the SSE implementation at /sse if your client does not handle streaming well.

Connect

In Claude.ai, open Settings → Integrations → Add integration.

Paste the endpoint URL and name the connection CoinGecko.

https://mcp.api.coingecko.com/mcp

Save. CoinGecko will appear as a custom integration — no API key needed.

Run this command once in your terminal.

claude mcp add --transport http coingecko https://mcp.api.coingecko.com/mcp

CoinGecko tools are available immediately in any Claude Code session — no restart needed.

Verify with claude mcp list.

Open Cursor Settings with ⌘ Shift J (macOS) or Ctrl Shift J (Windows/Linux).

Select Skills and Integrations and paste the configuration.

{ "mcpServers": { "coingecko": { "url": "https://mcp.api.coingecko.com/mcp" } } }

Save and restart Cursor. CoinGecko tools will be available in agent sessions.

Open the Command Palette with ⌘ P and search for MCP: Add Server.

Select HTTP (HTTP or Server-Sent Events) and enter the endpoint URL.

https://mcp.api.coingecko.com/mcp

Name the server CoinGecko and confirm. Activate via MCP: List Servers → Start Server.

Open or create ~/.codex/config.json.

Add the CoinGecko MCP server.

{ "mcpServers": { "coingecko": { "url": "https://mcp.api.coingecko.com/mcp" } } }

Run codex — CoinGecko tools are available automatically.

Open or create ~/.gemini/settings.json.

Add the CoinGecko MCP server.

{ "mcpServers": { "coingecko": { "httpUrl": "https://mcp.api.coingecko.com/mcp" } } }

Restart Gemini CLI — CoinGecko tools will be available in your session.

Open or create opencode.json in your project root, or ~/.config/opencode/opencode.json for global config.

Add the CoinGecko MCP server.

{ "$schema": "https://opencode.ai/config.json", "mcp": { "coingecko": { "type": "remote", "url": "https://mcp.api.coingecko.com/mcp" } } }

Restart OpenCode — CoinGecko tools will be available.

Open Warp and navigate to Settings → AI → MCP Servers.

Click Add, paste the endpoint URL, and name it coingecko.

https://mcp.api.coingecko.com/mcp

Save. CoinGecko tools are available immediately — no restart needed.

Open Zed settings via the command palette: zed: open settings.

File location: ~/.config/zed/settings.json

Add the CoinGecko context server.

{ "context_servers": { "coingecko": { "command": "npx", "args": ["-y", "mcp-remote@latest", "https://mcp.api.coingecko.com/mcp"] }, "settings": {} } }

Requires Node.js for npx.

Restart Zed to load the new context server.

Open or create ~/.amp/config.json.

Add the CoinGecko MCP server.

{ "mcpServers": { "coingecko": { "url": "https://mcp.api.coingecko.com/mcp" } } }

Restart Amp — CoinGecko tools will be available in your session.

For clients with native streamable-http support (n8n, Windsurf), use the primary endpoint.

https://mcp.api.coingecko.com/mcp

For clients that only support SSE, use the fallback endpoint.

https://mcp.api.coingecko.com/sse

If your client requires a local bridge, use mcp-remote.

npx mcp-remote https://mcp.api.coingecko.com/mcp

Requires Node.js. Prefer native transport where supported.

Getting Started

What you can ask

"What's the current price of Bitcoin?" simple_price

"Show me the top 10 cryptocurrencies by market cap" coins_markets

"What are the trending coins today?" trending_search

"What are the top DEX pools on Solana?" onchain_pools_network

"Do a technical analysis on Bitcoin historical price since the beginning of time" coin_ohlc · market_chart_range

"Show me the top NFT collection market data" nfts_markets

What's covered

Prices & Markets

Live prices, caps, volumes, and rankings across 1M+ assets.

Historical Data

OHLCV charts, price history, and long-range trend analysis.

DeFi & On-chain

Pool data, liquidity, and token analytics across 100+ networks.

NFT Analytics

Collection floor prices, volumes, and marketplace stats.

Exchanges

CEX and DEX tickers, trading pairs, and volume data.

Trending & Discovery

Trending coins, search, categories, and emerging projects.

Resources & Documentation

Helpful links and additional information.

Frequently Asked Questions

Quick answers to common questions about setting up and using the CoinGecko MCP Server.

Setup & Configuration

Make sure you restart your MCP client completely after adding the configuration. The client needs to reload to discover the new server and its tools.

For Claude Desktop, quit the app entirely and reopen it. Simply refreshing or starting a new conversation won't pick up configuration changes.

First, check your internet connection and verify that https://mcp.api.coingecko.com/mcp is accessible from your browser.

Some corporate firewalls or restrictive networks may block this endpoint. If you're on a work network, you may need to ask your IT team to whitelist the domain.

You can also try testing the connection with: curl https://mcp.api.coingecko.com/mcp

If your client doesn't handle HTTP streaming well, you may use the SSE implementation at https://mcp.api.coingecko.com/sse

Ensure Node.js is properly installed on your system. You can check by running node --version and npm --version in your terminal.

Test if the mcp-remote package is accessible by running: npx mcp-remote --version

If you get permission errors, try clearing the npm cache: npm cache clean --force

API Keys & Rate Limits

No, you can use the server without your own API key. It's publicly available with shared rate limits.

If you need higher limits, you may use the Pro MCP server which allows you to bring your own CoinGecko API key.

Compatibility & Debugging

The server works with any MCP-compatible client that supports remote servers. All CoinGecko tools are available automatically.

Tested and confirmed working with Claude Desktop, n8n, and other modern MCP implementations.

Most clients load the tool definitions without additional configuration.

Claude Desktop logs:

# macOS ~/Library/Logs/Claude/mcp*.log # Windows %LOCALAPPDATA%\Claude\Logs\ # Linux ~/.local/share/Claude/logs/

For other MCP clients, consult your client's documentation for log file locations.

Check if the tools are being loaded properly by asking your MCP client to list available tools.

Ensure you're using natural language queries rather than trying to call functions directly.

Try simple queries first like "What's the current price of Bitcoin?" before attempting complex multi-step operations.

Usage & Features

You can access comprehensive crypto data including real-time prices, market caps, trading volumes, historical charts, exchange information, NFT collection data, DeFi pools, trending coins, and much more.

The server provides tools covering everything from basic price queries to advanced on-chain analytics.

Data is updated in real-time directly from CoinGecko's live API. Price data is typically updated every few minutes, while market data refresh rates vary by endpoint.

The server provides the same fresh data you'd get from CoinGecko's website and official API.

The public shared access is great for development, testing, and light usage, but not suitable for high-volume commercial applications.

For production use, we recommend using the Pro MCP server with your own CoinGecko API subscription key for higher rate limits.

Always review CoinGecko's terms of service for your specific use case.

Need higher rate limits?

The Pro MCP server supports your own CoinGecko API key for dedicated throughput and production-grade availability.

Pro MCP server →