HyperSignal MCP
概览
作者提供的说明(英文原文)
Hyperliquid analytics for AI agents: whale flow, liquidations, funding, risk, signed signals.
PopNx MCP 的三大支柱
这三项永远不会合并成一个分数:意见、测量和人气是不同的东西。
- 用户评价i暂无评价评价功能将在后续阶段与账户功能一起开放
- 我们的基础检查i3 项中通过 3 项依据公开信息检查;尚未扫描代码
- 使用情况i非常新↓ 104/周 · ★ –
它能帮你做什么
我们还没有为它写通俗的介绍。下面是我们从注册中心读取到的事实。
- 连接方式: 电脑或云端
- 传输方式: stdio, Streamable HTTP
- 分类: 营销与社交媒体
- 你需要填写:HL_AGENT_PRIVATE_KEY, X-API-Key
安装
选择你使用的 AI 应用,然后复制设置。
安装之前
- 基础检查:3 项中通过 3 项
- 在作者的服务器上运行:你向它提出的内容会经过他们的服务器。
- 可以做 30 件事(工具) hl_request_free_key, hl_buy_pro, hl_get_markets, hl_get_orderbook …
- 需要你自己填写:
HL_NETWORK,HL_ENABLE_TRADING,HL_AGENT_PRIVATE_KEY,X-API-Key
标为机密的值是你账户的钥匙。千万不要分享给别人,也不要粘贴到聊天里。
你需要
你用的是哪个应用?
在上方选择你的应用。我们会记住它,下次按钮会显示“安装到 …”。
这个地址需要在请求的 header 中放入密钥,而添加连接器的菜单无法设置。请改用 Claude Code、Cursor 或 VS Code。
或者在你的电脑上运行
打开 Claude Desktop → Settings → Developer → Edit Config,把下面的内容粘贴到 claude_desktop_config.json
{
"mcpServers": {
"hypersignal": {
"command": "npx",
"args": [
"-y",
"hypersignal-mcp"
],
"env": {
"HL_NETWORK": "your-value",
"HL_ENABLE_TRADING": "your-value",
"HL_AGENT_PRIVATE_KEY": "your-value"
}
}
}
}在终端中运行这条命令
claude mcp add --transport http hypersignal https://hypersmash.fly.dev/mcp --header 'X-API-Key: your-value'或者在你的电脑上运行
claude mcp add hypersignal --env HL_NETWORK=your-value --env HL_ENABLE_TRADING=your-value --env HL_AGENT_PRIVATE_KEY=your-value -- npx -y hypersignal-mcp运行前请先填写空着的值。
或者自己复制设置
粘贴到项目中的 .cursor/mcp.json,或 ~/.cursor/mcp.json
{
"mcpServers": {
"hypersignal": {
"url": "https://hypersmash.fly.dev/mcp",
"headers": {
"X-API-Key": "your-value"
}
}
}
}或者在你的电脑上运行
或者自己复制设置
粘贴到项目中的 .cursor/mcp.json,或 ~/.cursor/mcp.json
{
"mcpServers": {
"hypersignal": {
"command": "npx",
"args": [
"-y",
"hypersignal-mcp"
],
"env": {
"HL_NETWORK": "your-value",
"HL_ENABLE_TRADING": "your-value",
"HL_AGENT_PRIVATE_KEY": "your-value"
}
}
}
}浏览器会先询问是否打开应用,然后应用会显示设置并请你确认。密钥的值会留空,由你自己填写。
或者自己复制设置
粘贴到项目中的 .vscode/mcp.json
{
"servers": {
"hypersignal": {
"type": "http",
"url": "https://hypersmash.fly.dev/mcp",
"headers": {
"X-API-Key": "your-value"
}
}
}
}或者在你的电脑上运行
或者自己复制设置
粘贴到项目中的 .vscode/mcp.json
{
"servers": {
"hypersignal": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"hypersignal-mcp"
],
"env": {
"HL_NETWORK": "your-value",
"HL_ENABLE_TRADING": "your-value",
"HL_AGENT_PRIVATE_KEY": "your-value"
}
}
}
}浏览器会先询问是否打开应用,然后应用会显示设置并请你确认。密钥的值会留空,由你自己填写。
这个地址需要在请求的 header 中放入密钥,而添加连接器的菜单无法设置。请改用 Claude Code、Cursor 或 VS Code。
你的选择通过 Cookie 保存在这台设备上,无需账户。
需要你填写的值
HL_NETWORKenvmainnet or testnetHL_ENABLE_TRADINGenvtrue to allow the local trading tools to submit orders (dry-run otherwise)- Agent (API) wallet key for trading; only read locally
X-API-Key机密 HTTP headerKey for premium tools; free tools work without it (get one with hl_request_free_key)
这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同,请以 README 为准。
它能做什么
工具名称和描述与服务器在 2026年11月7日 报告的完全一致。这些内容由作者撰写,不是我们写的;我们以纯文本形式显示。
hl_request_free_keyIssue 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_proBuy 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 requiremen
hl_get_marketsList 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_orderbookLevel-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_candlesOHLCV 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_historyHistorical 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_accountPerp 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_ordersOpen 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_pubkeyReturns 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_telegramGet 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_telegramStop pushing this key's alerts to Telegram (they remain available via hl_poll_alerts).
hl_set_webhookPOST 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_webhookStop POSTing this key's alerts to its webhook (they remain available via hl_poll_alerts).
hl_score_calibrationOut-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 1h
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 l
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 nea
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 available
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 `spo
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 mir
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), pri
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/med
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 behavi
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 coo
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-m
基础检查i
我们检查的是任何人都能看到的信息;我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月8日
- ✓ 通过
作者与仓库一致
注册名称已通过 GitHub 账户 johnsmithxy1mmm-sys 验证,该账户拥有此仓库
- … 尚未检查
仍在维护
我们还没有从 GitHub 读取这个仓库
- … 尚未检查
有许可证
我们还没有从 GitHub 读取这个仓库
- ✓ 通过
端点有响应
在 575 毫秒内响应(HTTP 200)
- – 不适用
使用 OAuth 登录
无需登录
- ✓ 通过
工具描述中没有隐藏指令
已读取 30 个工具描述,未发现针对 AI 的隐藏指令
与“营销与社交媒体”中的其他服务器比较i
- 星标数多于此分类中其他 3609 个服务器的 0%
- 发布到注册中心的时间比此分类中其他 3609 个服务器的 76% 更新
- 基础检查结果等于或优于此分类中其他 3609 个服务器的 100%
与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时,星标数才计入。
常见问题
HyperSignal MCP 安全吗?
它在 3 项适用的基础检查中通过了 3 项。我们没有阅读代码。在添加密钥或令牌之前,请先看看这个服务器要求哪些权限,并使用只具备所需权限的密钥。
它需要哪些密钥或代码?
你需要填写:HL_AGENT_PRIVATE_KEY, X-API-Key
它在我的电脑上运行还是在云端?
两种方式都可以:安装在你的电脑上,或者连接云端版本。
它还在维护吗?
GitHub 仓库最后更新于–,最新版本(1.14.0)于10天前进入注册中心。
哪些应用可以使用它?
支持 MCP 的应用,例如 Claude Desktop、Claude Code、Cursor 和 VS Code。它通过 URL 连接,所以接受远程 MCP 服务器的应用也可以使用,例如开启开发者模式的 ChatGPT。
有什么可以替代它?
同一分类中有:MCP YouTube Transcript, Google Analytics MCP, BibiGPT YouTube Video Summarizer
替代选择
同一分类中其他作者的服务器,按星标数排序。
如何看卡片:↓ 每周下载量i★ GitHub 星标i三大支柱:评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i
Google Analytics MCP
GA4 MCP server for AI agents: schema discovery, server-side aggregation, analysis-ready defaults.
BibiGPT YouTube Video Summarizer
AI video summarizer: summarize and transcribe YouTube, Bilibili, TikTok and podcast videos.
作者的 README
打开 README
按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。
HyperSignal MCP
Monetized [MCP](https://modelcontextprotocol.io) server for Hyperliquid analytics & signals. Gives AI agents (Claude, Cursor, ChatGPT, autonomous trading agents) the Hyperliquid analytics that free open-source MCP servers don't have — whale-cohort signals, liquidation maps, funding screeners, HIP-3 analytics, and ready-made risk reports — plus an optional local trading tier that attaches a builder code to orders.
⚠️ Analytics, not investment advice. Trading tools place real orders and are irreversible.
Tiers & tools
Free (open-source parity — the hook)
| Tool | What it returns |
|---|---|
hl_get_markets | Perp markets: mark/oracle price, hourly + annualized funding, OI, 24h volume; filter/sort |
hl_get_orderbook | L2 book (top-N levels), spread, mid |
hl_get_candles | OHLCV candles by interval/range or lookback |
hl_get_funding_history | Funding history + avg/cumulative |
hl_get_account | Positions, equity, margin, liquidation prices for any address |
hl_get_open_orders | Open resting orders for any address |
Premium (the differentiator — metered)
| Tool | What it returns |
|---|---|
hl_whale_positions | Aggregated cohort positioning by coin: net long/short, wavg entry, 1h/24h change |
hl_whale_flow_alerts | Recent large cohort position shifts above a USD threshold |
hl_liquidation_map | Liquidation clusters (notional-at-risk by distance from mark), nearest cascades |
hl_funding_screener | Every perp screened by annualized funding + cross-venue spreads |
hl_hip3_analytics | HIP-3 (builder-deployed / RWA / equity) perp metrics + external basis |
hl_portfolio_risk | Liquidation distance, effective leverage, concentration, stress scenarios, PnL Sharpe |
hl_vault_screener | Vaults by APR, max drawdown, Sharpe/Sortino, age, TVL, leader share |
hl_trader_report | Wallet breakdown: winrate, avg R, PnL curve, scalp/swing style, top coins |
Agent-native (v0.3) — the differentiators
| Tool | Tier | What it does |
|---|---|---|
hl_create_alert / hl_list_alerts / hl_delete_alert | premium | Register/manage standing alerts (funding threshold, price move, whale net-flip). The server evaluates them on a schedule — it watches the market for your agent. |
hl_poll_alerts | premium | Retrieve fired alert events since your last poll (at-least-once), each with a signed signal payload. |
hl_signal_track_record | premium | Transparent, verifiable performance of emitted signals: hit-rate and avg/median direction-adjusted forward return per signal type. |
hl_request_free_key | free | Self-serve API key — one call, no signup, grants 100 premium calls/month. Send it as X-API-Key. This is the intended first call for any new agent: premium tools point at it by name when they need a key. |
hl_buy_pro | paid ($29, x402) | Buy 30 days of Pro over x402 (USDC on Base): a new key, or the key in X-API-Key renewed (a free key is upgraded in place). Remote server only. |
hl_signal_pubkey | free | Ed25519 public key to independently verify any signal's authenticity + timestamp. |
hl_admin_stats | free (own gate) | Operator only — requires adminSecret matching HYPERSIGNAL_ADMIN_SECRET. Per-key usage this billing period, top tools, active alerts, signal track record, x402 payment counts. |
hl_smart_money_score | premium | Rank a cohort by a smart-money screening score (risk-adjusted perf + winrate + reward/risk + size + activity) with behavioral labels (whale, sharp, scalper, market_maker_like, high_conviction, …). A descriptive screener over past results — see hl_score_calibration before treating it as a forecast. |
hl_score_calibration | free | Out-of-sample evidence for the smart-money score: Spearman rank correlation between score and the realized forward return each wallet went on to earn (forward PnL over account value when sampled), p-value, and mean forward return per score quartile. Free on purpose — a claim about predictive power should be checkable before you pay for it. The server scores its own cohort daily, so this fills in whether or not anyone is calling the paid tool. |
hl_coordination_scan | premium | Find wallets holding near-identical exposure (cosine similarity) — likely the same entity / copy-bot / coordinated group; returns clusters + strongest pairs. |
hl_polymarket_divergence | premium | Compare Polymarket price-threshold odds against the probability implied by Hyperliquid price + realized vol — a cross-market mispricing edge no other MCP offers. Also audits the market's own price ladder for logically impossible orderings (a further threshold priced above a nearer one), collapses duplicate contract listings, reports each estimate's volatility-sensitivity range, and flags extreme tails where a diffusion model is blind to jump risk. |
Every emitted signal is cryptographically signed and scored against forward price — a track record that can't be cherry-picked. Persistence (alerts, positioning snapshots, signals) is SQLite-backed and survives restarts.
Public proof, no key needed: the hosted server runs its own standing alerts (funding extremes on the top 10 perps by open interest, whale-cohort flips on BTC/ETH) and publishes their track record together with the score calibration and the signing key at /track-record (JSON). The same data is available to MCP clients as resources (hypersignal://about, ://track-record, ://calibration, ://signal-pubkey), plus three prompts: whale_briefing, wallet_risk_check, funding_carry_scan.
Trading (optional, local stdio only, builder code, maximum warnings)
| Tool | What it does |
|---|---|
hl_place_order | Limit/market order via your agent wallet, builder code attached |
hl_cancel_order | Cancel by coin + order id |
hl_close_position | Reduce-only market close |
hl_approve_builder_fee_guide | Read-only — generates the approveBuilderFee payload/instructions for your main wallet |
hl_twap_order | Slice a position into evenly-spaced child orders (TWAP) to minimize impact, builder code on each child |
hl_copy_wallet | Mirror a target wallet's positioning scaled to your equity (copy-trading), builder code attached |
hl_execution_status | Progress of running TWAP/execution plans |
hl_cancel_execution | Stop a running plan; slices not yet fired are dropped. A plan also stops by itself after 3 failed slices in a row |
Trading defaults to dry-run (previews the exact signed action without sending). Submitting requires HL_ENABLE_TRADING=true + HL_AGENT_PRIVATE_KEY (env only) + confirm=true + dryRun=false. Every non-reduce-only order (including each TWAP slice and copy-trade leg) is capped at HL_MAX_ORDER_NOTIONAL_USD (default $10,000), which only the operator can raise. HIP-3 coins (xyz:XYZ100) trade on their builder dex, which keeps its own collateral (enable the unified account or transfer collateral to it) and may charge higher fees. Live HIP-3 orders also need HL_ENABLE_HIP3_TRADING=true: turn it on after a testnet run. Copy-trading mirrors main-dex positions only. Trading tools are never exposed on the remote HTTP server.
Try it on the hosted server
Nothing to install. Free tools work without a key. For the premium tools, call hl_request_free_key once: it returns a key with 100 premium calls a month, no signup.
Claude Code:
claude mcp add --transport http hypersignal https://hypersmash.fly.dev/mcp --header "X-API-Key: <your key>"
Cursor (.cursor/mcp.json):
{ "mcpServers": { "hypersignal": { "url": "https://hypersmash.fly.dev/mcp", "headers": { "X-API-Key": "<your key>" } } } }
Without a key the free tools still work; add the key after hl_request_free_key has issued one.
Install
Requirements
Node 20 or 22 LTS (Node 24 has no prebuilt better-sqlite3 binaries and requires a C++ toolchain — use LTS). npm install && npm run build.
Local (stdio) — free + trading, for Claude Desktop / Claude Code / Cursor
Claude Desktop (claude_desktop_config.json), from npm:
{
"mcpServers": { "hypersignal": { "command": "npx", "args": ["-y", "hypersignal-mcp"], "env": { "HL_NETWORK": "mainnet", "HL_BUILDER_ADDRESS": "0xYourBuilderAddress", "HL_ENABLE_TRADING": "false" } } } }
From a clone instead: "command": "node", "args": ["/absolute/path/to/HyperliquidMCP/dist/server-stdio.js"]. Cursor (.cursor/mcp.json) uses the same command/args/env shape.
Inspect locally:
npm run build && npm run inspect # @modelcontextprotocol/inspector
Remote (Streamable HTTP) — free + premium, monetized
cp .env.example .env # fill in keys / builder / x402
docker compose up -d # serves POST /mcp on :8080, GET /healthz
Point an MCP HTTP client at `https://your-host/mcp` and send `X-API-Key: <key>` (or `Authorization: Bearer <key>`).
Node's built-in
fetchonly honorsHTTPS_PROXYwhenNODE_USE_ENV_PROXY=1(Node ≥ 22.21).
Behind an egress proxy, set that env var.
Pricing
| Tier | Limit | Price |
|---|---|---|
| anonymous (no key) | free tools only | — |
| free key | 100 premium calls/month | $0 |
| pro key | unlimited premium calls | $29 per 30 days |
| x402 pay-per-call | per premium call | $0.01 USDC on Base |
How to get each
- Free key: call
hl_request_free_key. Instant, no signup. - x402 pay-per-call: on the hosted server a premium call without a key answers with x402 payment requirements (0.01 USDC on Base, exact scheme); an x402-capable client signs the payment, retries with the
X-PAYMENTheader, and the call runs. The payment is settled only after the tool has delivered, so a failed call costs nothing. - Pro: call
hl_buy_pro. It answers with x402 payment requirements ($29 in USDC on Base); an x402-capable client pays and retries with theX-PAYMENTheader, and the answer carries your Pro key, valid for 30 days (shown once: keep it). Call it again with your key inX-API-Keyto add 30 days to its end; a free key is upgraded in place and keeps its alerts. The key is activated before the payment is settled and a renewal only after, so a payment that fails costs nothing. Payments are final, there are no automatic refunds: if something went wrong, open an issue with the time of the payment. Without an x402 client, open an issue titled "Pro key request" instead and say how to reach you; never post a key in an issue. When a Pro key runs out it works like no key (free tools, x402 per call) and the error says how to renew; its alerts keep running for now.
For operators
- API keys: provision via
HYPERSIGNAL_PRO_KEYS/HYPERSIGNAL_FREE_KEYS(comma-separated raw keys, hashed before storage in SQLite; they never expire). Bought keys live in the same table with an end date, and every purchase is recorded inpro_purchases. Usage counters are per key, per month. A key removed from these lists is revoked on the next start, as long as at least one key stays listed: two empty lists read as a lost secret and revoke nothing.
只显示了开头部分;其余内容请在仓库中阅读