# CoinMarketCal MCP MCP > CoinMarketCal lets your AI agent track upcoming crypto events, listings, and forks. It pulls market-moving data for Bitcoin, Ethereum, and any altcoin directly into your workflow. Stop searching multiple sites; get a centralized view of the entire crypto calendar. ## Overview - **Category:** event-management - **Price:** Free - **Tags:** crypto-events, economic-calendar, hard-forks, exchange-listings, community-voting, market-intelligence ## Description Need to know what's coming next in crypto? This MCP connects your AI agent to CoinMarketCal’s economic calendar. It pulls together everything: exchange listings, hard forks, major conferences, and roadmap milestones for every coin you care about. You can ask it to find all events related only to Ethereum or narrow the search down to a specific week's date range. The system makes sure your agent gets the most relevant data without the noise. When you run these searches, CoinMarketCal passes the event details through Vinkius. This means that every single tool call generates a cryptographically signed audit trail, so you always have a tamper-proof record of exactly what data flowed and how much was used. You connect once from your preferred AI client (like Claude or Cursor), and it handles all the complexity of gathering deep market intelligence. ## Tools ### get_coin_id Looks up the unique CoinMarketCal ID for any coin by its name or symbol. ### get_event_details Pulls full details about a specific, known event using its unique ID. ### list_categories Retrieves the list of all possible event types, like 'Roadmap' or 'Release'. ### list_coins Provides a master list of every cryptocurrency covered by CoinMarketCal. ### list_events Gathers an unfiltered, general list of all upcoming crypto events in the calendar. ### list_popular_events Retrieves a quick view of the most popular or widely discussed cryptocurrency events. ### list_trending_events Gets a list focused on the most currently trending crypto events in the community. ### search_events_by_coin Filters and finds all scheduled events directly related to one specific cryptocurrency. ### search_events_by_date Finds any event that falls within a user-defined start and end date range. ## 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 ### Search by Coin Find every upcoming event tied to a specific cryptocurrency, like Bitcoin or Cardano. ### Filter by Timeframe Limit the search results to only show events happening within custom start and end dates. ### Discover Trending Topics List the most popular or highly community-voted crypto events currently scheduled. ### Check Event Types Identify what kind of event you're looking at, whether it’s a conference, a listing, or a fork. ## Use Cases ### Predicting BTC's Next Move A trader needs to know if Bitcoin has major scheduled activity. The agent calls `search_events_by_coin` for 'Bitcoin,' filters the results, and then uses `get_event_details` on the top result to confirm the date and type. ### Tracking an Entire Sector An analyst wants a list of all upcoming listings in the DeFi space. The agent runs `list_categories` to identify 'Listing,' then uses that filter alongside `search_events_by_coin` for major L1 tokens. ### Pre-Mortem Analysis A portfolio manager needs to know what market risks are coming up. They use `list_coins` to get a list of all assets, then run `search_events_by_date` for the next quarter to spot potential volatility periods. ### Building an Event Pipeline A research team needs to automate report generation. They first use `list_popular_events`, identify key dates, and then structure a multi-step query using those date ranges in `search_events_by_date`. ## Benefits - Need to check Bitcoin's next moves? Use `search_events_by_coin` to isolate all events for BTC immediately. You don't wade through irrelevant altcoins; you get straight to the signal. - Don't know what kind of event you need to track? Run `list_categories` first. This lets your agent build complex queries, filtering by type (e.g., 'only hard forks'). - Getting a high-level view is easy with `list_popular_events`. It gives instant visibility into the biggest community buzz without needing specific parameters. - `search_events_by_date` handles time constraints perfectly. Tell your agent, 'Show me everything between April 1st and May 30th,' and it pulls all related activity from that window. - Once you find an event ID, use `get_event_details`. This goes deeper than a summary; it gives the full context needed for deep research on any single project. ## How It Works The bottom line is: your agent moves from general market overview to hyper-specific data points in three steps. 1. First, your AI client uses the available tools to identify the specific coin ID or category type needed for the query. 2. Next, the agent runs the primary search function, feeding it criteria like a date range or asset name. 3. Finally, you get back a structured list of events. You can then use another tool call to pull deep details on any single event that caught your eye. ## Frequently Asked Questions **How do I find events for a specific coin using search_events_by_coin?** You simply tell the agent to use `search_events_by_coin` and provide the name or symbol of the coin. It handles the initial lookup, so you just need one clean prompt. **Does list_trending_events show live data?** It shows events that are currently popular based on community voting and interest recorded by CoinMarketCal. This helps gauge immediate market attention. **What if I only know the date, not the coin? Should I use search_events_by_date?** Yes, that's exactly what `search_events_by_date` is for. You give it a start and end range, and it pulls all activity across all coins within that window. **Can I find out which categories are available using list_categories?** Absolutely. `list_categories` gives you the full menu of event types—like 'Roadmap' or 'Conference'—so your agent can filter results by type. **If I only have a coin name and not an event ID, how do I find the necessary CoinMarketCal ID using `get_coin_id`?** You simply pass the coin's symbol or full name to `get_coin_id`. This function returns the specific numerical identifier required for subsequent calls like retrieving details or searching events. It’s a mandatory first step if you don't have the ID handy. **After using `list_events`, what specific data points can I retrieve about a single occurrence using `get_event_details`?** The tool provides comprehensive details, including the exact date and time of the event, its associated category, and any specific notes or descriptions provided by CoinMarketCal. This allows your agent to build rich context from raw IDs. **How can I get a full roster of all cryptocurrencies that CoinMarketCal tracks using `list_coins`?** Running `list_coins` pulls the complete, currently supported list of assets. This is useful for your agent to validate coin names or build comprehensive menus without having to manually input every possible symbol. **What is the functional difference between running `list_events` versus using `list_popular_events`?** `list_events` provides a general, chronological stream of all scheduled activities. In contrast, `list_popular_events` filters this data to show only those events that have high community interest or voting metrics.