> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cryptorank.io/llms.txt
> Use this file to discover all available pages before exploring further.
# MCP Server
> Connect Claude, ChatGPT, or any MCP client to CryptoRank data over the Model Context Protocol — plus the full tool catalogue.
The CryptoRank MCP Server is a single, authenticated remote server. There is no keyless tier and no local server — all access goes through your CryptoRank Public API key on the PRO plan or higher.
**Server URL** — `https://api.cryptorank.io/mcp`
## Requirements
| Setup | What you need |
| ------------- | --------------------------------------------------------------------------------------- |
| Web | PRO API Plan · a Claude (Pro & above) or ChatGPT (Plus & above) subscription |
| Desktop / IDE | PRO API Plan · an MCP-compatible client (Claude Desktop, Cursor, Windsurf, Claude Code) |
## Connect
Sign in at claude.ai and open a new conversation.
Click the plus icon in the message toolbar, then **Connectors → Manage Connectors**.
Click the plus icon, then **Add custom connector**, and enter the URL `https://api.cryptorank.io/mcp`. Click **Add**.
Sign in with the CryptoRank account tied to your PRO API plan and approve access. CryptoRank then appears in your connector list.
In a new chat with the connector enabled, ask *"What are the latest crypto funding rounds?"* — you should get live CryptoRank data.
In **Settings → Apps & Connectors → Advanced settings**, turn **Developer mode** ON. It must stay on for MCP connectors to work.
In **Apps & Connectors**, click **Create app**.
Name it `CryptoRank MCP` and set the URL to `https://api.cryptorank.io/mcp`. Save.
Sign in with the CryptoRank account tied to your PRO API plan and approve access.
In a new chat, click the plus icon, select **CryptoRank**, then ask *"What are the latest crypto funding rounds?"* to confirm live data.
Config-file clients connect through `mcp-remote`, passing your API key as an environment variable. After saving and restarting, the CryptoRank tools appear automatically and the model calls them when relevant.
```json mcp config theme={null} theme={null}
{
"mcpServers": {
"cryptorank_mcp": {
"command": "npx",
"args": ["mcp-remote", "https://api.cryptorank.io/mcp"],
"env": {
"CRYPTORANK_API_KEY": "YOUR_PRO_API_KEY"
}
}
}
}
```
Replace `YOUR_PRO_API_KEY` with your CryptoRank API key, then restart the client. For Claude Code, add the server with `claude mcp add` or drop the same `mcpServers` block into your MCP config.
| Client | Config file path |
| ------------------------ | ----------------------------------------------------------------- |
| Claude Desktop (macOS) | `~/Library/Application Support/Claude/claude_desktop_config.json` |
| Claude Desktop (Windows) | `%APPDATA%\Claude\claude_desktop_config.json` |
| Cursor | `.cursor/mcp.json` (project) or `~/.cursor/mcp.json` (global) |
| Windsurf | `~/.codeium/windsurf/mcp_config.json` |
Connectors added mid-conversation don't apply retroactively. If you get generic or stale answers, start a fresh chat and ask explicitly for "latest" or "current" data.
## Pricing & limits
MCP has no separate price — it's bundled with PRO and higher tiers.
## Troubleshooting
| Problem | Fix |
| ------------------------------------------------ | ----------------------------------------------------------------------------------- |
| Connector added but the agent ignores CryptoRank | Toggle the connector OFF → ON, then start a new chat (OAuth-init quirk). |
| "Connectors" not visible in Claude | Requires a Claude Pro/Max/Team/Enterprise plan. Try another browser or clear cache. |
| "Connectors" not visible in ChatGPT | Enable Developer Mode under Apps & Connectors → Advanced settings. |
| "Unable to connect" | Confirm the URL is exactly `https://api.cryptorank.io/mcp`, then retry. |
| "Rate limit exceeded" | Confirm your plan is PRO or higher; wait, or upgrade for higher limits. |
| OAuth popup blocked | Allow popups for the client domain; try Chrome or Edge; disable ad blockers. |
| Connector listed but no tools | Your key likely lacks PRO access — check your plan. |
# MCP Tools
Every tool the CryptoRank MCP server exposes, what it returns, and the jobs it's built for.\
The tools are designed around research workflows, not as a 1:1 mirror of the REST API.
Tools that need an `id` (`get_*`) expect CryptoRank's internal id. Resolve a name, symbol or alias to an `id` first with the matching `search_*` tool (e.g. `search_currency` → `get_currency_profile`).
## Funding rounds
The core fundraising dataset — who raised, how much, from whom, and when.
| Tool | What it returns | Good for |
| ----------------------------- | ------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- |
| `search_funding_round` | Rounds filtered by `investor`, `stage`, `dateRange`, `category`, `raise`, `tags` | *"Recent rounds led by a16z"*, *"AI projects that raised over \$10M in 2026"* |
| `get_funding_round` | One round in full — stage, valuation, source, lead + other investors, project details | Drilling into a single deal |
| `get_currency_funding_rounds` | Every round for one project, with investors and ROI | A project's full investment history |
## Funds & investors
VC profiles, portfolios and activity — built for fund research and sales prospecting.
| Tool | What it returns | Good for |
| ------------------ | ----------------------------------------------------------------------------------------------------------- | -------------------------------------------------------- |
| `search_fund` | Funds ranked/filtered by `type`, tier, portfolio, ROI, activity in a `dateRange` | *"Top funds active this quarter"*, discovery and ranking |
| `get_fund_profile` | Fund profile — tier, portfolio size, Retail ROI, top investments, focus narratives/countries, recent rounds | *"a16z's latest deals and focus"* |
| `get_fund_team` | Full fund team — names, roles, social links | Sourcing contacts at a fund |
## Coins & market data
Project metadata plus current and historical market data.
| Tool | What it returns | Good for |
| ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------- |
| `search_currency` | Traded coins with market metrics; filter by `name`, `symbol`, `category`, `tag`, `percentChange`; sort by rank/cap/volume/change | Building coin lists, resolving a symbol to an `id` |
| `get_currency_profile` | Extended profile — metadata, categories/tags, supply, market indicators, contracts, top-3 team | A single coin's full snapshot |
| `get_historical_currency` | OHLC, volume, market cap and supply for one coin over a date range (`day`/`week`/`month`) | *"ETH price in March 2023"*, time-series analysis |
| `search_historical_currency` | Market snapshot for many coins at one point in `time` | Cross-section of the market on a given date |
## Vesting & token unlocks
| Tool | What it returns | Good for |
| ---------------------- | ----------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------- |
| `search_unlock` | Coins with upcoming unlocks; filter by `nextUnlockDate`, `nextUnlockValueUSD`, share of supply/mcap; `hideSmallUnlocks` | *"Big unlocks this week"*, market-wide unlock watch |
| `get_currency_vesting` | Full vesting and allocation data for one coin — per-allocation type, frequency, duration, upcoming events | *"How well-designed is TON's vesting?"* |
## Teams & people
| Tool | What it returns | Good for |
| ------------------- | ------------------------------------------------------------------------------- | ------------------------------------------------------------------ |
| `get_currency_team` | Complete project team (current + former) with roles, descriptions, social links | *"Contacts for the Solana team"* — fuller than the profile's top-3 |
## Public sales
| Tool | What it returns | Good for |
| -------------------- | ------------------------------------------------------------------------------------------------------------- | ---------------------------------------- |
| `search_public_sale` | IDO/ICO/IEO sales; filter by `crowdsaleStatus`, `dateRange`, `launchpadIds`, `raise`, `lifeCycle`, `isTraded` | Discovery of public fundraising activity |
| `get_public_sale` | All public sale rounds for one project — type, dates, price, raise, allocation, ROI, launchpad | Detailed sale history for a project |
## Launchpads
| Tool | What it returns | Good for |
| ----------------------- | ------------------------------------------------------------------------------------------------------ | ------------------------------------- |
| `search_launchpad` | Launchpads with key metrics (rank, ROI, raised) | Ranking and discovery |
| `get_launchpad_profile` | Launchpad profile — ROI, ATH ROI, total/average raise, top & recent projects, categories (`timeframe`) | Evaluating a launchpad's track record |
| `get_launchpad_team` | Full launchpad team with roles and links | Contacts at a launchpad |
## Global market
| Tool | What it returns | Good for |
| ----------------- | ---------------------------------------------------------------------------------------------------------------- | ------------------------- |
| `get_global_data` | Total/active projects, BTC & ETH dominance, Fear & Greed, Altcoin Season Index, total market cap and spot volume | High-level market context |
## Drophunting
| Tool | What it returns | Good for |
| -------------------------- | ------------------------------------------------------------------------------------- | ------------------------------ |
| `search_drophunting` | Activities filtered by `status`, `reward` type; sorted by update/name | Discovering airdrop activities |
| `get_drophunting_activity` | One activity in full — rewards, participating funds, social metrics, tasks and guides | Working a specific airdrop |
## Common workflows
Each maps to one or two tools — no manual chaining:
| Question | Tools |
| ----------------------------------------- | ----------------------------------------------------------------- |
| *"Find projects a16z invested in"* | `search_funding_round` (investor) → `get_currency_funding_rounds` |
| *"Recent rounds with lead investor a16z"* | `search_funding_round` |
| *"Who invested in SUI?"* | `search_currency` → `get_currency_funding_rounds` |
| *"Funds focused on Privacy"* | `search_fund` |
| *"a16z Crypto's latest deals"* | `search_fund` → `get_fund_profile` |
| *"Big unlocks this week"* | `search_unlock` |
| *"How solid is TON's vesting?"* | `search_currency` → `get_currency_vesting` |
| *"Contacts for the Solana team"* | `search_currency` → `get_currency_team` |
| *"ETH price in March 2023"* | `search_currency` → `get_historical_currency` |