# CoinMarketCal MCP MCP > CoinMarketCal provides your AI agent access to a dedicated crypto economic calendar. Use this MCP to search for upcoming coin listings, hard forks, AMAs, and major project milestones across any cryptocurrency. It pulls together market intelligence that would otherwise require checking dozens of individual developer sites. ## Overview - **Category:** event-management - **Price:** Free - **Tags:** crypto-events, economic-calendar, hard-forks, exchange-listings, community-voting, market-intelligence ## Description If you need to know what's happening in the crypto space next month—or next week—this MCP is your connection point. Forget opening ten different browser tabs just to track listings, forks, and major announcements for Bitcoin, Ethereum, or anything else. This tool connects directly to CoinMarketCal, pulling together a single source of truth. Your AI agent can now read the calendar like an analyst does: it finds specific events related only to your portfolio coins using `search_events_by_coin`. You can ask for all major announcements happening between two dates or simply check out what's trending right now. Whether you’re a trader tracking potential price catalysts or an analyst building research reports, this MCP organizes the noise into actionable data points. Because we host over 4,000 specialized connectors at Vinkius, pairing CoinMarketCal with your existing AI client makes market monitoring simple. ## Tools ### get_coin_id Finds the unique identifier needed for a coin, using just its name or symbol. ### get_event_details Retrieves all detailed information about one specific event after you know its ID. ### list_categories Gets a full list of general event types, like 'Roadmap' or 'Conference'. ### list_coins Provides the complete catalog of cryptocurrencies that CoinMarketCal tracks. ### list_events Retrieves a general listing of all current and upcoming crypto events from the calendar. ### list_popular_events Gets a list of cryptocurrency events that are currently marked as highly popular by the community. ### list_trending_events Retrieves the most rapidly growing or talked-about crypto events happening right now. ### search_events_by_coin Finds all scheduled market events that are specifically related to one cryptocurrency you name. ### search_events_by_date Pulls a list of all crypto events that fall within a specific date range you provide. ## Prompt Examples **Prompt:** ``` Show me upcoming events for Bitcoin. ``` **Response:** ``` 3 upcoming Bitcoin events: 1. 'Lightning Network v2.0' — Apr 15 (Release, 92% confidence) 2. 'BTC Mining Conference' — Apr 22 (Conference, 87% confidence) 3. 'Taproot Upgrade Activation' — May 1 (Fork, 95% confidence) Want details on any of these? ``` **Prompt:** ``` Show me upcoming exchange listings. ``` **Response:** ``` 5 upcoming exchange listings: 1. TOKEN-X on Binance — Apr 10 (98% confidence) 2. DEFI-Y on Coinbase — Apr 12 (85% confidence) 3. NFT-Z on Kraken — Apr 18 (72% confidence) Want me to filter by a specific exchange? ``` **Prompt:** ``` List trending events happening this week. ``` **Response:** ``` The most trending events this week are: Ethereum's Network Upgrade (Thursday), Cardano's Africa Keynote (Friday), and the Binance Token Burn (Weekend). Check details for full coverage. ``` ## Capabilities ### Track coin-specific events Find all scheduled announcements, listings, or forks tied to one specific cryptocurrency. ### Discover top market trends Pull a list of the most popular and highly anticipated crypto events happening soon. ### Filter by event type Narrow down the calendar to specific categories like roadmaps, conferences, or exchange listings. ### Search across date ranges Get a compiled list of all market events occurring between two specified dates. ## Use Cases ### A trader needs to predict volatility for ETH. The agent runs `search_events_by_coin` using Ethereum's ID. It gets a list showing an upcoming network upgrade and multiple conference dates, allowing the trader to adjust their position days in advance. ### An analyst needs a quarterly review of all market milestones. The agent uses `search_events_by_date` for the last 90 days. It then cross-references this data with `list_categories` to summarize how many hard forks versus roadmap releases occurred. ### A portfolio manager needs to check every asset's immediate future. The agent iterates through a list of 10 held assets, running `search_events_by_coin` on each one. It compiles a single summary report showing all upcoming listings and forks. ### A researcher needs to know the general market hype. The agent runs `list_popular_events` and compares that output with `list_trending_events`. This comparison helps determine if current high interest is based on genuine community action or temporary speculation. ## Benefits - Pinpoint catalysts instantly. Instead of manually checking multiple sites, use `search_events_by_coin` to pull only the listings and forks for your target asset. - Stay ahead of market whispers. Run `list_trending_events` to see what the community is actively discussing right now, helping you focus on high-impact announcements. - Build comprehensive reports. You can start by calling `list_categories`, then use that structure to guide searches for specific milestones or conferences across multiple coins. - Never miss a date range. If you need to know what happened between last month and today, `search_events_by_date` gives you an immediate, organized overview without manual searching. - Deep-dive into any single event. Once your agent finds a promising ID, it uses `get_event_details` to pull every piece of associated data, giving you the full story. ## How It Works The bottom line is you tell your agent what time period and what coins matter, and it handles the complex search logic to bring back a clean list of relevant market intelligence. 1. Add the CoinMarketCal MCP to your AI toolset and provide your API Key. 2. Your agent processes the request, deciding if it needs a general list of coins or specific event parameters (like dates or coin names). 3. The MCP executes the necessary function call—for example, using `search_events_by_coin`—and returns structured data about upcoming market events. ## Frequently Asked Questions **How do I find all events for Bitcoin using search_events_by_coin?** You must first confirm the CoinMarketCal ID for Bitcoin, then pass that ID into `search_events_by_coin`. This tells your agent exactly which coin you are researching. **Can I use list_popular_events to check future listings?** No. `list_popular_events` shows general community interest, not a reliable schedule of future listings or forks. Use `search_events_by_coin` for scheduled announcements. **What is the difference between list_events and search_events_by_date?** `list_events` gives you everything currently published on the calendar, regardless of time. `search_events_by_date` filters that massive pool down to only what happens within your specified timeframe. **Do I need get_coin_id if I know the coin name?** It's best practice to run `get_coin_id` first. This ensures your agent has the absolute, validated ID required by other tools, preventing errors later on. **If I want deep data on one event, should I use `get_event_details`?** Yes, you must use `get_event_details`. This tool pulls a complete record for a specific event ID, giving you far more context than just the title or date. It's necessary if your agent needs full details like confidence scores and descriptions. **Before searching, should I use `list_categories` to map out all possible filters?** Absolutely. Running `list_categories` first gives you the exact taxonomy of event types available (like 'Hard Fork' or 'Roadmap'). You can then feed those precise categories into your searches for better results. **When running a broad search using `list_events`, how do I manage large amounts of data?** The tool handles pagination, but you must check the API documentation for rate limits and next page tokens. Don't try to pull everything in one go; iterate through the results set by managing these pointers. **Do I need `get_coin_id` before using `search_events_by_coin`?** While some functions might accept names, running `get_coin_id` first guarantees accuracy. It locks down the precise CoinMarketCal ID for a coin, preventing lookup errors in subsequent searches. **How do I get a CoinMarketCal API key?** Apply for an API key at developers.coinmarketcal.com. Once approved, copy your key and paste it below. **Is the event information verified?** CoinMarketCal uses a community-driven verification system. Each event has a confidence percentage and a proof link for validation. **What event categories are available?** Categories include Roadmap, Release, Exchange Listing, AMA, Fork, Conference, Partnership, Airdrop, and more.