# CoinGecko MCP MCP

> CoinGecko lets your AI client pull live crypto prices, current market cap totals, and historical rankings from global sources. Need to check Bitcoin against BRL? Or list all top-volume coins? This MCP handles all the necessary calls, giving you immediate, reliable data for trading analysis or research reports.

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

## Description

This connector gives your agent direct access to real-time crypto market intelligence. You can query specific coin prices in multiple fiat currencies, pull global stats like total market cap and 24h volume, or check which coins are currently trending. It’s how you get live price data and fundamental metrics—all through simple natural language queries.

Forget manually hopping between CoinGecko's website sections to build a report. Your agent handles the whole process. If you combine this MCP with other services, say a messaging tool, your agent can not only pull the latest market data but also draft an instant summary email for your team. Plus, since every action is logged and tracked through Vinkius AI Analytics, you always know exactly which coins were checked, what volume figures were used, and how much budget was spent. It’s a complete audit trail for your crypto research.

## Tools

### get_coin_details
Retrieves deep information about a single cryptocurrency asset.

### get_global_data
Fetches overall statistics for the entire global crypto market.

### get_price
Pulls the current exchange rate and price of one or more cryptocurrencies.

### get_trending
Lists coins that have seen increased activity over the last 24 hours.

### list_categories
Returns a complete list of crypto asset categories available on the platform.

### list_exchanges
Provides a list of major cryptocurrency exchanges where assets can be traded.

### list_markets
Fetches detailed market data for multiple coins available on tracked exchanges.

### search_crypto
Searches across the platform for specific coins, exchanges, or categories using keywords.

## Prompt Examples

**Prompt:** 
```
What is the current price of Bitcoin in USD and BRL?
```

**Response:** 
```
Bitcoin (BTC):
- USD: $67,420.00 (+2.3% 24h)
- BRL: R$ 337,100.00 (+2.5% 24h)
Market cap: $1.32T | 24h volume: $28.4B
```

**Prompt:** 
```
Show me the global cryptocurrency market stats.
```

**Response:** 
```
Global Crypto Market:
- Total Market Cap: $2.54T (+1.8% 24h)
- 24h Volume: $98.2B
- BTC Dominance: 52.1%
- ETH Dominance: 16.3%
- Active Cryptocurrencies: 14,200+
Want a breakdown by category (DeFi, NFT, etc.)?
```

**Prompt:** 
```
List the top 5 trending coins on CoinGecko right now.
```

**Response:** 
```
The top 5 trending coins in the last 24h are: 1. Solana (SOL) 2. Jupiter (JUP) 3. Pepe (PEPE) 4. Fetch.ai (FET) 5. Render (RNDR).
```

## Capabilities

### Check coin prices
Get the current price of any cryptocurrency in specific fiat currencies.

### Review global market metrics
Pull aggregate data for the entire crypto market, including total market cap and 24h volume.

### Identify top coins
List cryptocurrencies based on criteria like market capitalization or recent price change.

### Discover new assets
Search for specific crypto by keyword, or browse all available categories and exchanges.

## Use Cases

### The Market Report Generator
A finance analyst needs to write a 'Market Overview' piece. They instruct their agent: 'Get global stats, list top 5 trending coins, and pull the price of BTC in USD.' The agent uses get_global_data, gets_trending, and get_price sequentially, compiling one clean answer.

### The Investment Screening Tool
A developer wants to check a new niche coin. They use search_crypto first to verify its existence, then run get_coin_details to pull deep metrics before determining if it's worth listing in their application.

### The Comparative Pricing Check
A trader needs to compare ETH prices across different markets. They use list_markets to see various data points, and then get_price to pull the absolute latest quote for immediate decision-making.

## Benefits

- Instantly know the value of any coin. Use get_price to check live prices in multiple fiat currencies, perfect for cross-border reporting.
- Track macro trends automatically. The get_global_data tool gives you total market cap and 24h volume metrics without manual lookups.
- Discover what's hot now. Running get_trending lets your agent list the top-moving coins right after a major announcement, giving immediate alpha.
- Build structured reports quickly. Use search_crypto to find assets by category or keyword before running detailed checks with get_coin_details.
- Automate market scoping. Combining list_exchanges and list_categories allows your agent to map out the entire crypto ecosystem for a report.

## How It Works

The bottom line is: you talk to your agent, and it talks to the crypto market data API for you.

1. Add the CoinGecko integration to your AI toolset. You'll need an API key from coingecko.com.
2. Prompt your agent naturally, asking for specific market data (e.g., 'What is ETH priced at in USD right now?').
3. The MCP executes the necessary calls and returns a formatted response containing the live price or global statistic.

## Frequently Asked Questions

**How do I get multiple coin prices using get_price?**
You list the cryptocurrencies you want and their desired fiat currency in your prompt. The agent handles fetching all those quotes simultaneously, giving you a clean comparison.

**Can I search for assets by industry? Use search_crypto.**
Yes, use search_crypto to query coins, exchanges, or categories with specific keywords. It acts like a universal index across all available asset types.

**What is the difference between get_global_data and list_markets?**
get_global_data gives you macro metrics for the whole market (like total cap). list_markets provides detailed data points on specific, listed coins or asset groups.

**How do I find out what is popular right now? Use get_trending.**
Calling get_trending lists coins that have seen a significant spike in activity over the last 24 hours. This is your best bet for finding hot assets.

**When using `get_coin_details`, how does Vinkius ensure my API key stays secure?**
Vinkius uses a zero-trust proxy to handle your credentials. Your keys are used only in transit and never stored on disk, keeping them completely isolated from the platform's infrastructure.

**If I run many queries with `get_price`, how do I manage potential rate limits?**
The MCP framework handles this by allowing your agent to implement backoff logic. If a rate limit is encountered, the workflow can pause and automatically retry the request later, minimizing downtime.

**If I just want to browse all possible coin types before searching, should I use `list_categories`?**
Yes, running `list_categories` is the best way to start. It provides a complete taxonomy of every crypto category available on CoinGecko, helping you narrow down your research scope.

**What is the core difference in data returned by calling `get_coin_details` versus just searching with `search_crypto`?**
`search_crypto` finds assets based on keywords across categories and exchanges. In contrast, `get_coin_details` gives you a deep dive into one specific asset's full metrics and history.