com.coinmarketcalPublished by coinmarketcal.comOfficial publisherv1.0.1Updated Oct 24, 2026
Crypto events calendar: dated, sourced and impact-scored events for 14,000+ coins.
CoinMarketCal's remote MCP server lets an assistant look up dated, sourced, impact-scored crypto events, coins and categories from its calendar.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/com.coinmarketcal%2Fevents/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Add this to your client's mcpServers config.
{
"mcpServers": {
"coinmarketcal": {
"type": "http",
"url": "https://coinmarketcal.com/mcp",
"headers": {
"x-api-key": "<YOUR_API_KEY>"
}
}
}
}Official examples for the CoinMarketCal API and MCP server.
CoinMarketCal is a crypto events calendar. Each event has a date, the coins it affects, an editorial category, an impact score and the source it comes from. The same data is available through a REST API and an MCP server for AI agents.
https://coinmarketcal.com/mcp (setup guide, MCP Registry: com.coinmarketcal/events)Every request sends your key in the x-api-key header.
Each event looks like this (fields depend on your plan):
When isEstimated is true, date is a deadline or the end of a window, not an exact day. Show displayedDate to your users (for example Q2 2026 or By 30 May 2026).
The MCP server exposes the read endpoints of the API as tools (list_events, get_event, list_coins, …). Event results include the url of the event page on coinmarketcal.com. It uses the same key and quota as the REST API.
Replace YOUR_API_KEY with your key.
The code in this repository is released under the MIT license. The CoinMarketCal data you access with it is governed by the API Terms of Service.
Questions about the API: [email protected].
Source: README.md at commit 0074d74
List events
Returns a paginated list of upcoming and historical events within the date window available to the caller's plan. Default sort is `date asc` (soonest first). The `coins`, `categories`, and date filters compose with `AND`.
tofromcoinslimitcursorsortBykeywordimpactMincategoriesList permanently removed events
Returns removal records ordered by `cancelledAt`, then `id`. Available to every API V2 tier. Poll regularly and never leave more than 90 days between successful requests, even when webhooks are enabled.
limitsincecursorFetch a single event
Returns the full event payload by id. Tier-gated fields follow the caller's plan. A recently removed event returns `410 Gone` with its `id` and `cancelledAt`. An unknown, temporarily unpublished, or out-of-window event returns `404`.
idrequiredList categories
Returns every category in the editorial taxonomy with the count of upcoming events per category (tier-windowed). Standard+ only. Query parameters are ignored; the list is not paginated.
Takes no parameters.
List coins
Returns a paginated list of coins ordered by `rank` ascending (top-ranked first). Pass the `tracked` filter only when you need to limit results by editorial coverage.
qlimitcursortrackedFetch a single coin
Returns the full coin payload by slug. 404 when the slug doesn't match any coin (tracked or otherwise).
slugrequiredMonthly usage
Returns the authenticated key's monthly usage counters. Does not consume quota beyond the cost of the HTTP call itself. Use this to backoff before hitting 429s or to drive alerts in your integration.
Takes no parameters.
100% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
curl -s "https://api.coinmarketcal.com/v2/events?coins=ethereum&limit=5" \ -H "x-api-key: $COINMARKETCAL_API_KEY"{ "id": "48291", "slug": "ethereum-pectra-upgrade", "title": "Ethereum Pectra Upgrade", "date": "2026-05-06T12:00:00Z", "dateType": "date", "isEstimated": false, "displayedDate": "06 May 2026", "categories": ["Release"], "coins": [{ "slug": "ethereum", "symbol": "eth", "name": "Ethereum" }], "impact": 8.5}