README.md
Connects AI agents to real-time crypto market data
CryptoDataAPI MCP Server
An MCP (Model Context Protocol) server that gives AI agents real-time crypto market data through CryptoDataAPI.
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 and create an API key.
2. Configure Your AI Client
Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"cryptodataapi": {
"command": "npx",
"args": ["-y", "cryptodataapi-mcp"],
"env": {
"CRYPTODATA_API_KEY": "cdk_live_your_key_here"
}
}
}
}
Claude Code
claude mcp add cryptodataapi -- npx -y cryptodataapi-mcp
Then set the env var in your shell profile:
export CRYPTODATA_API_KEY="cdk_live_your_key_here"
Cursor
Add to .cursor/mcp.json in your project:
{
"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
npm install
npm run build
npm start
Test with the MCP Inspector:
CRYPTODATA_API_KEY=cdk_live_xxx npx @modelcontextprotocol/inspector node dist/index.js
License
MIT
Tools (13)
get_daily_snapshotProvides a full market overview including health scores, derivatives, sentiment, macro, ETF flows, and cycle indicators.get_market_healthReturns a dual-score market health system (0-100) with regime classification.get_fear_greedRetrieves the multi-source averaged Fear & Greed Index (0-100).get_funding_ratesFetches cross-exchange perpetual funding rates.get_liquidationsRetrieves cross-exchange liquidation volumes for long and short positions.get_open_interestProvides cross-exchange open interest data with 24h changes.get_btc_cycleReturns 8 BTC cycle indicators including MVRV, NUPL, Puell, and Pi Cycle.get_coin_profileProvides detailed coin data including price, market cap, changes, and ATH/ATL.search_coinsSearches for coins by name or symbol.get_macroRetrieves macro indicators such as EUR/USD, gold, and treasury yields.get_stablecoin_flowsProvides stablecoin market cap and capital flow data.get_etf_flowsRetrieves daily spot ETF flows for BTC, ETH, SOL, and XRP.get_optionsProvides BTC options data including OI, volume, put/call ratio, and max pain.Environment Variables
CRYPTODATA_API_KEYrequiredYour CryptoDataAPI key (starts with cdk_live_)CRYPTODATA_API_URLBase URL override (defaults to https://cryptodataapi.com)Configuration
claude_desktop_config.json
{"mcpServers": {"cryptodataapi": {"command": "npx", "args": ["-y", "cryptodataapi-mcp"], "env": {"CRYPTODATA_API_KEY": "cdk_live_your_key_here"}}}}Try it
→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?