CoinLobster MCP · Live Crypto Whale Trades for AI Agents

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.

The only MCP server with live cross-exchange whale trades. Price data is everywhere, what whales just did is not.

Try asking

• "What are whales doing with BTC right now?"
• "Which coins have unusual whale activity in the last 4 hours?"
• "Are longs or shorts getting liquidated on BTC today?"
• "Show the last 10 whale signals that fired and what price did after each."
• "Compare whale buying vs selling on SOL over the past 24 hours."

Install

Recommended: the hosted server. Nothing to install, and it is always current. Point any streamable-HTTP MCP client at it:

{
  "mcpServers": {
    "coinlobster": { "url": "https://coinlobster.com/mcp" }
  }
}

Claude Code

claude mcp add --transport http coinlobster https://coinlobster.com/mcp

VS Code

code --add-mcp '{"name":"coinlobster","url":"https://coinlobster.com/mcp"}'

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

Any shell, no MCP client: the hosted server answers plain JSON-RPC over curl (see How it works).

Local stdio, via npm

If you prefer a local process (or your client only speaks stdio), this package is a thin proxy to the same hosted server:

claude mcp add coinlobster -- npx -y coinlobster-mcp

{
  "mcpServers": {
    "coinlobster": {
      "command": "npx",
      "args": ["-y", "coinlobster-mcp"]
    }
  }
}

code --add-mcp '{"name":"coinlobster","command":"npx","args":["-y","coinlobster-mcp"]}'

Either path serves the same data and the same tool schemas.

Tools

17 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).

Tool	What it returns
whale_trades	Live whale trades across 15 CEX venues + ETH/Base/Arbitrum DEX swaps, newest first. Filter by coin, source, min USD.
whale_radar	Coins with unusual whale flow right now, across 1h / 4h / 24h windows. The best first call.
flag_outcomes	Signals that fired, with fire-time price and what price did next. Hits and misses.
whale_flow	Hourly whale buy vs sell USD volume for one coin, CEX and DEX split.
liquidations	Recent liquidations for a pair with the long / short breakdown.
market_snapshot	Price, 24h stats, average funding, open interest and liquidation totals in one call.
crypto_news	Recent headlines + a sentiment score (-100 to +100) for a coin, plus the macro picture.
whale_tape	Deprecated alias of whale_trades. Same tool, same arguments.
market_history	Daily funding, open interest, price and whale-flow history, months deep (30d keyless, full archive on a developer plan, from $29/mo).
market_extremes	Pairs at records or their own top/bottom 5% for funding, OI or liquidations, with next-day outcome stats for past occurrences.
whale_context	Whale flow vs the coin's own logged history: multiple of its average, N-day highs, buy share (USD magnitudes need depth).
market_overview	One-call market scan: totals, 24h whale net flow, BTC risk regime, top rows by volume.
market_screener	Screen coins by funding band, OI band, whale multiple or unusual-only.
funding_matrix	Per-venue funding rates with predicted next rate where the venue provides it.
squeeze_score	Fused 0-100 crowding read with the overexposed side (needs an active developer plan, from $29/mo).
liq_zones	Projected liquidation level book, always labeled a projection, never recorded trades (keyless: free pairs, no cascade chains).
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.

All tools are read-only and return descriptive market data only. Never financial advice.

Free tier, and what actually lifts the caps

The 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.

A free API key does not lift the MCP caps. The free key is a one-off 1,000-credit grant (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.

Full 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.

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.

Keyless 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.

Once the npm package ships, a developer plan key travels in the stdio config:

{
  "mcpServers": {
    "coinlobster": {
      "command": "npx",
      "args": ["-y", "coinlobster-mcp"],
      "env": { "COINLOBSTER_API_KEY": "cl_your_key" }
    }
  }
}

How it works

This 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.

Raw call, no client needed:

curl -s -X POST https://coinlobster.com/mcp \
  -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"whale_radar","arguments":{}}}'

• Live data pages: whale feed · radar · whale statistics
• Agent-readable docs: llms.txt · crypto-whales.md · radar.md
• REST API: coinlobster.com/developers · OpenAPI: openapi.json

Development

From a local checkout:

npm install
npm test   # live smoke: initialize + tools/list + a whale_radar call

MIT licensed. Issues and PRs welcome once the repo is public.