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 from the venues that publish them, Hyperliquid whale accounts named wallet by wallet, 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.

See it work

One line to connect, no key and no signup, then ask a question no price API can answer:

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

Who sold BTC in the last hour?

A real response, captured 2026-08-05 03:53 UTC:

BTC whale flow, last 1h
  bought   $6.58M
  sold    $19.57M
  net    -$12.99M   across 17 prints

Four accounts did most of the selling:
  0x1ee7a73c...  sold $12.86M
  0x854b9d63...  sold  $1.54M
  0x9e0a3ad8...  sold  $1.29M
  0x4fbf2adf...  sold  $1.03M

Those are the wallets on the other side of the fills, not a guess from a transfer. The number is the whole point: an agent can go from "BTC is down" to "here is who sold, how much, and when" in one call. Run it now and you get that hour, not this one.

Related MCP server: Coinversaa Pulse

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"}'

Cursor — add to ~/.cursor/mcp.json, then reload:

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

Codex

codex mcp add coinlobster --url https://coinlobster.com/mcp

Gemini CLI

gemini mcp add -s user --transport http coinlobster https://coinlobster.com/mcp

Chat apps

These sign in to your CoinLobster account instead of using the keyless URL, so use https://coinlobster.com/mcp/connector in all of them. A free account works.

Full per-app setup: 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

28 names come back from tools/list on production: 27 canonical tools 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).

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 in full (its whale floor is $500K) plus every $1M+ trade on any pair, both live. Other pairs arrive 15 minutes delayed, DEX swaps from $250K. On the radar only BTC is shown in full; any other coin appears only once it turns unusual, and then as name and direction with the dollar amounts stripped.

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.

Not sure which of these you are on? Ask your AI to call my_access. It reports whether you are on the free plan, how many credits are left, the caps applying to that connection right now and what lifts each one, so you do not have to work it out by hitting them.

When an ask exceeds what your connection allows, the answer says so rather than quietly returning less: the payload carries capped with what you requested, what you got, the ceiling and why. by: keyless means a plan lifts it. by: tool_max is a hard ceiling that no plan raises, so there is nothing to buy and no point retrying.

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 funding_matrix, liq_zones, liquidations, whale_context; 60 for defi_liquidations, defi_summary, dex_wallet, hl_board, hl_wallet, hl_whales, market_extremes, market_history, market_overview, market_snapshot, onchain_whales, smart_money, squeeze_score, whale_flow, whale_profile, whale_radar, whale_trades, whale_tape; 100 for crypto_news, flag_outcomes, market_liquidations, market_screener, trade_context). MCP and REST draw on one shared account balance: one plan, one balance, either surface. my_access is always free. Discovery (initialize, tools/list, ping) is free, and failed calls and no-data answers are refunded, whether the answer says so with available, covered, tracked, an error or simply an empty page. One-off credit packs top up that same shared balance: $10 = 5,000, $49 = 50,000, $199 = 250,000.

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.