CoinMarketCal MCP. Map every crypto listing, fork, and conference.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
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.
What your AI agents can do
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'.
Find every upcoming event tied to a specific cryptocurrency, like Bitcoin or Cardano.
Limit the search results to only show events happening within custom start and end dates.
List the most popular or highly community-voted crypto events currently scheduled.
Identify what kind of event you're looking at, whether it’s a conference, a listing, or a fork.
Ask AI about this MCP
Supported MCP Clients
OAuth 2.0 Compatible Gemini Waiting for input…
CoinMarketCal: 9 Event Search Tools
These tools let your AI agent search the crypto calendar by coin, date, category, and popularity. You can drill down from general lists to specific event details.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using CoinMarketCal on Vinkius019d7577get coin id
Looks up the unique CoinMarketCal ID for any coin by its name or symbol.
019d7577get event details
Pulls full details about a specific, known event using its unique ID.
019d7577list categories
Retrieves the list of all possible event types, like 'Roadmap' or 'Release'.
019d7577list coins
Provides a master list of every cryptocurrency covered by CoinMarketCal.
019d7577list events
Gathers an unfiltered, general list of all upcoming crypto events in the calendar.
019d7577list popular events
Retrieves a quick view of the most popular or widely discussed cryptocurrency events.
019d7577list trending events
Gets a list focused on the most currently trending crypto events in the community.
019d7577search events by coin
Filters and finds all scheduled events directly related to one specific cryptocurrency.
019d7577search events by date
Finds any event that falls within a user-defined start and end date range.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with CoinMarketCal, then connect any of our 4,800+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,800+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by CoinMarketCal. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 9 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
The Pain of Manual Calendar Checking
Right now, tracking crypto events means jumping between CoinMarketCal, Twitter, and various project websites. You copy a coin name into one place, then you manually check its schedule on another. If you need to see listings for three different coins across two weeks, it’s a miserable cycle of tabs, searches, and cross-referencing.
With this MCP, your agent handles the coordination. Instead of clicking through dashboards, you just ask: 'Show me all major conference events for ETH in Q3.' You get the clean data flow right back—no manual effort needed.
Getting Precise Event Details with `get_event_details`
Before, seeing a listing just gave you the name and date. You'd have to click into that event's specific page on the source website to find out if it was an AMAs or a hard fork, and what confidence level the data had.
Now, after identifying the event with `list_popular_events`, you pass the ID to `get_event_details`. You instantly get every piece of context—the full description, category type, and all supporting metadata—without leaving your chat window.
What you can do with this MCP connector
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.
019d7577-62f1-73ec-8fdb-9671f38c2491 
How CoinMarketCal MCP Works
- 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.
The bottom line is: your agent moves from general market overview to hyper-specific data points in three steps.
Who Is CoinMarketCal MCP For?
Crypto traders who need alpha before the move. Quantitative analysts tracking project timelines. Portfolio managers monitoring risk across diverse asset classes.
Tracks roadmap milestones and conference dates to predict when a project might hit critical mass or face funding gaps.
Monitors exchange listings and hard forks, timing trades around high-impact market events for maximum gain.
Checks event calendars across multiple held assets to proactively anticipate periods of increased volatility or liquidity risk.
What Changes When You Connect
- Need to check Bitcoin's next moves? Use
search_events_by_cointo 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_categoriesfirst. 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_datehandles 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.
Real-World 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.
The Tradeoffs
Searching everything at once
Asking the agent to 'Find all crypto events for BTC, DeFi, and next month.' This is too vague and hits rate limits.
→
Break it down. First, use get_coin_id to get the coin ID. Then, run search_events_by_coin using that specific ID, followed by a targeted call to search_events_by_date for your required timeframe.
Over-relying on general lists
Just running list_events and reading the entire output. You'll get thousands of irrelevant results.
→
Always start with a filter. If you know the coin, use search_events_by_coin. If you know the time, use search_events_by_date. Filtering is key.
Forgetting details
Getting a list of 10 events and stopping there. You only see titles and dates.
→
After reviewing the list, select an event ID and run get_event_details. This pulls the full context—the description, confidence level, etc.—you actually need.
When It Fits, When It Doesn't
Use this MCP if your job requires pre-trade intelligence or long-term market research. Specifically, use it when you must cross-reference an asset (via search_events_by_coin) against a specific timeline (using search_events_by_date). Don't use it if you just need to know today's top headlines; for that, a standard news feed is faster. If your goal is purely descriptive—like 'What are the current major themes?'—then running list_popular_events gives you enough context without needing multiple tool calls.
Common Questions About CoinMarketCal MCP
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.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.