# CoinMarketCap MCP MCP

> CoinMarketCap MCP connects your AI agent directly to real-time crypto market data, allowing you to query prices, track global rankings, and convert currencies instantly. Stop leaving chat to check dashboards; get live financial metrics pulled straight into your workflow.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Tags:** crypto-prices, market-rankings, currency-conversion, api-usage, financial-data, market-volume

## Description

Need crypto pricing in your automated workflows? This connector brings the full CoinMarketCap dataset—market caps, exchange listings, historical data—right into your AI agent. You can ask for anything: 'What's the top 10 cryptocurrencies by market cap?' or 'Convert 2 ETH to USD.' It pulls real-time quotes and global metrics on demand. Because this deals with financial assets, Vinkius enforces a financial circuit breaker that lets you set a spending limit before your agent makes any calls. This means the AI can never run up costs unexpectedly. When you connect your preferred client, it's all done through a single connection point to access these massive datasets and build complex automations.

## Tools

### get_global_metrics
Retrieves aggregate market data covering the entire cryptocurrency sector.

### get_id_map
Maps asset symbols or names to their unique CoinMarketCap ID.

### get_key_info
Checks your API key's usage, remaining credits, and rate limits.

### get_metadata
Pulls static details like logos or descriptions for specific cryptocurrencies.

### get_quotes
Retrieves the latest market quotes and prices for selected coins.

### list_exchanges
Provides a ranked list of all cryptocurrency exchanges in the market.

### list_listings
Gets a paginated, current list of active cryptocurrencies and their latest metrics.

### price_conversion
Calculates the converted value between two currencies using live market rates.

## Prompt Examples

**Prompt:** 
```
Show me the top 10 cryptocurrencies by market cap.
```

**Response:** 
```
Top 10 by market cap:
1. Bitcoin (BTC) — $1.2T, $67,420
2. Ethereum (ETH) — $410B, $3,415
3. Tether (USDT) — $110B, $1.00
...
Would you like price details or 24h change for any?
```

**Prompt:** 
```
Convert 1.5 BTC to EUR.
```

**Response:** 
```
1.5 BTC = €94,230.45 EUR (rate: €62,820.30/BTC). Last updated: 2 minutes ago.
```

**Prompt:** 
```
Get the historical listing data for Dogecoin launched on CoinMarketCap.
```

**Response:** 
```
Dogecoin (DOGE) was listed on CoinMarketCap on Dec 15, 2013, with an initial tracked market cap around $3.5M. Present market cap is $16.9B.
```

## Capabilities

### Get Market Overview
Pull aggregate data for the entire crypto market at a glance.

### List Active Assets
Retrieve paginated lists of currently tracked cryptocurrencies and exchanges.

### Get Current Quotes
Fetch the latest trading price data for specific coins or assets.

### Convert Currencies
Calculate the current value of one crypto asset against any fiat currency.

### Check API Status
Monitor how many credits you have left and what your rate limits are.

## Use Cases

### Determining Market Exposure
An analyst needs to know the total market size across all assets. They ask the agent, and it uses `get_global_metrics` to provide an immediate, comprehensive view of the entire crypto sector.

### Pre-Checking Asset Validity
A developer is writing a script for a new coin. Instead of guessing if the ticker is right, they ask the agent to use `get_metadata` first, confirming the asset's logo and description before building any logic around it.

### Comparing Trading Venues
A user needs to see which exchanges are currently active. They prompt the agent, and it uses `list_exchanges` to provide a ranked list of where they can trade, eliminating manual research time.

### Cross-Platform Reporting
A team member needs to report on asset values in different currencies. The agent runs the necessary data through `get_quotes` then uses `price_conversion` to give a single, unified report denominated in USD.

## Benefits

- Instantly get the top 10 cryptocurrencies by market cap using `list_listings`, so you don't have to run multiple manual queries.
- Never calculate a conversion manually again. Use `price_conversion` to instantly translate any crypto amount into fiat currency, like BTC to EUR.
- Keep your workflow running without worrying about costs; the platform uses a financial circuit breaker that lets you cap spending before the agent runs out of budget.
- If you only know the asset name, use `get_id_map` first. It quickly maps any symbol or name to its unique ID, saving time and preventing errors in subsequent calls like `get_quotes`.
- See exactly what your AI agent is doing with Vinkius AI Analytics—it tracks every tool call so nothing happens without a visible audit trail.

## How It Works

The bottom line is you talk to your AI client normally, but it handles all the complex data lookups behind the scenes.

1. Connect the CoinMarketCap MCP to your AI client using your unique API key.
2. Instruct your agent with a natural language request, like 'Show me the top 5 coins by volume.'
3. The MCP executes the necessary data call and feeds the structured market metrics directly back to your chat window.

## Frequently Asked Questions

**How do I check my API key limits using get_key_info?**
You ask the agent to run `get_key_info`. It will immediately report your remaining credits and how many calls you've made. This is crucial for planning large data pulls.

**Can I use get_id_map if I only have a coin name?**
Yes, that’s exactly what `get_id_map` does. It takes names or symbols and translates them into the required unique IDs for all other tools like `get_quotes`.

**What is the best way to convert crypto amounts?**
Use `price_conversion`. Just tell your agent which amount, what currency it's in, and what you want it converted into. It uses live rates every time.

**How do I get a list of all available crypto listings?**
Run `list_listings`. This gets the current, paginated roster of active cryptocurrencies along with their latest market data points.

**What does using get_global_metrics return about the overall crypto market? **
It provides aggregate data for the entire cryptocurrency market. You can instantly pull metrics like total circulating supply and current overall market capitalization.

**If I need static details like a logo or description, should I use get_metadata?**
Yes, get_metadata fetches descriptive information. It retrieves non-volatile data points for an asset, such as its official logo and detailed project descriptions.

**How do I retrieve the latest market quotes for multiple specific cryptocurrencies using get_quotes?**
You simply pass a list of symbols to get_quotes. It returns the most current price data, including 24-hour changes, for all requested assets in one call.

**How do I get a ranked list of available cryptocurrency exchanges using the list_exchanges tool?**
The list_exchanges tool returns a directory of major platforms. This lets your agent compare different exchanges and see their relative market ranking.