# LiqFlow

> LiqFlow is a free MCP server for finance and payments. Hyperliquid liquidation maps, whale positions and funding for AI assistants. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API, Web
- **Website:** https://liqflow.app/docs
- **Repository:** https://github.com/liqflow-llc/liqflow-mcp
- **MCP Registry name:** app.liqflow/liqflow
- **Categories:** finance and payments, analytics and data
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://liqflow.app/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "liqflow": {
      "url": "https://liqflow.app/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

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

## 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

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/liqflow
