{"server":{"name":"dev.tesseralytics/hyperliquid-data","title":"Hyperliquid Market Data — OHLCV, Funding Rates & Positioning (Tessera)","$schema":"https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json","remotes":[{"url":"https://tesseralytics.dev/mcp","type":"streamable-http","headers":[{"name":"Authorization","isSecret":true,"isRequired":true,"description":"Tessera API key as a Bearer token: `Bearer <your-api-key>`. Get a free key at https://tesseralytics.dev."}]}],"version":"0.1.0","description":"Hyperliquid perp market data for LLMs: OHLCV, funding, open interest, positioning & forecasts."},"_meta":{"io.modelcontextprotocol.registry/official":{"status":"active","isLatest":true,"updatedAt":"2026-07-06T12:31:25.424983Z","publishedAt":"2026-07-06T12:31:25.424983Z","statusChangedAt":"2026-07-06T12:31:25.424983Z"},"dev.protogrid/connectability":{"class":"R1","autonomous":true,"human_steps":[],"preferred":{"kind":"remote","idx":0},"remotes":[{"idx":0,"url":"https://tesseralytics.dev/mcp","transport":"streamable-http","templated":false,"headers":[{"name":"Authorization","required":true,"secret":true,"value":null,"secret_names":["HYPERLIQUID_DATA_TOKEN"]}],"auth":{"type":"api_key","location":null,"secret_name":"HYPERLIQUID_DATA_TOKEN","oauth":null},"protocol":{"supported_versions":["2025-03-26"],"stateless":true},"health":{"reachable":true,"uptime_30d":1,"latency_ms_p50":1572,"consecutive_failures":0,"last_probe_at":"2026-10-20T02:16:01.918Z","last_ok_at":"2026-10-20T02:16:01.918Z"}}],"packages":[]},"dev.protogrid/tools":[{"name":"describe_dataset","title":null,"description":"The full dictionary for ONE downloadable dataset: description plus every column's type, nullability and plain-English meaning. Pass a name from list_datasets. Open — no key needed. For the fields the query tools accept, use list_fields.","annotations":null,"source":"probe","observed_at":"2026-10-20T02:16:01.918Z"},{"name":"funding_divergence","title":null,"description":"Rank markets by how far their funding has diverged from a benchmark (default ETH) over a trailing window. Pick bar (1d, the default, or 1h on a Pro key) to read completed days or completed hours. metric=rate compares mean funding over the window; metric=cum_funding_spread compares how far a market's cumulative funding level travelled inside the window (its high minus its low, so never negative) — that is not the funding the window accumulated, which is funding_paid_7d (or funding_rate_7d_avg times the window's completed-interval count). Returns the most diverged in each direction. Markets with no funding reading are excluded from both lists. Descriptive only.","annotations":null,"source":"probe","observed_at":"2026-10-20T02:16:01.918Z"},{"name":"get_universe","title":null,"description":"The coverage picture: the last complete interval, how many markets are in the universe for a scope, how much history sits behind them, and how densely it is populated. Pick bar (1d, the default, or 1h on a Pro key) to describe completed days or completed hours. The range counts cover the last 7 days at bar: 1h (pass days, 1..30, to widen them) and the whole published range at bar: 1d. A compact SUMMARY by default — pass top_n (1..50) only if you need the per-market counts.","annotations":null,"source":"probe","observed_at":"2026-10-20T02:16:01.918Z"},{"name":"list_datasets","title":null,"description":"List the downloadable datasets: one-line summary, the plan required, and the month range available. Open — no key needed. Then use describe_dataset for one dataset's columns, or list_fields for the fields the query tools accept.","annotations":null,"source":"probe","observed_at":"2026-10-20T02:16:01.918Z"},{"name":"list_fields","title":null,"description":"Every field the query tools accept, each with its meaning, unit, whether it can be missing, and which bars (1d, 1h) it exists on. Open — no key needed. Call this before query_cross_section, screen_universe or query_series. Percentile, z-score and the top_pct/bottom_pct conditions rank within the markets your plan can see, so they need a wide slice.","annotations":null,"source":"probe","observed_at":"2026-10-20T02:16:01.918Z"},{"name":"live_market","title":null,"description":"What is happening right now: mark price, current hourly funding, open interest (one-sided — counted once per contract, half of the both-sides figure Hyperliquid's own UI shows, so it is directly comparable with the oi_usd column the bar tools return), 24-hour traded notional and premium for up to 25 markets, taken straight from the venue's public API and stamped with the moment it was read. Use this for 'now' questions; the bar=1d and bar=1h tools answer completed intervals only.","annotations":null,"source":"probe","observed_at":"2026-10-20T02:16:01.918Z"},{"name":"query_cross_section","title":null,"description":"Rank the whole market on ONE completed interval: pick bar (1d, the default, or 1h on a Pro key), columns, an order_by field and top_n. Answers 'top markets by funding / open interest / returns on the latest day or hour' and 'what percentile is BTC on open interest'. day defaults to the last complete interval; scope defaults to crypto (HIP-3 markets track an underlying that closes, so their flow is not comparable); stat=percentile|zscore ranks within your eligible markets; window_days recomputes the trailing-window fields; min_usd_volume_7d_avg keeps dust out of the ranking and the ranking is computed after it. Field names come from list_fields — never guess them, they are snake_case compound names and each one lists the bars it exists on; for a cut ('top decile by X') use screen_universe.","annotations":null,"source":"probe","observed_at":"2026-10-20T02:16:01.918Z"},{"name":"query_series","title":null,"description":"The series for one market or a few (max 10): one row per market per interval over a trailing window, oldest first. Pick bar (1d, the default, for one row per day, or 1h on a Pro key for one row per completed hour). Answers 'is this move backed by real flow' and 'how has positioning built up'. ending_day defaults to the last complete interval. The whole answer is capped, so markets times window_days (times 24 at bar 1h) must stay inside the row cap; the response states the window it used.","annotations":null,"source":"probe","observed_at":"2026-10-20T02:16:01.918Z"},{"name":"screen_universe","title":null,"description":"Screen the whole market on ONE completed interval with several conditions ANDed together. Pick bar (1d, the default, or 1h on a Pro key; a free key is screened at 1d). Conditions use op >, <, >=, <=, between, top_pct or bottom_pct; top_pct/bottom_pct are deciles of your eligible markets, and the liquidity floor is applied before the deciles so they are measured over the population you are choosing from. Answers 'top-decile funding with bottom-decile open-interest change' and 'open interest rising faster than volume'. A market that does not report a field never satisfies a condition on it.","annotations":null,"source":"probe","observed_at":"2026-10-20T02:16:01.918Z"}],"dev.protogrid/trust":{"score":73,"components":{"hygiene":80,"liveness":100,"freshness":65,"provenance":45},"drivers":["+dns-namespace","+reachable","+uptime-100%","~updated-106d-ago","-no-repository"],"flags":["no-repository"],"blocked":false,"computed_at":"2026-10-20T07:15:33.232Z","disclaimer":"Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed."},"dev.protogrid/quality":{"score":73,"label":"needs work","components":{"auth":null,"hygiene":71,"protocol":75,"stability":75,"dependencies":null},"checks":[{"id":"protocol.modern","detail":"newest supported version is 2025-03-26; 2026-07-28 not supported, older versions are deprecated until 2027-07-28","status":"warn","category":"protocol"},{"id":"protocol.stateless","detail":"only applies to 2026-07-28 servers","status":"na","category":"protocol"},{"id":"protocol.transport","detail":"streamable HTTP","status":"pass","category":"protocol"},{"id":"protocol.list_ttl","detail":"only applies to 2026-07-28 servers","status":"na","category":"protocol"},{"id":"auth.prm","detail":"no remote uses OAuth","status":"na","category":"auth"},{"id":"auth.as_metadata","detail":"no remote uses OAuth","status":"na","category":"auth"},{"id":"auth.cimd","detail":"no remote uses OAuth","status":"na","category":"auth"},{"id":"auth.secret_in_url","detail":"no templated URL","status":"na","category":"auth"},{"id":"tools.descriptions","detail":"every tool has a description","status":"pass","category":"hygiene"},{"id":"tools.description_length","detail":"descriptions are concise","status":"pass","category":"hygiene"},{"id":"tools.schemas","detail":"every tool has an object input schema","status":"pass","category":"hygiene"},{"id":"tools.annotations","detail":"no tool declares readOnlyHint or destructiveHint, so clients cannot tell safe calls from risky ones","status":"fail","category":"hygiene"},{"id":"tools.directory_hints","detail":"no tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: query_series (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); query_cross_section (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); describe_dataset (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); …","status":"fail","category":"hygiene"},{"id":"tools.token_cost","detail":"about 3,849 tokens to load every tool","status":"pass","category":"hygiene"},{"id":"tools.api_dump","detail":"tools are not a one-to-one API dump","status":"pass","category":"hygiene"},{"id":"stability.changes","detail":"16 tool changes in 30 days","status":"warn","category":"stability"},{"id":"stability.rug_pull","detail":"no tool changed its meaning under the same name","status":"pass","category":"stability"},{"id":"deps.known_vulns","detail":"no npm or PyPI package","status":"na","category":"dependencies"},{"id":"deps.mcp_sdk_version","detail":"no npm or PyPI package","status":"na","category":"dependencies"},{"id":"deps.resolvable","detail":"no npm or PyPI package","status":"na","category":"dependencies"}],"drivers":["-tools.annotations","-tools.directory_hints","~protocol.modern","~stability.changes"],"flags":[],"tool_count":9,"token_estimate":3849,"tools_hash":"9b480ff2702ec4aa29313c8eea353e05","tools_changed_at":"2026-10-15T21:01:04.037Z","computed_at":"2026-10-20T07:21:44.986Z","disclaimer":"Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed."},"dev.protogrid/identity":{"canonical_id":"dev.tesseralytics/hyperliquid-data","aliases":[],"alias_count":0,"repository_key":null,"owner":{"verified":false,"method":null,"since":null}}},"next_actions":[{"action":"list_tools","description":"Every current tool with input schemas","href":"/v1/servers/dev.tesseralytics%2Fhyperliquid-data/tools","arguments":{"name":"dev.tesseralytics/hyperliquid-data"}},{"action":"get_connection","description":"Minimal connection block for the preferred remote or package","href":"/v1/servers/dev.tesseralytics%2Fhyperliquid-data/connection?target=mcpServers","arguments":{"name":"dev.tesseralytics/hyperliquid-data","target":"mcpServers"}},{"action":"search","description":"Find other servers by intent","href":"/v1/search?q={query}","arguments":{"q":"{query}"}}]}