# CoinMarketCap MCP for AI Agents AI Agent Connect > CoinMarketCap lets your AI agent pull real-time crypto prices, market rankings, and exchange data directly from one of the world's most trusted sources. It handles currency conversions and provides metadata for thousands of digital assets. You can use it to track market volume, check your own API usage, or get specific quotes for your portfolio without switching tabs. ## Overview - **Category:** data-analytics - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_IdjeMaioBsth4HNc96MKF37mZDB1ziTrPpUOSJMp/ai-agent-connect - **Tags:** crypto-prices, market-rankings, currency-conversion, api-usage, financial-data, market-volume ## Description Imagine you're trying to build a portfolio tracker or a custom trading dashboard. Usually, you'd have to keep a browser tab open, copy-pasting prices from a website, and constantly refreshing to see the latest moves. This Connector changes that by giving your AI client a direct line to the CoinMarketCap database. Instead of manual lookups, you just ask your agent for the current price of a specific coin or the top ten assets by market cap. It handles the heavy lifting of fetching live data, including exchange rankings and global market metrics. When you connect this to your setup via the Vinkius catalog, your agent becomes a specialized research assistant. You can ask it to convert large amounts of BTC to USD or find out which exchanges have the highest volume. It's built for anyone who needs accurate, up-to-the-minute crypto data delivered in a conversational format. You get the data you need for research or development without the friction of manual data entry. This means you stop hunting for ticker symbols and start making decisions based on actual numbers. Whether you are checking the health of the entire market or looking for the specific details of a new token, the information comes to you in seconds. You can move from a general market overview to a specific price conversion without ever leaving your primary chat interface. ## Tools ### get_global_metrics Get aggregate market data for the entire cryptocurrency market. This is useful for seeing the big picture of total volume and market cap. ### get_id_map Find the unique CMC IDs for any cryptocurrency symbol or name. Use this to ensure your agent is looking up the correct asset data. ### get_key_info Check your API key status and remaining credits. Use this to monitor your rate limits and stay within your plan's boundaries. ### get_metadata Fetch static information like descriptions and logos for specific coins. This helps provide more context when your agent talks about new assets. ### get_quotes Retrieve the most recent price quotes for one or more cryptocurrencies. Use this to get real-time pricing for your portfolio or trading list. ### list_exchanges Get a ranked list of all the cryptocurrency exchanges available. This is great for identifying where the most liquidity is currently held. ### price_conversion Convert an amount of one currency to another using the latest market rates. This makes it easy to see your total balance in different fiat or crypto assets. ### list_listings Pull a paginated list of all active cryptocurrencies with current market data. Use this to browse new listings or see the biggest movers. ## Prompt Examples **Prompt:** ``` What are the top 5 cryptocurrencies by market cap right now? ``` **Response:** ``` **Top 5 Cryptocurrencies by Market Cap** | Rank | Name | Symbol | Market Cap | | :--- | :--- | :--- | :--- | | 1 | Bitcoin | BTC | $1.24T | | 2 | Ethereum | ETH | $415B | | 3 | Tether | USDT | $118B | | 4 | BNB | BNB | $89B | | 5 | Solana | SOL | $74B | *Would you like to see the 24h price change for any of these?* ``` **Prompt:** ``` Convert 2.5 ETH to USD. ``` **Response:** ``` 2.5 ETH = **$3,375.00 USD** *(Current Exchange Rate: $1,350.00 / ETH)* *Last updated: 1 minute ago.* ``` **Prompt:** ``` Give me a list of the top 3 crypto exchanges by volume. ``` **Response:** ``` **Top 3 Crypto Exchanges by Volume** 1. **Binance** (High volume across all pairs) 2. **Coinbase** (Major US-based liquidity) 3. **Kraken** (Significant institutional volume) *Do you need the specific rankings for any other metric?* ``` ## Capabilities ### Fetch live cryptocurrency quotes Get the current price for any digital asset instantly. ### Convert crypto amounts to fiat See what your holdings are worth in USD, EUR, or other currencies. ### Rank assets by market cap See which coins are leading the market by size or volume. ### Check your API credit usage Monitor your remaining credits and rate limits in real time. ### Pull asset metadata Get descriptions and logos for specific cryptocurrencies. ### List active exchanges Identify the top cryptocurrency exchanges by ranking. ### Get global market metrics Retrieve aggregate data for the entire crypto market. ## Use Cases ### Quickly check the top 5 coins by volume A trader wants to know the top 5 coins by volume right now. They ask the agent to list them, and it pulls the latest data from the market listings. ### Convert large holdings to fiat A developer needs to convert 500 ETH to USD. The agent uses the latest market rates to give the exact amount in a single response. ### Analyze total market health An analyst wants to know the total market cap of all cryptos. The agent fetches the aggregate data to provide a high-level overview. ### Research new token details A researcher wants to see the description of a new token. The agent pulls the static info to provide context on the project's purpose. ## Benefits - Get instant price quotes for any coin without opening a browser tab. - Perform quick currency conversions to see your total portfolio value in different fiat currencies. - Monitor your API health and remaining credits to avoid hitting rate limits during heavy research. - Stay on top of new trends by pulling full market rankings and active listings in seconds. - Access deep asset details like descriptions and logos to get more context on new tokens. - Identify the best places to trade by viewing a ranked list of all cryptocurrency exchanges. ## How It Works The bottom line is you get real-time crypto market data in your chat interface without leaving your workspace. 1. Add the CoinMarketCap MCP to your Vinkius dashboard. 2. Input your API key from the CoinMarketCap developer portal. 3. Ask your agent for specific crypto data using natural language. ## Frequently Asked Questions **Can I use the CoinMarketCap MCP to get live prices?** Yes, the Connector connects your agent directly to the CoinMarketCap database to pull real-time quotes for thousands of cryptocurrencies instantly. **How do I see my API usage with the CoinMarketCap MCP?** You can simply ask your agent to check your API key status. It will return your remaining credits and current rate limits from your CoinMarketCap account. **Can the CoinMarketCap MCP convert crypto to fiat?** Yes, it can perform currency conversions using the latest market prices, allowing you to see the value of your crypto holdings in USD or other fiat currencies. **Does the CoinMarketCap MCP show market rankings?** It does. Your agent can pull ranked lists of cryptocurrencies by market cap, volume, or price change, along with rankings for major exchanges. **Can I get descriptions for different cryptocurrencies using the CoinMarketCap MCP?** Yes, the Connector can retrieve static metadata for specific assets, including their official descriptions and logos, to provide more context in your chat. **How do I find the correct ID for a coin on CoinMarketCap?** You can ask your agent to find the unique ID for any coin symbol. It will use the mapping tool to ensure the correct asset is being queried. **How do I get a CoinMarketCap API key?** Register at pro.coinmarketcap.com to get your API key. Copy it and paste it below. **Are there limits on the free plan?** Yes. The free tier has limited daily/monthly credits and excludes some advanced endpoints like historical data. **Can I convert between any two currencies?** Yes. The conversion tool supports hundreds of cryptocurrencies and dozens of fiat currencies tracked by CoinMarketCap.