{
  "markdown": "# CoinLobster MCP · Live Crypto Whale Trades for AI Agents\n\n**No API key required.** Real executed whale trades (not wallet transfers) merged live across **15 exchanges** (Binance, Coinbase, Bybit, OKX, Kraken and more) plus on-chain DEX swaps on **Ethereum, Base and Arbitrum**, with a Smart Money Radar for unusual flow, liquidations, market snapshots and outcome-scored signals.\n\nThe only MCP server with live cross-exchange whale trades. Price data is everywhere, *what whales just did* is not.\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n[![npm](https://img.shields.io/npm/v/coinlobster-mcp)](https://www.npmjs.com/package/coinlobster-mcp)\n\n## Try asking\n\n- *\"What are whales doing with BTC right now?\"*\n- *\"Which coins have unusual whale activity in the last 4 hours?\"*\n- *\"Are longs or shorts getting liquidated on BTC today?\"*\n- *\"Show the last 10 whale signals that fired and what price did after each.\"*\n- *\"Compare whale buying vs selling on SOL over the past 24 hours.\"*\n\n## Install\n\n**Recommended: the hosted server.** Nothing to install, and it is always current.\nPoint any streamable-HTTP MCP client at it:\n\n```json\n{\n  \"mcpServers\": {\n    \"coinlobster\": { \"url\": \"https://coinlobster.com/mcp\" }\n  }\n}\n```\n\n**Claude Code**\n\n```bash\nclaude mcp add --transport http coinlobster https://coinlobster.com/mcp\n```\n\n**VS Code**\n\n```bash\ncode --add-mcp '{\"name\":\"coinlobster\",\"url\":\"https://coinlobster.com/mcp\"}'\n```\n\n**Claude web / desktop** can add it as a connector instead: `https://coinlobster.com/mcp/connector` (sign in with a free CoinLobster account). Full setup guide: [coinlobster.com/connect](https://coinlobster.com/connect)\n\n**Any shell, no MCP client:** the hosted server answers plain JSON-RPC over curl (see [How it works](#how-it-works)).\n\n### Local stdio, via npm\n\nIf you prefer a local process (or your client only speaks stdio), this package is a\nthin proxy to the same hosted server:\n\n```bash\nclaude mcp add coinlobster -- npx -y coinlobster-mcp\n```\n\n```json\n{\n  \"mcpServers\": {\n    \"coinlobster\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"coinlobster-mcp\"]\n    }\n  }\n}\n```\n\n```bash\ncode --add-mcp '{\"name\":\"coinlobster\",\"command\":\"npx\",\"args\":[\"-y\",\"coinlobster-mcp\"]}'\n```\n\nEither path serves the same data and the same tool schemas.\n\n## Tools\n\n17 tools are live on production: 16 canonical plus `whale_tape`, a deprecated alias kept working for existing callers. Prefer `whale_trades`. Call `tools/list` before relying on any tool, the set grows and this table is not the source of truth (`npm test` only checks that `tools/list` is non-trivial and that `whale_radar` answers, so it stays green across additions).\n\n| Tool | What it returns |\n| --- | --- |\n| `whale_trades` | Live whale trades across 15 CEX venues + ETH/Base/Arbitrum DEX swaps, newest first. Filter by coin, source, min USD. |\n| `whale_radar` | Coins with **unusual** whale flow right now, across 1h / 4h / 24h windows. The best first call. |\n| `flag_outcomes` | Signals that fired, with fire-time price and what price did next. Hits and misses. |\n| `whale_flow` | Hourly whale buy vs sell USD volume for one coin, CEX and DEX split. |\n| `liquidations` | Recent liquidations for a pair with the long / short breakdown. |\n| `market_snapshot` | Price, 24h stats, average funding, open interest and liquidation totals in one call. |\n| `crypto_news` | Recent headlines + a sentiment score (-100 to +100) for a coin, plus the macro picture. |\n| `whale_tape` | Deprecated alias of `whale_trades`. Same tool, same arguments. |\n| `market_history` | Daily funding, open interest, price and whale-flow history, months deep (30d keyless, full archive on a developer plan, from $29/mo). |\n| `market_extremes` | Pairs at records or their own top/bottom 5% for funding, OI or liquidations, with next-day outcome stats for past occurrences. |\n| `whale_context` | Whale flow vs the coin's own logged history: multiple of its average, N-day highs, buy share (USD magnitudes need depth). |\n| `market_overview` | One-call market scan: totals, 24h whale net flow, BTC risk regime, top rows by volume. |\n| `market_screener` | Screen coins by funding band, OI band, whale multiple or unusual-only. |\n| `funding_matrix` | Per-venue funding rates with predicted next rate where the venue provides it. |\n| `squeeze_score` | Fused 0-100 crowding read with the overexposed side (needs an active developer plan, from $29/mo). |\n| `liq_zones` | Projected liquidation level book, always labeled a projection, never recorded trades (keyless: free pairs, no cascade chains). |\n| `trade_context` | The one-call pre-trade blob: price, funding and OI with percentile judgment vs the pair's own recorded days, whale flow vs baseline, visible liquidations, carry-cost arithmetic. |\n\nAll tools are read-only and return descriptive market data only. Never financial advice.\n\n## Free tier, and what actually lifts the caps\n\nThe free tier needs nothing: BTC/USD and every $1M+ trade stream in real time, other pairs are delayed 15 minutes, DEX swaps $250K and larger, radar magnitudes withheld on non-majors.\n\n**A free API key does not lift the MCP caps.** The free key is a one-off 1,000-credit grant ([coinlobster.com/developers](https://coinlobster.com/developers), no card) that unlocks the metered REST endpoints at `/api/ai/v1/*`, roughly 20 to 100 calls in total. On MCP it changes nothing.\n\nFull MCP depth (live feed on every pair, unlocked radar magnitudes, non-BTC `market_snapshot`, 30-day flow windows, the full archive) needs **an active developer plan**: Builder $29/mo (100k credits), Growth $99/mo (500k), Scale $249/mo (2M). One plan covers both full-depth MCP and the monthly REST credits. Present it either as a `cl_` key in `X-API-Key` on the MCP request, or by signing in over the OAuth connector at `https://coinlobster.com/mcp/connector` with an account that owns a plan.\n\n**CoinLobster Pro ($9/mo) is a different product**: the coinlobster.com website (live feed, alerts, whale radar). It grants no MCP depth and no API access.\n\nKeyless calls cost nothing. On a developer plan, an MCP tool call costs **2x the mirrored REST endpoint: 40 to 100 credits, by tool** (40 for `whale_context`, `liquidations`, `funding_matrix`, `liq_zones`; 60 for `whale_trades`, `whale_tape`, `whale_radar`, `whale_flow`, `market_history`, `market_extremes`, `market_snapshot`, `market_overview`, `squeeze_score`; 100 for `flag_outcomes`, `crypto_news`, `market_screener`, `trade_context`). MCP and REST draw on one shared account balance: one plan, one balance, either surface. Discovery (`initialize`, `tools/list`, `ping`) is free, and failed calls and no-data answers are refunded. One-off credit packs top up that same shared balance: $10 = 5,000, $49 = 50,000, $199 = 250,000.\n\nOnce the npm package ships, a developer plan key travels in the stdio config:\n\n```json\n{\n  \"mcpServers\": {\n    \"coinlobster\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"coinlobster-mcp\"],\n      \"env\": { \"COINLOBSTER_API_KEY\": \"cl_your_key\" }\n    }\n  }\n}\n```\n\n## How it works\n\nThis package is a thin stdio proxy to CoinLobster's hosted MCP server (`https://coinlobster.com/mcp`, streamable HTTP). Tool schemas and results come from the hosted server verbatim, so new tools appear without a package update. The heavy lifting (exchange streaming, on-chain indexing, signal scoring) runs on CoinLobster's pipeline; your machine just relays JSON-RPC.\n\nRaw call, no client needed:\n\n```bash\ncurl -s -X POST https://coinlobster.com/mcp \\\n  -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \\\n  -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\"params\":{\"name\":\"whale_radar\",\"arguments\":{}}}'\n```\n\n- Live data pages: [whale feed](https://coinlobster.com/crypto-whales) · [radar](https://coinlobster.com/radar) · [whale statistics](https://coinlobster.com/whale-statistics)\n- Agent-readable docs: [llms.txt](https://coinlobster.com/llms.txt) · [crypto-whales.md](https://coinlobster.com/crypto-whales.md) · [radar.md](https://coinlobster.com/radar.md)\n- REST API: [coinlobster.com/developers](https://coinlobster.com/developers) · OpenAPI: [openapi.json](https://coinlobster.com/openapi.json)\n\n## Development\n\nFrom a local checkout:\n\n```bash\nnpm install\nnpm test   # live smoke: initialize + tools/list + a whale_radar call\n```\n\nMIT licensed. Issues and PRs welcome once the repo is public.",
  "bytes": 8410,
  "sha": "7aa9425909fc5e871c58de13ae0efb94a0f2ae56a353090a5593e559258713c8",
  "repo_slug": "coinlobster/coinlobster-mcp",
  "fonte": "npm",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_coinlobster_whale_data_b27afa99/readme"
}