hyperdash-info

Cursor / Agent Plugin for Hyperdash public market intel (Hyperliquid terminal).

• REST: GET https://api.hyperdash.com/health

• GraphQL: POST https://api.hyperdash.com/graphql (introspection disabled; operations reverse-mapped from the web app, so upstream schema changes can break a tool; the daily CI run catches them)

Read-only. No order / strategy / wallet mutations.

Site: https://hyperdash.com · Docs: https://docs.hyperdash.com (product docs; published OpenAPI there is currently a Mintlify placeholder)

Results

• Every result is compact JSON in content[0].text; there is no structuredContent.

• List tools take limit (default 50 unless the tool says otherwise, max 500) and offset, and return { total, returned, offset, next_offset, truncated, items, hint }. next_offset and hint appear only when more rows remain.

• Every result stays under 40,000 characters. A list that would exceed it is cut short and marked truncated; any other result over the cap returns an error asking for narrower arguments.

• Tool failures come back as isError results whose text carries the upstream reason and a hint (bad address, bad enum, timeout, schema drift). JSON-RPC errors are reserved for unknown methods and tools.

• label, displayName, twitter, group names and news text are third-party content; affected results carry a note saying so.

Related MCP server: hyperliquid-agent-gateway

Install (Cursor IDE)

Copy to ~/.cursor/plugins/local/hyperdash-info, Reload Window.

Install (Claude Code)

Clone this repo, then start Claude Code with claude --plugin-dir /path/to/hyperdash-plugin. .claude-plugin/plugin.json loads the skill and starts the MCP server with node ${CLAUDE_PLUGIN_ROOT}/server/index.mjs. The server has no dependencies, so it needs only Node on PATH and no npm install.

Environment:

MCP tools (28)

tools/list carries the full schemas. Summary:

Market

Liquidations

Deltas & orderbook

Traders

Widgets

Widget types: OI_SURGES, IMMINENT_LIQUIDATIONS, FUNDING_RATES, SMART_MONEY_FLIPS, CVD, TOP_UPNL_CHANGES, LARGEST_OPENED_TRADES, NET_TWAP_PRESSURE, ASSET_RETURNS, TOP_PERP_UNREALIZED_PNL, TOP_PERP_POSITIONS, FRESH_WALLET_POSITIONS, WHALE_DEPOSITS, TOP_TWAPS, LIQUIDATION_FEED, OPEN_INTEREST, USER_GROWTH, AF_BUYBACKS, PERP_PRICE_CHANGES, NET_POSITIONING.

Testing

npm test runs test/smoke.mjs (zero dependencies). It checks the protocol and tool metadata, bad-argument errors, paging and size caps against a local mock, the fetch timeout, and the stdin-close drain. When the API is reachable it also calls every tool and widget with test/fixtures.json and fails on any error or schema drift. Set SMOKE_OFFLINE=1 to skip the live calls. CI runs it on every push and daily.

License

MIT