# CryptoDataAPI MCP Server
An [MCP (Model Context Protocol)](https://modelcontextprotocol.io) server that gives AI agents real-time crypto market data through [CryptoDataAPI](https://cryptodataapi.com).
## What You Get
**13 tools** covering the full crypto market:
| Tool | Description |
|------|-------------|
| `get_daily_snapshot` | Full market overview in a single call — health scores, derivatives, sentiment, macro, ETF flows, cycle indicators |
| `get_market_health` | Dual-score market health system (0-100) with regime classification |
| `get_fear_greed` | Fear & Greed Index (multi-source averaged, 0-100) |
| `get_funding_rates` | Cross-exchange perpetual funding rates |
| `get_liquidations` | Cross-exchange liquidation volumes (long + short) |
| `get_open_interest` | Cross-exchange open interest with 24h changes |
| `get_btc_cycle` | 8 BTC cycle indicators (MVRV, NUPL, Puell, Pi Cycle, etc.) |
| `get_coin_profile` | Detailed coin data — price, market cap, changes, ATH/ATL |
| `search_coins` | Search coins by name or symbol |
| `get_macro` | Macro indicators — EUR/USD, gold, treasury yields |
| `get_stablecoin_flows` | Stablecoin market cap and capital flows |
| `get_etf_flows` | BTC/ETH/SOL/XRP spot ETF daily flows |
| `get_options` | BTC options data — OI, volume, put/call ratio, max pain |
**1 prompt** for structured analysis:
| Prompt | Description |
|--------|-------------|
| `crypto_market_briefing` | Generates a structured market report with regime, derivatives, sentiment, macro, and takeaways |
## Setup
### 1. Get an API Key
Sign up at [cryptodataapi.com](https://cryptodataapi.com) and create an API key.
### 2. Configure Your AI Client
#### Claude Desktop
Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
```json
{
"mcpServers": {
"cryptodataapi": {
"command": "npx",
"args": ["-y", "cryptodataapi-mcp"],
"env": {
"CRYPTODATA_API_KEY": "cdk_live_your_key_here"
}
}
}
}
```
#### Claude Code
```bash
claude mcp add cryptodataapi -- npx -y cryptodataapi-mcp
```
Then set the env var in your shell profile:
```bash
export CRYPTODATA_API_KEY="cdk_live_your_key_here"
```
#### Cursor
Add to `.cursor/mcp.json` in your project:
```json
{
"mcpServers": {
"cryptodataapi": {
"command": "npx",
"args": ["-y", "cryptodataapi-mcp"],
"env": {
"CRYPTODATA_API_KEY": "cdk_live_your_key_here"
}
}
}
}
```
## Example Usage
Once configured, you can ask your AI:
- "Give me a crypto market briefing"
- "What's the current Fear & Greed index?"
- "Show me BTC funding rates across exchanges"
- "Where are we in the BTC cycle?"
- "What are the ETF flows looking like for Bitcoin?"
- "Look up the Solana coin profile"
## Environment Variables
| Variable | Required | Description |
|----------|----------|-------------|
| `CRYPTODATA_API_KEY` | Yes | Your CryptoDataAPI key (starts with `cdk_live_`) |
| `CRYPTODATA_API_URL` | No | Base URL override (defaults to `https://cryptodataapi.com`) |
## Development
```bash
npm install
npm run build
npm start
```
Test with the MCP Inspector:
```bash
CRYPTODATA_API_KEY=cdk_live_xxx npx @modelcontextprotocol/inspector node dist/index.js
```
## License
MIT
