# CoinMarketCap MCP for AI Agents MCP > CoinMarketCap MCP connects your AI agent directly to real-time cryptocurrency market data. It lets you check current prices across hundreds of digital assets, convert values between crypto and fiat currencies, and view detailed global market metrics for research or trading. ## Overview - **Category:** data-analytics - **Price:** Free - **Tags:** crypto-prices, market-rankings, currency-conversion, api-usage, financial-data, market-volume ## Description Need live crypto stats without opening a browser? This CoinMarketCap integration gives your AI client access to the world's most-referenced pricing data. You can ask it anything about the crypto market, from what coins are currently leading by market cap to converting 1 ETH into Japanese Yen. It handles complex data requests easily. Want to know which exchanges list specific assets? Or maybe you need a ranked list of all active cryptocurrencies right now? This MCP pulls that information instantly. Because this data is so critical for analysis, we host it on Vinkius, giving your agent access to thousands of other tools too. Just provide your API key and start talking crypto with natural language prompts. ## Tools ### get_global_metrics Pulls aggregate market data covering the entire cryptocurrency sector. ### get_id_map Retrieves a lookup map that links crypto symbols or names to unique CMC IDs for accurate referencing. ### get_key_info Checks your API key's usage, remaining credits, and current rate limits so you know when you need more access. ### get_metadata Fetches static descriptive data for one or multiple cryptocurrencies, like their logo or official description. ### get_quotes Retrieves the most current market quotes and pricing information for selected cryptocurrencies. ### list_exchanges Returns a ranked list of all cryptocurrency exchanges currently tracked by CoinMarketCap. ### list_listings Pulls an active, paginated list of cryptocurrencies along with their latest available market data. ### price_conversion Converts a specified amount from one currency pair to another using the most recent market exchange rate. ## Prompt Examples **Prompt:** ``` What are the top 5 cryptocurrencies by market cap right now? ``` **Response:** ``` **Top 5 Market Leaders:** 1. **Bitcoin (BTC):** $1.2 Trillion | 24h Change: +1.5% 2. **Ethereum (ETH):** $410 Billion | 24h Change: +2.1% 3. **Tether (USDT):** $110 Billion | 24h Change: -0.1% 4. **Binance Coin (BNB):** $95 Billion | 24h Change: +1.8% 5. **Solana (SOL):** $78 Billion | 24h Change: +3.0% ``` **Prompt:** ``` I need to convert 2.5 ETH into Brazilian Reais. ``` **Response:** ``` *Conversion Result:* **Input:** 2.5 Ethereum (ETH) **Output:** R$ 12,500.00 Brazilian Real (BRL) **Exchange Rate Used:** 1 ETH = R$ 5,000.00 BRL *Last Updated: 3 minutes ago.* ``` **Prompt:** ``` Show me the current total market cap and how many coins are tracked. ``` **Response:** ``` *Global Market Overview:* The entire crypto market is currently valued at **$3.2 Trillion**. We track over 20,000 unique cryptocurrency listings across dozens of exchanges globally. This gives you a massive view of the total digital asset landscape. ``` ## Capabilities ### Get Global Market Health Metrics Retrieve aggregate statistics for the entire cryptocurrency market at a glance. ### Perform Crypto-to-Fiat Price Conversions Convert specific amounts from one digital currency to another fiat currency using current rates. ### Check Current Asset Quotes Fetch the latest market price quotes for any specified cryptocurrency or group of coins. ### Map Crypto Symbols and IDs Look up unique CoinMarketCap identifiers associated with specific crypto symbols or names. ### Analyze Market Listings and Exchanges Get a ranked list of major cryptocurrency exchanges, or pull paginated lists of all tracked cryptocurrencies. ## Use Cases ### Tracking Sector-Wide Changes You need to know if the overall market is up or down today. You ask your agent for global metrics, which uses `get_global_metrics` to provide a snapshot of the entire crypto economy's performance. ### Comparing Coins Across Currencies You are analyzing an investment portfolio that involves both BTC and stablecoins. You ask your agent to use `price_conversion`, which calculates how much 10 ETH is worth in USD, for example. ### Identifying New Assets A client wants to know about every coin currently tracked. Your agent uses `list_listings` to pull the full, paginated roster of active cryptocurrencies and their latest data points. ## Benefits - Get instant price conversions: Use the `price_conversion` tool to convert any amount between two currencies without leaving your conversation. - Track overall market health: Quickly pull aggregate data using `get_global_metrics` to understand the sector's current momentum and total value. - Stay informed on assets: Pull a comprehensive list of all tracked coins via `list_listings` so you don't miss any major market players. - Verify asset details: Use `get_metadata` when you need static info, like official logos or descriptions, for specific cryptocurrencies. - Monitor your access: The `get_key_info` tool lets you check your API key usage and remaining credits before starting a big analysis. ## How It Works The bottom line is: You just talk about crypto prices, and your AI agent does the heavy lifting of data retrieval for you. 1. Add the CoinMarketCap integration to your AI toolset and provide your API key from pro.coinmarketcap.com. 2. Instruct your agent using plain language, specifying exactly what market data you need (e.g., 'What is the total market cap?'). 3. The MCP runs the necessary background queries, pulling live crypto metrics and returning structured, actionable results directly to your chat window. ## Frequently Asked Questions **How do I get real-time crypto prices using CoinMarketCap MCP?** You simply ask your agent for the current price of any coin, like 'What is the price of Dogecoin?' The MCP fetches live quotes instantly and gives you the latest value available. This works whether you're checking a single asset or multiple coins. **Can CoinMarketCap MCP help me convert crypto to fiat currency?** Yes, it can handle complex conversions. Just tell your agent what amount of one coin you want converted into another fiat money type—it uses the live market rate for accuracy. **Is CoinMarketCap MCP good for analyzing market rankings?** Absolutely. You can ask it to list top cryptocurrencies by criteria like market cap or volume, giving you a clean, ranked breakdown of the biggest players in the space. **Does CoinMarketCap MCP support historical data lookups?** While it excels at real-time data and current listings, its primary focus is on providing live market metrics. For deep, time-series historical research, you might need a dedicated archival database tool. **What if I run out of API credits with CoinMarketCap MCP?** You can check your usage before running big queries. The MCP has a specific tool to show you exactly how many credits you have left and when you might hit rate limits, so you can plan accordingly.