# 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