# CoinMarketCap — how to use (mcp.ai)

Connect your CoinMarketCap account and use 9 tools for analytics straight from your AI agent. Connect with your own API key. CoinMarketCap provides a comprehensive cryptocurrency market data API, offering real-time and historical data on cryptocurrencies and exchanges.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_coinmarketcap?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. `coinmarketcap_cryptocurrency_listings_latest`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/coinmarketcap`
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/coinmarketcap/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/coinmarketcap/cryptocurrency/listings/latest` — Fetch the latest cryptocurrency market listings from CoinMarketCap. Returns a ranked list of active cryptocurrencies with real-time price, market cap, 24h volume, and percent changes. By default retur
  - body: { aux?: string, tag?: string, sort?: string, limit?: integer, start?: integer, convert?: string, sort_dir?: string, price_max?: number, price_min?: number, convert_id?: string, market_cap_max?: number, market_cap_min?: number, volume_24h_max?: number, volume_24h_min?: number, cryptocurrency_type?: string, circulating_supply_max?: number, circulating_supply_min?: number, percent_change_24h_max?: number, percent_change_24h_min?: number }
- `POST https://api.mcp.ai/api/coinmarketcap/cryptocurrency/map` — Tool to retrieve a mapping of all cryptocurrencies, including their unique IDs, symbols, and names. Use when you need reference IDs for crypto assets. Response results are nested under a `data` key.
  - body: { id?: string, aux?: string, slug?: string, sort?: string, limit?: integer, start?: integer, symbol?: string, listing_status?: string }
- `POST https://api.mcp.ai/api/coinmarketcap/cryptocurrency/quotes/latest` — Tool to get the latest aggregated global market quotes for one or more cryptocurrencies. Exactly one of id, symbol, or slug must be provided; combining multiple identifier types or omitting all causes
  - body: { id?: string, aux?: string, slug?: string, symbol?: string, convert?: string, convert_id?: string, skip_invalid?: boolean }
- `POST https://api.mcp.ai/api/coinmarketcap/get/cryptocurrency/info` — Tool to fetch metadata (description, logo, URLs) for one or more cryptocurrencies. Use when you need static asset details like descriptions, logos, and related links. Exactly one of `id`, `slug`, or `
  - body: { id?: integer[], slug?: string[], symbol?: string[] }
- `POST https://api.mcp.ai/api/coinmarketcap/get/exchange/info` — Tool to get detailed metadata for one or more exchanges. Use when you need exchange logos, supported fiats, launch dates, and official links.
  - body: { id?: integer[], aux?: string, slug?: string[] }
- `POST https://api.mcp.ai/api/coinmarketcap/get/key/info` — Tool to retrieve your CoinMarketCap API key details, rate limits, and usage statistics. Use after setting your API key to inspect limits and usage.
- `POST https://api.mcp.ai/api/coinmarketcap/global/metrics/quotes/latest` — Tool to obtain the latest global cryptocurrency market metrics (market cap, volume, dominance). Use when you need aggregated market-level data for analysis.
  - body: { convert?: string, convert_id?: string }
- `POST https://api.mcp.ai/api/coinmarketcap/partner/map` — Tool to retrieve a mapping of all CoinMarketCap partners with their unique IDs, names, and slugs. Use when you need to map partner names or slugs to numeric IDs.
  - body: { slug?: string, limit?: integer, start?: integer, listing_status?: string }
- `POST https://api.mcp.ai/api/coinmarketcap/tools/price/conversion` — Tool to convert an amount from one cryptocurrency or fiat currency into another. Either `id` or `symbol` must be provided as the source currency identifier. Use when conversion rates are needed. Unsup
  - body: { id?: integer, time?: string, amount: number, symbol?: string, convert?: string, convert_id?: string }

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

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