CoinMarketCap MCP Server

CoinMarketCap

Real-time and historical cryptocurrency market data from the CoinMarketCap Pro API. Read-only — rankings, quotes, metadata, categories, exchanges, and aggregate market metrics.

Operational order

1. Resolve ids — map symbols to CoinMarketCap numeric ids before quotes, metadata, or pairs when tickers may collide.
2. Market snapshot — global metrics for total cap and BTC dominance; listings latest for top-N by market cap.
3. Asset drill-down — latest quotes for price/volume; metadata for logos, URLs, and descriptions.
4. Sector view — categories list, then single category for coins in a sector.
5. Exchange context — exchange map, then exchange metadata by slug when the user names a venue.

Entity domains

Reference maps

• Cryptocurrency map — symbol/name → numeric id (prefer id on all downstream calls).
• Exchange map — exchange id and slug for metadata lookups.
• Fiat map — supported convert currencies (USD, EUR, …).

Market reads

• Listings — listing_type latest (current rankings), historical (requires date=YYYY-MM-DD), or new (recently listed). Aliases spot/market/current → latest — there is no /listings/spot route.
• Quotes — quote_type latest or historical; requires symbol or id. Historical needs count/interval or time_start/time_end.
• Global metrics — total market cap, 24h volume, BTC dominance.

Metadata

• Cryptocurrency info — static profile (logo, description, links) by id, symbol, or slug.
• Exchange info — exchange profile by id or slug (e.g. binance).
• Categories — sector list; open one category by id for its coin roster.

Plan-gated reads (higher CoinMarketCap API tiers)

Trending (latest, gainers/losers, most visited), market pairs, OHLCV candles, and price-performance stats may return plan errors on lower-tier keys. Prefer listings + quotes + map on basic plans.

Workflows

• Top coins today: global metrics → listings latest (limit 25) → quotes latest for top symbols.
• Single asset: crypto map (symbol filter) → crypto info → quotes latest → optional historical quotes for a chart window.
• Sector scan: categories (limit 20) → category by id → quotes latest for top coins in that sector.
• Exchange research: exchange map → exchange info by slug → market pairs for a base asset (when plan allows).

Gotchas

• Prefer CoinMarketCap id over symbol — duplicate tickers exist; symbol-only calls default to the highest market-cap match.
• Listings historical requires date=YYYY-MM-DD; quotes historical needs a time window or count.
• Pagination uses 1-based start and limit (default 100 on map tools, not 1000).
• Convert parameter accepts comma-separated fiat or crypto symbols; default denomination is USD.
• Credits — each call consumes CoinMarketCap API plan credits; batch id lookups instead of repeated single-symbol map calls when possible.