# CoinMarketCal

> CoinMarketCal is a freemium MCP server for finance and payments. MCP server for a dated, sourced and impact-scored crypto events calendar. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API
- **Website:** https://coinmarketcal.com/developer/docs/mcp
- **Repository:** https://github.com/coinmarketcal/coinmarketcal-api
- **MCP Registry name:** com.coinmarketcal/events
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments), [analytics and data](https://ai-powered.com/categories/analytics-and-data)
- **Listing updated:** 2026-11-18

## About

CoinMarketCal is an events calendar for crypto. Each event carries a date, the coins it affects, an editorial category, an impact score and its source. The registry entry says it covers more than 14,000 coins, and the MCP server exposes the read endpoints of the REST API as tools, with event results including the URL of the event page.

The README's sample event shows the shape: an id, slug, title, date, a flag for whether the date is estimated, a display date, categories, coins and an impact figure. When isEstimated is true the date is a deadline or the end of a window rather than an exact day, and the display date such as a quarter or "By 30 May" should be shown to users.

The MCP server uses the same API key and quota as the REST API, sent in the x-api-key header, and a free tier is available. The README provides client configs for Claude Code, Cursor, VS Code, Codex CLI and mcp-remote. Example code in the repo is MIT licensed; the data is covered by the API terms.

## Features

- **Dated events:** Each event has a date, coins affected, category and source.
- **Impact score:** Events carry a numeric impact figure.
- **Estimated-date flag:** Marks when a date is a deadline or window, with a display date to show.
- **Coin lookup:** Tools to list coins as well as events.
- **Shared API quota:** Uses the same key and quota as the REST API.
- **Webhook examples:** The repo shows how to verify CMC-Signature on webhook deliveries.

## Good for

- List upcoming events for a given coin
- Check the impact score of a scheduled upgrade
- Look up a coin before searching its events
- Build alerts around dated crypto events

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http events https://coinmarketcal.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://coinmarketcal.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "events": {
      "url": "https://coinmarketcal.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "events": {
      "type": "http",
      "url": "https://coinmarketcal.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "events": {
      "serverUrl": "https://coinmarketcal.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "events": {
      "type": "http",
      "url": "https://coinmarketcal.com/mcp"
    }
  }
}
```

## Tools

- `list_events`: List crypto events
- `get_event`: Get one event
- `list_coins`: List coins

## FAQ

### Do I need an API key?

Yes. The key is sent in the x-api-key header; the README says a free tier is available.

### What does isEstimated mean?

The date is a deadline or the end of a window, not an exact day.

### Which clients have sample configs?

Claude Code, Cursor, VS Code, Codex CLI, and Claude Desktop through mcp-remote.

### What licence is the repo?

The code is MIT; the data falls under the API Terms of Service.

### Is CoinMarketCal free?

CoinMarketCal has a free plan, with paid plans for more usage or features.

### How do I add CoinMarketCal to Claude Code?

Run this command in your terminal: claude mcp add --transport http events https://coinmarketcal.com/mcp

### What are the best alternatives to CoinMarketCal?

The closest alternatives to CoinMarketCal are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, dashboard-icons, Solana MCP by Vybe and Tapetide - Indian Stock Market MCP.

## Where this comes from

- Description: written from the project's README and the project's website.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [dashboard-icons](https://ai-powered.com/mcp/dashboard-icons): dashboard-icons is an open-source MCP server for analytics and data.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [DataArcus for Power BI](https://ai-powered.com/mcp/dataarcus-for-power-bi): DataArcus for Power BI is a free MCP server for analytics and data.

---
Source: https://ai-powered.com/mcp/coinmarketcal
