Skip to content
MCP server

LiqFlow

Hyperliquid liquidation maps, whale positions and funding for AI assistants

Install
Pricing
Free
Platforms
API, Web
Runs
Remotely
Version
1.1.1
Listing updated
3 days ago

About LiqFlow

LiqFlow is a free MCP server for finance and payments. It runs as a hosted remote server, so there is nothing to install locally.

The hosted server at liqflow.app/mcp reads from LiqFlow's own Hyperliquid node and answers in compact JSON, each result carrying a source link back to the page or endpoint it came from. Every one of its 15 tools is annotated read-only, so an assistant can look but not act.

Coverage runs from market-wide questions (which perps lean bullish or bearish on liquidation pressure, which markets have the most open interest) down to a single wallet's account value, PnL, positions and open orders. Trader cohorts can be sliced by account size and by profitability, and past sharp moves are paired with the liquidation exposure that sat in their path.

The underlying API says node data refreshes every five minutes and derived scores every four hours. The MCP server needs no key or sign-in, while the separate JSON API asks for a free key.

Install

Run in a terminal

claude mcp add --transport http liqflow https://liqflow.app/mcp

Add to Settings → Connectors → Add custom connector

https://liqflow.app/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "liqflow": {
      "url": "https://liqflow.app/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "liqflow": {
      "type": "http",
      "url": "https://liqflow.app/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "liqflow": {
      "serverUrl": "https://liqflow.app/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "liqflow": {
      "type": "http",
      "url": "https://liqflow.app/mcp"
    }
  }
}

Tools this server provides (15)

Read directly from the server.

market_overview
The whole market in one reading: how many perps lean bullish vs bearish on liquidation pressure, and the markets leaning hardest each way. The score compares short-liquidation exposure ABOVE price (forced buys if price rises) with long-liquidation exposure BELOW it (forced sells if it falls), weighted by distance. Negative = more fuel below, a bearish pull; positive = the reverse. Uses 2 API calls
list_markets
Market symbols LiqFlow covers, to resolve a name ("solana") to its market symbol (SOL). `scored` markets also have scores, funding, depth and volume; the rest have node data only (positions, levels, liquidations). Uses 2 API calls.
open_interest_ranking
Hyperliquid markets ranked by open interest (USD), with how many positions are open in each, from every wallet on the node.
coin_snapshot
Everything about one market right now: live price and 24h change, its liquidation-pressure score, liquidation exposure each side and how close it sits, the nearest big cluster, its rank among all markets, and what changed since the previous snapshot. Start here for any question about one coin. Uses 2 API calls.
liquidation_map
Where the forced orders sit around the current price for one market, from every wallet on the node: liquidation prices (longs below = forced sells, shorts above = forced buys), resting stop-loss / take-profit trigger orders, and order-book depth, summed into price bands either side of the mark price, plus the biggest liquidation clusters. This is the "liquidation heatmap" question: where would a m
funding
Perp funding rates. With a coin: the rate on each venue (Hyperliquid, Binance, Bybit, OKX, Bitget, Gate) normalised to 8 hours, plus the open-interest weighted aggregate. Without: the markets paying the most positive and most negative funding right now. Positive = longs pay shorts.
coin_history
A metric's history for one market (with the price where the data has it), thinned to at most 60 points.
recent_liquidations
Individual Hyperliquid liquidation fills, newest first, straight off the node: who was liquidated, on which market, how big, at what price. One liquidation can be several fills sharing an order id.
liquidation_totals
How much was liquidated. Without a coin: every market ranked by liquidated USD over the window, long vs short. With a coin: long and short liquidations per time bucket. Windows that the node missed are listed under `gaps` -- those are missing data, not quiet periods.
cascades
Past sharp moves (at least `min_move_pct` in one 4-hour step) paired with how much liquidation exposure sat in their path just before -- the evidence for whether clusters actually get run.
top_positions
The largest open positions on Hyperliquid right now, longs and shorts, read live from the node: wallet, size, notional, entry, leverage, liquidation price and how far price is from it, unrealised PnL, and the wallet's size cohort.
wallet
One Hyperliquid wallet right now, read live from the node: account value, PnL, every open position with leverage, liquidation price and how far price is from it, and its open orders (limits, stops and take-profits).
cohort_positioning
How different kinds of traders are positioned: wallets grouped by account size (Micro under $250 up to Whale over $1M) and by all-time PnL (Highly Unprofitable to Highly Profitable), with each group's long and short notional and the share that is long. "Are whales and the profitable traders on the other side of retail?" Uses 2 API calls without a coin.
cohort_top_coins
Which coins one trader cohort is most long and most short on, ranked across every market: "What are the most profitable traders most bullish and most bearish on?" Each coin has the cohort's long and short notional, net USD, share long and wallet count, plus the cohort's overall lean across all markets to compare against. Uses 2 API calls without a side.
leaderboard
Hyperliquid wallets ranked by all-time PnL or by 30-day volume.

What it does

Liquidation map
Shows liquidation prices, stop orders and book depth in price bands around the mark.
Wallet lookup
Returns one wallet's account value, PnL, positions and open orders.
Cohort positioning
Reports long and short positioning by account size and by profitability.
Funding comparison
Lists funding per venue for a market, or the most extreme rates across all.
Liquidation history
Gives recent liquidation fills and liquidated USD totals by market or time bucket.
Read-only tools
All 15 tools are annotated read-only and cite a source link.

Good for

  • Check where liquidation clusters sit before sizing a perp trade
  • Ask which wallets hold the largest open positions and at what leverage
  • Compare funding rates for one coin across venues
  • Review past cascades alongside the exposure that preceded them
  • Track what a trader cohort is most long or short on

Pricing

Free

Free; the separate JSON API uses a free key with 50,000 calls a month

Prices change. Check liqflow.app before you buy.

LiqFlow FAQ

Do I need an API key to use it?

No. The README says the hosted MCP server is free and needs no key or sign-in. The separate JSON API uses a free key with 50,000 calls a month.

Can it place trades?

No. All 15 tools are annotated read-only.

Which transport does it use?

Streamable HTTP at https://liqflow.app/mcp.

Where does the data come from?

From LiqFlow's own Hyperliquid node, with each result linking to its source.

Is LiqFlow free?

Yes. LiqFlow is free to use.

How do I add LiqFlow to Claude Code?

Run this command in your terminal: claude mcp add --transport http liqflow https://liqflow.app/mcp

What are the best alternatives to LiqFlow?

The closest alternatives to LiqFlow are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP and World Monitor.

Alternatives to LiqFlow

  1. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  2. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  3. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  4. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  5. World Monitor

    MCP server

    Live geopolitical intelligence dashboard with an API and MCP server for agents

    • Remote
    • Freemium
    • Analytics and data
  6. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments