CoinLobster MCP is a read-only, descriptive live crypto market data server: whale trades, whale flow, liquidations, funding/open interest, news sentiment and signal outcomes across CEX venues plus Ethereum/Base/Arbitrum DEX swaps (no forecasts or advice).
Whale trades — whale_trades (plus deprecated alias whale_tape): live CEX trades merged with on-chain DEX swaps, newest first, max 50 rows; filter by coin, source (cex/dex/all), min_usd, limit.
Unusual whale activity — whale_radar: which coins show unusual whale flow now, over 1h/4h/24h windows.
Whale flow — whale_flow (needs coin, optional hours): hourly buy/sell USD buckets with CEX vs DEX split.
Whale flow vs own history — whale_context: multiple of the coin's daily average, N-day-high flags, buy share now vs 7d; accepts a comma-separated coin list for portfolio briefs.
Liquidations — liquidations (recent force-closes per pair with long/short counts and USD split) and liq_zones (projected, modeled liquidation levels).
Market state — market_snapshot (price, 24h stats, funding, OI, liquidation totals for a pair), market_overview (totals, whale net flow, BTC risk regime, top rows by volume, optional single coin), market_extremes (pairs at records or top/bottom 5% for funding, OI or liquidations, with next-day outcome stats).
Funding & positioning — funding_matrix (per-venue rates, predicted next rate, payout time) and squeeze_score (0–100 crowding read with the overexposed side; paid plan).
One-call trade context — trade_context: price, cross-venue funding with carry arithmetic (position_usd), OI, whale flow vs baseline and visible liquidations for any streamed pair; compact: true returns a ~30-token one-liner.
Screening — market_screener: filter every recorded pair by funding_band/oi_band (vs each pair's own history), whale_mult_min, unusual_only, limit, compact.
History — market_history: daily funding, OI, price and liquidations for a pair, or daily whale buy/sell flow for a coin.
Signal record — flag_outcomes: recently fired signal flags with fire-time price and later outcomes (logged live, never backfilled), filterable by coin, type, hours, limit.
News — crypto_news: recent headlines with a pre-computed sentiment score (−100 to +100) for a coin plus the macro picture.
Permissions/limits — all tools are read-only, non-destructive and idempotent; keyless calls get a reduced shape (e.g. BTC/USD live, other pairs delayed 15–30 min, 50-row caps) and a paid developer plan lifts depth, coverage and percentile judgments.
Caveats: the README claims 18 exchanges and webhook alerts, while the schema lists 15 CEX venues and exposes no alert tool; call tools/list for the current set.
Provides live executed whale trades from Binance as part of a multi-exchange feed, filterable by coin, source, and minimum USD value.
Provides live executed whale trades from Coinbase as part of a multi-exchange feed, filterable by coin, source, and minimum USD value.
Provides on-chain DEX swap data on Ethereum for tracking whale activity, including large swaps and flow analysis.
Provides live executed whale trades from OKX as part of a multi-exchange feed, filterable by coin, source, and minimum USD value.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@CoinLobster MCP What are whales doing with BTC right now?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Ask your AI what is going on in crypto and get an answer built on what actually traded: whale trades across 18 exchanges plus Ethereum, Base and Arbitrum DEX swaps, Hyperliquid accounts named wallet by wallet, the proven-trader cohort, forced closes, funding and open interest against each coin's own history, and a signal record that shows the misses next to the hits.
Recommended: sign in. A free account (no card) gives live answers. Add this URL and your app opens a CoinLobster sign-in:
https://coinlobster.com/mcp/connectorApp | How |
Claude (web, desktop, mobile) | Settings, Customize, Connectors, Add custom connector, paste the URL. Desktop also has a one-click bundle |
ChatGPT | Settings, Security and login, turn on Developer mode. Then chatgpt.com/plugins, plus button, paste the URL |
Claude Code |
|
Cursor | One-click install, or add |
VS Code |
|
Codex |
|
Gemini CLI |
|
Gemini, Grok, Perplexity | Step by step: coinlobster.com/connect |
No account, no sign-in: use https://coinlobster.com/mcp instead. Answers are 30 minutes old.
claude mcp add --transport http coinlobster https://coinlobster.com/mcpFor clients that only speak stdio. It relays to the hosted server, including its tools, prompts, resources and instructions, so it never needs an update for new tools.
{
"mcpServers": {
"coinlobster": { "command": "npx", "args": ["-y", "coinlobster-mcp"] }
}
}A paid plan key goes in env: { "COINLOBSTER_API_KEY": "cl_your_key" }. Keys: coinlobster.com/account.
Related MCP server: x402 crypto market structure
"What's going on in crypto right now?"
"Why is BTC moving? Was it forced selling or real buying?"
"What are the proven Hyperliquid traders holding?"
"Which coins have unusual whale activity today?"
"Where did BTC liquidations actually hit in the last few hours?"
"Has this kind of whale spike on SOL led anywhere before?"
You ask about | You get |
What is happening now | The situations in play, in stages, with the evidence and the price move since each started |
One coin | Price, news, whale flow vs that coin's normal, funding and open interest vs its own recorded days, forced closes |
Whales | Executed trades (not wallet transfers), hour-by-hour flow, which coins are unusual, sector rotation |
Smart money | The proven Hyperliquid cohort: accounts screened for profit on closed trades, what they hold and just did |
Wallets | One Hyperliquid account's positions and liquidation prices, or one Ethereum/Base/Arbitrum address's swaps |
Forced closes | Where liquidations hit, long vs short, market-wide, plus DeFi lending liquidations kept separate |
Positioning | Funding across exchanges, open interest, the merged order book, options walls for BTC and ETH |
The record | What price did after each past signal, with every miss shown |
Alerts | Your AI can arm an alert that posts to your webhook (Starter and up) |
Call tools/list for the current set. Data is descriptive: what happened, never a forecast or advice.
Free | Starter $15/mo | Pro $29/mo | Alpha $99/mo | |
Coins | BTC in full, others as a headline | Every coin in full | Every tool at full depth | Pro plus the named wallets behind the cohort |
Answers | Live signed in, 30 min late without an account | Live | Live | Live |
Calls | 200 a day signed in, 100 without | Credits | Credits | Credits |
Credits a month | none needed for AI calls | 20,000 | 100,000 | 500,000 |
Alerts your AI can arm | none | 3 | 10 | 10 |
New accounts start with 7 days of Pro, no card, in your AI too. On a paid plan a call spends credits by workload from the same balance the website and REST API use: 20 for a light read, 50 for one coin or one wallet, 100 for a whole-market scan. Free calls, discovery and failed or empty answers cost nothing. Ask your AI to run my_access to see what your connection can see right now and what lifts each cap. Pricing: coinlobster.com/pricing.
This package runs on your machine and relays your AI's requests to coinlobster.com. It stores nothing locally and sends only the tool name and arguments your AI chooses, plus your API key if you set one. CoinLobster logs requests to run and meter the service and never receives your chat. Full policy, including retention and contact: coinlobster.com/privacy.
npm install
npm run test:offline # no network: error handling and what the relay forwards
npm test # plus a live call against the hosted serverAgent-readable docs: llms.txt · REST API: coinlobster.com/developers
MIT licensed. Issues and PRs welcome.
Recent crypto headlines with a pre-computed sentiment score (-100 to +100) for one coin plus the macro picture. Descriptive market data only. More depth on a developer plan: coinlobster.com/developers?utm_source=mcp&utm_medium=agent
Inputs: coin.
Recently fired signal-ledger flags with fire-time price and later price outcomes, logged live and never backfilled. Descriptive market data only. More depth on a developer plan: coinlobster.com/developers?utm_source=mcp&utm_medium=agent
Inputs: coin, type, hours, limit.
Per-venue funding rates for one pair with predicted next rate and payout time where the venue provides it. Keyless on any streamed pair. Descriptive market data only. More depth on a developer plan: coinlobster.com/developers?utm_source=mcp&utm_medium=agent
Inputs: pair.
Recent liquidation trades for a pair with the long and short breakdown. A long is force-closed by selling, so sell-side events are long liquidations. long_liquidations and short_liquidations are event COUNTS; long_usd and short_usd carry the dollar split. Descriptive market data only. More depth on a developer plan: coinlobster.com/developers?utm_source=mcp&utm_medium=agent
Inputs: pair, limit.
Projected liquidation level book for one pair (modeled from leverage assumptions - clearly labeled as a projection, not executed trades). Keyless serves the free pairs without cascade chains; an active developer plan serves any pair with the full snapshot. Descriptive market data only. More depth on a developer plan: coinlobster.com/developers?utm_source=mcp&utm_medium=agent
Inputs: pair.
Which pairs sit at a record or in their own top or bottom 5 percent for funding, open interest or liquidations, each vs that pair's own recorded history, with next-day outcome stats for past occurrences where enough events exist. Daily scan across every recorded pair. Descriptive market data only. More depth on a developer plan: coinlobster.com/developers?utm_source=mcp&utm_medium=agent
Inputs: no named parameters.
Daily history: funding rate, open interest, price and liquidation totals for one pair (archived since 2026-03-18), or daily whale buy/sell flow for one coin (since 2026-06-18). Keyless calls cover 30 days; a paid developer plan reaches the full archive. Descriptive market data only. More depth on a developer plan: coinlobster.com/developers?utm_source=mcp&utm_medium=agent
Inputs: coin, days, pair.
One-call market scan: totals (volume, OI, liquidations, mcap), 24h whale net flow, BTC risk regime (SMA20/50 + breadth), and the top rows by volume. Pass coin to get one symbol's row directly (no paging needed). Descriptive market data only. More depth on a developer plan: coinlobster.com/developers?utm_source=mcp&utm_medium=agent
Inputs: coin, limit.
Screen every recorded pair in one call: filter by funding_band / oi_band (vs each pair's OWN recorded days: record high, top 5%, top 25%, typical, bottom 25%, bottom 5%, record low), minimum whale-flow multiple vs the coin's own average, and radar-unusual. The discovery call. Descriptive market data only. More depth on a developer plan: coinlobster.com/developers?utm_source=mcp&utm_medium=agent
Inputs: limit, compact, oi_band, funding_band, +2 more.
One-call market state for a pair: last price, 24h stats, average funding rate, open interest and recent liquidation totals across 15 exchanges. Keyless calls cover the free pairs; a paid developer plan covers every streamed pair. Descriptive market data only. More depth on a developer plan: coinlobster.com/developers?utm_source=mcp&utm_medium=agent
Inputs: pair.
Fused 0-100 crowding read per pair (funding + long/short accounts + taker imbalance + OI trend) with the overexposed side. Descriptive, not a trade signal. Needs a paid developer plan. Descriptive market data only. More depth on a developer plan: coinlobster.com/developers?utm_source=mcp&utm_medium=agent
Inputs: pair.
The pre-trade context blob in one call: price, cross-venue funding with time-to-next-funding and carry arithmetic (optional position_usd), open interest, whale flow vs the coin's own baseline, and recent visible liquidations, on ANY streamed pair keyless. compact: true returns the one-line composed answer (about 30 tokens). A paid developer plan adds the percentile judgment vs the pair's own recorded days, whale USD magnitudes, full 24h stats and the crowding score. Strictly descriptive: state plus recorded history, no advice. Descriptive market data only. More depth on a developer plan: coinlobster.com/developers?utm_source=mcp&utm_medium=agent
Inputs: pair, compact, position_usd.
Per-coin whale flow vs that coin's OWN logged history: multiple of its daily average, N-day-high flags, buy share now vs 7d. The "is this unusual for THIS coin" call; coin accepts a comma-separated list for portfolio briefs (single coin returns a flat object; a list returns {coins:[...]}). Keyless returns multiples and records (USD magnitudes need an active developer plan). Descriptive market data only. More depth on a developer plan: coinlobster.com/developers?utm_source=mcp&utm_medium=agent
Inputs: coin.
Hourly buy and sell USD flow buckets for one coin, CEX and DEX split, over a rolling window. Descriptive market data only. More depth on a developer plan: coinlobster.com/developers?utm_source=mcp&utm_medium=agent
Inputs: coin (required), hours.
Smart Money Radar: which coins have unusual whale flow right now, across 1h, 4h and 24h windows. Descriptive market data only. More depth on a developer plan: coinlobster.com/developers?utm_source=mcp&utm_medium=agent
Inputs: no named parameters.
Deprecated alias for whale_trades, kept so existing clients keep working. Prefer whale_trades. Live whale trades merged across 15 CEX venues plus on-chain DEX swaps (Ethereum, Base, Arbitrum), newest first, capped at 50 rows. Keyless calls get the free shape (BTC/USD + $1M+ CEX trades live, other pairs delayed 15 min, DEX swaps $250K+); a paid developer plan lifts the shape to every pair with no delay (still 50 rows here, full depth on the REST API). Descriptive market data only. More depth on a developer plan: coinlobster.com/developers?utm_source=mcp&utm_medium=agent
Inputs: coin, limit, source, min_usd.
Live whale trades merged across 15 CEX venues plus on-chain DEX swaps (Ethereum, Base, Arbitrum), newest first, capped at 50 rows. Keyless calls get the free shape (BTC/USD + $1M+ CEX trades live, other pairs delayed 15 min, DEX swaps $250K+); a paid developer plan lifts the shape to every pair with no delay (still 50 rows here, full depth on the REST API). Descriptive market data only. More depth on a developer plan: coinlobster.com/developers?utm_source=mcp&utm_medium=agent
Inputs: coin, limit, source, min_usd.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 17 tools
Each tool targets a distinct data slice (trades, radar, flow, liquidations, funding, news, history, extremes, context, screener, overview, squeeze, zones), but whale_tape is a deprecated alias of whale_trades creating one overlap, and trade_context vs market_snapshot could confuse at the margins. Overall boundaries are clear.
Names follow a consistent noun_phrase pattern with clear domain prefixes (whale_, market_, funding_, liq_, etc.). Even the deprecated alias fits the pattern, and no camelCase or mixed verb styles appear.
17 tools is on the heavier side but justified for a broad market-data server covering trades, flow, liquidations, funding, history, news, and screening. The set remains navigable due to consistent naming, though a few tools could potentially be merged without loss.
The surface covers the core descriptive crypto data domain well: live trades, unusual flow, historical flows, funding, OI, liquidations, news, context, and screening. Minor gaps include lack of order-book depth or trade-level details beyond the top 50 rows, but nothing that would cripple typical agent workflows.
Real-time whale trades, Smart Money Radar, market snapshots, news sentiment, signal outcomes.
Crypto fundamentals, sentiment, whale tracking and influencer call accuracy for traders and agents.
Crypto derivatives data and answers for AI agents: smart money, liquidations, funding, 13 venues
Hyperliquid analytics for AI agents: whale flow, liquidations, funding, risk, signed signals.
