CoinGecko MCP Server Documentation

It just works, no keys required.

Use this URL in your MCP client configuration to connect directly to the server.
Connect once. Access everything. Bitcoin prices, DeFi pools, NFT collections, market data across a million cryptocurrencies.

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

Primary MCP connection endpoint

🌐 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.

What This Server Provides

Your AI doesn't just know about crypto – it lives in it. Real-time prices become as natural as asking the time. Historical charts appear with a thought. Market analysis flows like conversation.

🚀 Ready to use: No setup required – just connect to our hosted server and start querying live crypto data immediately. Works with Claude Desktop, n8n, and any MCP-compatible application.

76+

Available Tools

0

Setup Required

24/7

Uptime

∞

Possibilities

Capabilities

Comprehensive cryptocurrency data access through a single, powerful interface.

💰 Real-time Pricing

Get instant access to current prices, market caps, and trading volumes across thousands of cryptocurrencies

📊 Market Analytics

Comprehensive market data including rankings, trends, and statistical analysis tools

📈 Historical Data

Access historical price charts, OHLCV data, and long-term market trend analysis

🔍 Search & Discovery

Powerful search capabilities to find cryptocurrencies, trending coins, and emerging projects

🎨 NFT Analytics

Complete NFT collection data including floor prices, trading volumes, and marketplace statistics

⛓️ DeFi & On-chain

Explore DeFi pools, liquidity data, token analytics, and multi-chain network information

🔄 Live Updates

Real-time data streams with automatic updates and event-driven notifications

Quick Start

Get up and running in minutes with our simple configuration process.

Prerequisites

MCP-compatible client – Claude Desktop, n8n, or other MCP-enabled applications
Node.js and npx – Required for the mcp-remote package

Basic Setup using Claude Integration UI (No API Key Required)

Select "Add integrations" in the Claude chat prompt.

Enter the integration info with the MCP endpoint path and name the connection CoinGecko.

CoinGecko MCP integration will show up as Custom.

Proceed to prompt on Claude.

Basic Setup using Claude Configuration File (No API Key Required)

Add this minimal configuration to your MCP client:

{
    "mcpServers": {
        "coingecko": {
        "command": "npx",
        "args": [
            "mcp-remote",
            "https://mcp.api.coingecko.com/sse"
        ]
        }
    }
}

Configuration Locations

Find the right configuration file for your platform.

Claude Desktop

macOS:

~/Library/Application Support/Claude/claude_desktop_config.json

Windows:

%APPDATA%\Claude\claude_desktop_config.json

Linux:

~/.config/claude/claude_desktop_config.json

Example Usage

See what's possible with natural language queries.

Once configured, you can interact with cryptocurrency data through natural language. Here are some example queries:

- "What's the current price of Bitcoin?"
- "Show me the top 10 cryptocurrencies by market cap"
- "What is bitcoin all time high price?"
- "Do a technical analysis on Bitcoin historical price since the beginning of time. Let me know what your initial findings are."
- "What are the trending coins today?"
- "Find information about Solana including market data"
- "Show me the top NFT collection market data"
- "What are the top DEX pools on Solana?"

Frequently Asked Questions

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

Setup & Configuration

Why aren't the tools appearing after I added the 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.

I'm getting connection timeout or network errors. What should I do?

First, check your internet connection and verify that https://mcp.api.coingecko.com/sse 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/sse

How do I fix npx or mcp-remote package errors?

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

Do I need my own CoinGecko API key to use this server?

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

If you need higher limits, we have plans to launch an MCP which allows you to bring your own CoinGecko API key in the future.

Compatibility & Debugging

Which MCP clients are compatible with this server?

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.

Where can I find logs to debug connection issues?

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.

The server is responding but queries aren't working. What's wrong?

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

What kind of cryptocurrency data can I access?

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.

How often is the data updated?

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.

Can I use this for commercial or production applications?

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

For production use, our roadmap includes allowing you to bring your own CoinGecko API subscription key for higher rate limits and commercial license.

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

Resources & Documentation

Helpful links and additional information.

CoinGecko MCP Server