English Français العربية

CoinMarketCal

السجل الرسمي الإنتاجية

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

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http coinmarketcal 'https://coinmarketcal.com/mcp' --header 'x-api-key: <CoinMarketCal API key (free tier available at https://coinmarketcal.com/developer)>'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "coinmarketcal": {
            "type": "http",
            "url": "https://coinmarketcal.com/mcp",
            "headers": {
                "x-api-key": "<CoinMarketCal API key (free tier available at https://coinmarketcal.com/developer)>"
            }
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. CoinMarketCal API
  2. Quick start
  3. Use it from an AI agent (MCP)
  4. Examples
  5. Data and license
  6. Support

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.

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

{
  "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: api@coinmarketcal.com.

الأسئلة الشائعة

ما هو CoinMarketCal؟

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

كيف أثبّت CoinMarketCal؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http coinmarketcal 'https://coinmarketcal.com/mcp' --header 'x-api-key: <CoinMarketCal API key (free tier available at https://coinmarketcal.com/developer)>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج CoinMarketCal إلى مفتاح API؟

نعم. يتطلب x-api-key، وتضبطها في إعداداته.

هل CoinMarketCal مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون CoinMarketCal؟

ينشره CoinMarketCal. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.