# Coinranking — how to use (mcp.ai)

Connect your Coinranking account and use 14 tools for analytics straight from your AI agent. Connect with your own API key. Coinranking provides a comprehensive API for accessing cryptocurrency market data, including coin prices, market caps, and historical data.

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

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

### Endpoints
- `POST https://api.mcp.ai/api/coinranking/get/coin/details` — Retrieve comprehensive details for a specific cryptocurrency including current price, market cap, supply metrics, description, social links, sparkline data, and historical performance. Use when you ne
  - body: { uuid: string, timePeriod?: string, referenceCurrencyUuid?: string }
- `POST https://api.mcp.ai/api/coinranking/get/coin/fiat/prices` — Tool to retrieve the current price of a cryptocurrency in all available fiat currencies including USD, EUR, GBP, and more. Use when you need to see how much a coin is worth across multiple fiat curren
  - body: { uuid: string }
- `POST https://api.mcp.ai/api/coinranking/get/coin/history` — Tool to retrieve historical price data for a specific coin over a time period. Use when you need to analyze past performance of a coin; call after confirming its UUID.
  - body: { id: string, timePeriod?: string, referenceCurrencyUuid?: string }
- `POST https://api.mcp.ai/api/coinranking/get/coin/price` — Tool to retrieve the current price or historical price at a specific timestamp for a cryptocurrency coin. Use when you need to get the current valuation of a coin or look up its price at a historical 
  - body: { uuid: string, timestamp?: integer, referenceCurrencyUuid?: string }
- `POST https://api.mcp.ai/api/coinranking/get/coin/price/history` — Tool to retrieve historical price data points for a specific coin over selectable time periods. Use when you need price history for charting, backtesting, or trend analysis. Call after confirming the 
  - body: { uuid: string, timePeriod?: string, referenceCurrencyUuid?: string }
- `POST https://api.mcp.ai/api/coinranking/get/coin/trading/volume/history` — Tool to retrieve historical trading volume data for a specific coin to build volume charts and analyze liquidity trends. Use when you need to analyze trading volume patterns over time; requires a prof
  - body: { uuid: string, limit?: integer, interval?: string, referenceCurrencyUuid?: string }
- `POST https://api.mcp.ai/api/coinranking/get/coins` — Retrieve a comprehensive list of cryptocurrency coins with detailed market data including prices, market caps, rankings, and price history. Supports filtering by search terms, quality tiers, and sorti
  - body: { limit?: integer, tiers?: string, offset?: integer, search?: string, orderBy?: string, timePeriod?: string, orderDirection?: string, referenceCurrencyUuid?: string }
- `POST https://api.mcp.ai/api/coinranking/get/reference/currencies` — Retrieve a comprehensive list of reference currencies including cryptocurrencies, fiat currencies (USD, EUR, etc.), denominators (Satoshi, Wei), and assets (Gold, Silver). Use this to get available cu
  - body: { limit?: integer, types?: string[], cursor?: string, offset?: integer, search?: string }
- `POST https://api.mcp.ai/api/coinranking/get/stats` — Tool to retrieve global cryptocurrency market statistics. Use when you need an overview of the entire crypto market.
- `POST https://api.mcp.ai/api/coinranking/get/stats/coins` — Tool to retrieve aggregate statistics for a selection of coins. Use when you need to calculate combined metrics for custom baskets, watchlists, or index products including market cap, trading volume, 
  - body: { uuids?: string[], timePeriod?: string, referenceCurrencyUuid?: string }
- `POST https://api.mcp.ai/api/coinranking/get/tag/details` — Get detailed information about a specific cryptocurrency tag including market metrics, volume, associated coin count, and dominance data. Use when you need comprehensive information about a tag catego
  - body: { slug: string, timePeriod?: string, referenceCurrencyUuid?: string }
- `POST https://api.mcp.ai/api/coinranking/get/tags` — Get all available cryptocurrency tags/categories from Coinranking. Tags are used to categorize cryptocurrencies (e.g., DeFi, NFT, Stablecoins, Meme coins, etc.). This endpoint returns comprehensive in
- `POST https://api.mcp.ai/api/coinranking/get/trending/coins` — Retrieve a list of trending cryptocurrency coins ranked by user engagement and popularity on Coinranking. Supports optional filtering by reference currency, time period, coin tiers, and pagination. Re
  - body: { limit?: integer, tiers?: string, offset?: integer, timePeriod?: string, referenceCurrencyUuid?: string }
- `POST https://api.mcp.ai/api/coinranking/search/suggestions` — Tool to search and get suggestions for coins, markets, exchanges, fiat currencies, and categories by name, symbol, or contract address. Use when you need fast search suggestions across multiple entity
  - body: { query: string }

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

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