CoinMarketCal

com.coinmarketcal由 coinmarketcal.com 發布官方發布者v1.0.1更新於 Oct 24, 2026

Crypto events calendar: dated, sourced and impact-scored events for 14,000+ coins.

已驗證Streamable HTTP可網頁執行金融資料與分析

概覽

AI 產生的概覽

CoinMarketCal 的遠端 MCP 伺服器讓助理查詢其行事曆中附日期、來源與影響評分的加密貨幣事件、幣種與分類。

可以做什麼
列出並讀取行事曆事件,包含即將發生與歷史事件,可依幣種、分類與日期範圍篩選,欄位受方案限制,已移除事件會回傳 410 Gone 及取消狀態。依排名或 slug 查詢幣種,並瀏覽編輯分類體系及各分類即將發生事件的數量。查看已驗證金鑰的每月用量計數,以便在觸發限流前退避。
適用情境
適合助理需要回答特定幣種即將發生或過往加密事件問題,或建立呈現行事曆資料與事件影響評分的整合。此伺服器為唯讀,適合研究與監控,不用於交易執行。
執行需求
透過 streamable HTTP 連線 coinmarketcal.com 的遠端 MCP 端點。需要 CoinMarketCal API 金鑰,透過 x-api-key 標頭傳送,提供免費方案。可用結果與欄位取決於方案等級與配額,且與 REST API 共用。
安裝前請注意
API 金鑰屬敏感資訊,透過 x-api-key 標頭傳送,並與 REST API 共用配額,應妥善保管並留意用量。部分欄位與工具(如 list_categories)僅限較高方案。標示為估算的事件日期是截止日期或時間範圍終點,而非確切日期。此伺服器為唯讀,不會修改資料。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 CoinMarketCal,將其新增到工作區。
  2. 連接 x-api-key 憑證。它們會被私密儲存,絕不會在公開頁面上展示。
  3. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/com.coinmarketcal%2Fevents/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "coinmarketcal": {
      "type": "http",
      "url": "https://coinmarketcal.com/mcp",
      "headers": {
        "x-api-key": "<YOUR_API_KEY>"
      }
    }
  }
}

README

CoinMarketCal API

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.

Quick start

Every request sends your key in the x-api-key header.

bash
curl -s "https://api.coinmarketcal.com/v2/events?coins=ethereum&limit=5" \  -H "x-api-key: $COINMARKETCAL_API_KEY"

Each event looks like this (fields depend on your plan):

json
{  "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}

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).

Use it from an AI agent (MCP)

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.

ClientConfiguration
Claude Codemcp/claude-code.sh
Cursor, VS Code and clients using mcpServersmcp/mcp.json
Codex CLImcp/codex.toml
Claude Desktop and clients without remote HTTP supportmcp/mcp-remote.json

Replace YOUR_API_KEY with your key.

Examples

ExampleWhat it does
examples/curl.shList upcoming events, read one event, look up a coin
examples/python/upcoming_events.pyFetch every upcoming event for a coin, page by page
examples/javascript/upcoming-events.mjsSame with Node.js 18+ (fetch)
examples/webhooks/Verify the CMC-Signature header of a webhook delivery (Node.js, Python, PHP)

Data and license

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.

Support

Questions about the API: [email protected].

來源:README.md,提交 0074d74

工具

7

list_events

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`.

輸入參數tofromcoinslimitcursorsortBykeywordimpactMincategories

list_event_cancellations

List 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.

輸入參數limitsincecursor

get_event

Fetch 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`.

輸入參數id必填

list_categories

List 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.

無需輸入參數。

list_coins

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.

輸入參數qlimitcursortracked

get_coin

Fetch a single coin

Returns the full coin payload by slug. 404 when the slug doesn't match any coin (tracked or otherwise).

輸入參數slug必填

get_usage

Monthly 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.

無需輸入參數。

版本歷史

1
  1. v1.0.1最新Oct 15, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分