HyperSignal MCP

io.github.johnsmithxy1mmm-sys/hypersignal-mcp · v1.14.0

Hyperliquid analytics for AI agents: whale flow, liquidations, funding, risk, signed signals.

Source code Set it up

Connect Remote server

Terminal

claude mcp add --transport http hypersignal-mcp https://hypersmash.fly.dev/mcp --header "X-API-Key: <X_API_KEY>"

~/.cursor/mcp.json

{
  "mcpServers": {
    "hypersignal-mcp": {
      "url": "https://hypersmash.fly.dev/mcp",
      "headers": {
        "X-API-Key": "<X_API_KEY>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "hypersignal-mcp": {
      "type": "http",
      "url": "https://hypersmash.fly.dev/mcp",
      "headers": {
        "X-API-Key": "<X_API_KEY>"
      }
    }
  }
}

Claude Desktop

Settings > Connectors > Add custom connector
URL: https://hypersmash.fly.dev/mcp

Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.

Tools 30 found in our last check

hl_request_free_key
Issue yourself a free API key, instantly and with no signup. The key grants 100 premium calls per month — enough to evaluate every premium tool. Send it as the X-API-Key header on later requests. Call this first if a premium tool says it needs a key. One active key per requester…
hl_buy_pro
Buy 30 days of Pro (unlimited premium calls) for $29 in USDC, paid over x402 on Base. Without an X-API-Key it issues a new Pro key; with one it renews that key (a free key is upgraded in place), adding 30 days to its current end. The first call answers with the payment requireme…
hl_get_markets
List Hyperliquid perpetual markets with mark/oracle price, hourly + annualized funding, open interest, and 24h volume. Use to discover valid coin symbols and scan the board. Supports name filter, sorting, and pagination.
hl_get_orderbook
Level-2 order book for a coin: top-N bid/ask levels with price, size, and order count, plus spread and mid. Use for microstructure, spread, and near-touch liquidity. If the coin is unknown, call hl_get_markets first.
hl_get_candles
OHLCV candlestick history for a coin at a given interval. Provide either an explicit [startTime,endTime] (ms epoch) or a `lookback` count of the most recent candles. Returns most-recent-last, paginated.
hl_get_funding_history
Historical hourly funding rates for a coin over a time window, with cumulative and average annualized funding. Use for carry analysis and funding trend. Defaults to the last 7 days if no window is given.
hl_get_account
Perp account snapshot for any address: equity, margin usage, withdrawable, and open positions (size, entry, uPnL, leverage, liquidation price). Read-only; works for any public 0x address.
hl_get_open_orders
Open resting orders for an address: coin, side, price, size, order id, type, and trigger info. Read-only; paginated. Use to inspect any wallet's live order book footprint.
hl_signal_pubkey
Returns the server's Ed25519 public key (SPKI DER, base64) used to sign emitted signals, so anyone can independently verify a signal's authenticity and timestamp. Canonicalization: JSON with recursively sorted keys over {payload, ts}; signature is base64 Ed25519.
hl_link_telegram
Get a one-time Telegram link (valid 15 minutes). Open it and press Start: this key's standing alerts are then also pushed to that chat (up to 30 messages an hour; everything stays available via hl_poll_alerts).
hl_unlink_telegram
Stop pushing this key's alerts to Telegram (they remain available via hl_poll_alerts).
hl_set_webhook
POST this key's fired alerts to an https URL (public addresses only), up to 30 an hour. Each body is signed: header x-hypersignal-signature = sha256=HMAC-SHA256(secret, body). The secret is returned only once.
hl_delete_webhook
Stop POSTing this key's alerts to its webhook (they remain available via hl_poll_alerts).
hl_score_calibration
Out-of-sample evidence for whether the hl_smart_money_score actually predicts anything: Spearman rank correlation between each wallet's score and the realized return it went on to earn over the forward window (PnL over account value), plus mean forward return per score quartile.…
hl_whale_positions
[PREMIUM — needs an API key: call hl_request_free_key first for a free key, or pay per call via x402] Aggregated positioning of a whale cohort for a coin (or all coins): total long/short size & notional, long/short wallet counts, weighted-average entry, net bias, and change vs 1…
hl_whale_flow_alerts
[PREMIUM — needs an API key: call hl_request_free_key first for a free key, or pay per call via x402] Recent large changes in whale cohort positioning: which coins saw net long/short notional shift beyond a USD threshold within a lookback window — 'who opened/closed what in the…
hl_liquidation_map
[PREMIUM — needs an API key: call hl_request_free_key first for a free key, or pay per call via x402] Estimated liquidation clusters for a coin from a whale cohort's open positions: distribution of liquidation prices and notional-at-risk bucketed by % distance from mark, plus ne…
hl_funding_screener
[PREMIUM — needs an API key: call hl_request_free_key first for a free key, or pay per call via x402] Screen every Hyperliquid perp by annualized funding: top markets by absolute funding (carry candidates), sign (longs-pay vs shorts-pay), and — when predictedFundings is availabl…
hl_hip3_analytics
[PREMIUM — needs an API key: call hl_request_free_key first for a free key, or pay per call via x402] Analytics for HIP-3 (builder-deployed) perp markets such as RWA/equity perps: volume, open interest, funding, and 24h change, enumerated across builder dexs. Optionally pass `sp…
hl_portfolio_risk
[PREMIUM — needs an API key: call hl_request_free_key first for a free key, or pay per call via x402] Risk report for a perp address: liquidation distance per position, effective leverage, concentration (HHI + largest position share), uniform stress scenarios (-5/-10/-20% and mi…
hl_vault_screener
[PREMIUM — needs an API key: call hl_request_free_key first for a free key, or pay per call via x402] Screen Hyperliquid user vaults by APR, max drawdown, Sharpe/Sortino, age, TVL, and leader capital share. Provide `vaults` (list of vault 0x addresses) or set HL_VAULT_ADDRESSES.…
hl_trader_report
[PREMIUM — needs an API key: call hl_request_free_key first for a free key, or pay per call via x402] Behavioral report for any wallet from its fills: winrate, average R (avg win / avg loss), total realized PnL, PnL curve, holding-time style (scalp vs swing), fees paid, and most…
hl_create_alert
[PREMIUM — needs an API key: call hl_request_free_key first for a free key, or pay per call via x402] Register a persistent alert the server evaluates on a schedule; fired events are retrieved with hl_poll_alerts. Types: funding_apr (|annualized funding| crosses a threshold), pr…
hl_list_alerts
[PREMIUM — needs an API key: call hl_request_free_key first for a free key, or pay per call via x402] List the standing alerts registered under your API key, with their type, params, and last-fired time.
hl_delete_alert
[PREMIUM — needs an API key: call hl_request_free_key first for a free key, or pay per call via x402] Delete one of your standing alerts by id.
hl_poll_alerts
[PREMIUM — needs an API key: call hl_request_free_key first for a free key, or pay per call via x402] Retrieve alert events that fired since your last poll. Default is simple at-most-once delivery (events are marked delivered as soon as they are read — a lost response loses them…
hl_signal_track_record
[PREMIUM — needs an API key: call hl_request_free_key first for a free key, or pay per call via x402] Transparent, verifiable performance of the signals this server has emitted: per signal type, the count, how many have been scored against forward price, hit-rate, and average/me…
hl_smart_money_score
[PREMIUM — needs an API key: call hl_request_free_key first for a free key, or pay per call via x402] Rank a cohort of wallets by a composite screening score over their PAST results (risk-adjusted performance, winrate, reward/risk, capital size, activity) and tag each with behav…
hl_coordination_scan
[PREMIUM — needs an API key: call hl_request_free_key first for a free key, or pay per call via x402] Find wallets in a cohort that hold near-identical directional exposure right now (high cosine similarity of their position vectors) — likely the same entity, a copy-bot, or a co…
hl_polymarket_divergence
[PREMIUM — needs an API key: call hl_request_free_key first for a free key, or pay per call via x402] Compare Polymarket price-threshold odds for a coin (e.g. 'BTC above $100k by date') against the probability implied by Hyperliquid's price + realized volatility. Surfaces cross-…

Headers

Name	Description
`X-API-Key` Optional, secret	Key for premium tools; free tools work without it (get one with hl_request_free_key)

Details

Endpoint	`https://hypersmash.fly.dev/mcp` (Streamable HTTP)
Package	`[email protected]` (NPM, stdio)
First published	29 Oct 2026
Last updated	29 Oct 2026
Registry name	`io.github.johnsmithxy1mmm-sys/hypersignal-mcp`

More data and analytics servers See all

Live status

Live

Typical response: 492 ms
Answered: 100% of 2 checks
Last check: 13 Nov 2026

30 days agoToday

We connect daily without credentials and run initialize and tools/list.

Pair it with live search

Agents that use HyperSignal MCP often also need current facts. NestDaddy MCP gives your AI today's internet: web search, real-time breaking news and full page reading in one connector.

See NestDaddy MCP

For maintainers

[![NestDaddy MCP](https://nestdaddy.com/mcp/servers/io-github-johnsmithxy1mmm-sys-hypersignal-mcp/badge.svg)](https://nestdaddy.com/mcp/servers/io-github-johnsmithxy1mmm-sys-hypersignal-mcp)

Add the badge to your README. It turns green while your server passes our daily check. Listing details come from the official MCP registry; update them there.

Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.