# CoinMarketCal — how to use (mcp.ai)

Connect your CoinMarketCal account and use 3 tools for analytics straight from your AI agent. Connect with your own API key. CoinMarketCal is a community-driven crypto calendar, highlighting upcoming events, announcements, and releases, helping traders and enthusiasts track market-impacting developments in the cryptocurrency space.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_coinmarketcal?ms=1787291400000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `coinmarketcal_list_coins`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/coinmarketcal`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/coinmarketcal/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/coinmarketcal/list/coins` — Tool to retrieve list of all available coins/cryptocurrencies in CoinMarketCal database. Use when you need to fetch coin information including IDs, names, symbols, and event counts.
- `POST https://api.mcp.ai/api/coinmarketcal/list/event/categories` — Tool to list all event categories. Use when you need to fetch available event categories.
- `POST https://api.mcp.ai/api/coinmarketcal/list/events` — Tool to retrieve list of cryptocurrency events. Use when you need to fetch upcoming or past crypto events filtered by date range, coins, categories, or other criteria. Note: Cannot retrieve events bef
  - body: { max?: integer, page?: integer, coins?: string, sortBy?: string, showOnly?: string, showViews?: boolean, showVotes?: boolean, categories?: string, dateRangeEnd?: string, translations?: string, dateRangeStart?: string }

## Example prompts
- "What can I do in CoinMarketCal?"
- "Show me a summary of my CoinMarketCal account"

## More
- Page: https://mcp.ai/coinmarketcal
- Agent spec (llms.txt): https://mcp.ai/coinmarketcal/llms.txt
- Postman collection: https://mcp.ai/coinmarketcal/postman.json