# CoinGecko MCP for AI Agents MCP

> CoinGecko enables your AI agent to pull real-time crypto market data, including current prices for multiple coins in various fiat currencies. It lets you query global statistics like total market cap and 24h volume, search through exchanges or categories, and track the top trending digital assets directly from chat.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Tags:** cryptocurrency, market-data, price-tracking, market-cap, fiat-conversion, real-time-data

## Description

This CoinGecko MCP connects your AI client to a massive database of crypto market data. You don't have to open a web browser or copy-paste figures anymore; you just ask your agent for what you need. For example, asking 'What's the current price of Ethereum in dollars and euros?' gets an immediate, structured answer. Need to know which coins are gaining traction? Your agent can pull trending assets from the last 24 hours instantly. The tool also lets you check global stats—things like total market cap or BTC dominance—which is crucial for high-level analysis. By connecting this MCP via Vinkius, your AI client gains access to a robust source of truth about crypto prices and market rankings, making deep research simple.

## Tools

### get_coin_details
Pulls comprehensive information for one specified cryptocurrency, detailing its background and stats.

### get_global_data
Retrieves high-level market metrics like total market capitalization and overall 24h volume.

### get_price
Checks the current trading price for one or more cryptocurrencies, including fiat conversions.

### get_trending
Lists which crypto assets are currently gaining attention and volume in the last day.

### list_categories
Provides a full list of all defined cryptocurrency market categories available for research.

### list_exchanges
Gathers a directory of major exchanges where crypto assets can be traded.

### list_markets
Lists many coins and provides detailed market data for each one in bulk.

### search_crypto
Searches across all coin names, exchange listings, or categories using a simple keyword query.

## Prompt Examples

**Prompt:** 
```
What are the current prices of Ethereum and Dogecoin in USD, GBP, and CAD?
```

**Response:** 
```
Here's a snapshot of those coins:

| Coin | Symbol | USD Price | GBP Price | CAD Price |
| :--- | :--- | :---: | :---: | :---: |
| Ethereum | ETH | $3,500.21 (+2.1% 24h) | £2,890.55 (+2.1% 24h) | $5,700.11 (+2.1% 24h) |
| Dogecoin | DOGE | $0.133 (+1.5% 24h) | £0.098 (+1.5% 24h) | $0.214 (+1.5% 24h) |

*Data current as of chat time.*
```

**Prompt:** 
```
Show me the overall market stats, including total market cap and BTC dominance.
```

**Response:** 
```
**Global Crypto Market Overview**

📈 **Total Market Cap:** $2.61 Trillion (+1.9% 24h)
💰 **24 Hour Volume:** $105.5 Billion
👑 **BTC Dominance:** 53.4%
💎 **ETH Dominance:** 17.1%

*The market remains highly liquid, showing strong overall growth.*
```

**Prompt:** 
```
What are the top three trending assets right now and what category do they belong to?
```

**Response:** 
```
**Top Trending Assets (Last 24 Hours)**

The highest volume movers include:
1. **Solana (SOL):** Category - Layer 1 Protocol
2. **Jupiter (JUP):** Category - DeFi/Exchange Token
3. **Pepe (PEPE):** Category - Memecoin

*These coins show significant buying pressure, suggesting high current interest.*
```

## Capabilities

### Get Cryptocurrency Details
Retrieves specific, detailed information for any single cryptocurrency you name.

### Check Global Market Stats
Pulls aggregate data like total market cap and 24-hour volume across the entire crypto ecosystem.

### Query Real-Time Prices
Provides the current price for one or more cryptocurrencies, converting them into different fiat currencies.

### Identify Trending Assets
Lists coins that have seen high interest and movement within the last 24 hours.

### List Market Categories or Exchanges
Gathers comprehensive lists of available crypto categories or major exchanges for research purposes.

### Search Crypto Assets by Keyword
Finds specific coins, exchanges, or market segments using simple keyword searches.

## Use Cases

### Analyzing Market Sentiment After an Event
A trader needs to know how Bitcoin reacted immediately after a major regulatory announcement. They prompt their agent, and it uses `get_price` to show the price fluctuation in real-time against historical data, allowing for quick assessment of market panic or stability.

### Building a Comprehensive Portfolio Report
An analyst must write a report comparing top assets. They use `list_markets` and then query the global stats via `get_global_data` to provide context, ensuring their report has both individual coin data and macro market health metrics.

### Researching New Investment Verticals
A developer wants to see what's popular outside of Bitcoin. They use `list_categories` to get a list of niche sectors (like DeFi or NFTs) and then ask for the top trending coins in that area using `get_trending`.

### Verifying Exchange Availability
A new user needs to know where they can trade assets. They use `list_exchanges` first, and if they are interested in a specific coin not listed, they use `search_crypto` to confirm its availability.

## Benefits

- Check real prices instantly: Instead of visiting multiple exchange sites, you simply ask your agent to get the current price for any crypto in USD or EUR using `get_price`.
- Access global snapshots: Use `get_global_data` to pull total market cap and 24h volume in one prompt. This is essential when compiling macro-economic reports.
- Stay ahead of trends: The `get_trending` tool shows you which coins are moving fast, letting you focus your research immediately on high-interest assets.
- Comprehensive data sources: Need to know what's out there? Use `list_categories` or `list_exchanges` to get a full directory before diving into specific asset analysis.
- Efficient deep dives: If you need granular info, use `get_coin_details`. It pulls everything on a single coin—from its name to its market stats—without requiring multiple lookups.

## How It Works

The bottom line is that it makes complex crypto research as simple as having a conversation with your AI client.

1. First, you connect the CoinGecko MCP to your preferred AI client through Vinkius and provide your API key.
2. Next, you prompt your agent naturally, asking a question like 'What is the current market cap for Bitcoin?'
3. The agent executes the necessary function call, retrieves structured data, and presents the answer directly in the chat interface.

## Frequently Asked Questions

**Can I use the CoinGecko MCP to check prices in multiple fiat currencies?**
Yes. The CoinGecko MCP allows you to pull real-time pricing for any coin and convert it into several different major world currencies simultaneously, saving you from manual conversion work.

**How do I find out which crypto coins are currently gaining the most attention?**
You can use the MCP to pull a list of trending assets. This function shows you the coins with the highest trading volume and interest over the past 24 hours, helping you focus your research instantly.

**What is the best way to compare Bitcoin against Ethereum's market cap?**
The MCP lets you check global statistics. You can use the dedicated tool to retrieve aggregate data that includes both total market capitalization figures, giving you a direct comparison point for major assets.

**Does CoinGecko MCP help me research new crypto categories?**
Absolutely. The MCP provides lists of all defined cryptocurrency categories and exchanges. You can list these out to map the entire industry landscape before you invest time in a specific asset.

**Is this better than just using Google for live market data?**
Yes, because it’s structured. Instead of getting varied web results, your AI client gets clean, actionable JSON-like data that is ready to be used in a report or calculation right away.

**Can I use CoinGecko MCP for my automated trading workflows?**
You can. The structured outputs from the MCP are designed for agents and developers, meaning your automation pipelines can reliably ingest live price feeds to trigger actions or update dashboards.