Hunter Killer MCP

Describe a protected Cascade Feed v2 SSE connection and recorded-event replay. wall_touched, wall_broken, cascade_live and oi_shock; source timestamps and opaque cursors. API key required, with its existing live or delayed entitlement. Returns connection_required, not an open socket; send the key in a header, never a URL. Descriptive, not a forecast.

{
  "type": "object",
  "required": [
    "symbol"
  ],
  "properties": {
    "after": {
      "type": "string",
      "description": "Optional opaque, exclusive event cursor for this symbol and tier."
    },
    "symbol": {
      "type": "string",
      "description": "Perpetual pair such as BTCUSDT."
    }
  },
  "additionalProperties": false
}

API KEY REQUIRED. Hyperliquid exact liquidation census for one symbol. Aggregate price bands with forced long and short notional, stated coverage of venue open interest, snapshot identity and data age. A free API key receives a stored delayed snapshot. Pro keys and prepaid credits receive the current snapshot. No account rows. Separate from estimated liquidation walls. Descriptive census, not a forecast.

{
  "type": "object",
  "required": [
    "symbol"
  ],
  "properties": {
    "symbol": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

FREE delayed keyless, live with paid access. Descriptive liquidation walls, cascade path, crowd and position distance, plus lines[] and text. GET /api/desk_read/symbols lists coverage. Unknown symbols return unknown_symbol and invalid numbers return invalid_number, with isError:true; live-only symbols on the free tier return symbol_requires_live_access with the free set in did_you_mean. The deprecated compatibility field verdict is wall_in_band, no_wall_in_band or thin_data, never null; proceed, reduce and skip are no longer emitted (contract change, SDK 0.4.1 docs). wall_in_band means the nearest wall on either side is under 1 percent from price, the same distance as flags.liq_distance_pct and the same test as flags.wall_within_1pct; thin_data means no price or no wall data. verdict_long and verdict_short apply that test to the losing-side wall (below for a long, above for a short) at the current price and assumed_leverage, or for your position. confidence is null with confidence_basis unscored until the public ledger scores verdicts. Compatibility metadata includes verdict_side, verdict_long, verdict_short, verdict_other, bias and confidence. The verdict, stop and target fields are deprecated compatibility fields, never advice. verdict is descriptive (wall_in_band, no_wall_in_band or thin_data) and reads the same wall set as the descriptive flags liq_distance_pct, wall_within_1pct and crowd_aligned, which replace it. stop_suggestion and target_suggestion mirror the deprecated plan and render on no customer surface.

{
  "type": "object",
  "required": [
    "symbol"
  ],
  "properties": {
    "ref": {
      "type": "string",
      "description": "Optional. Attribution tag."
    },
    "lang": {
      "enum": [
        "en",
        "zh",
        "ja",
        "ko",
        "es",
        "pt"
      ],
      "type": "string",
      "description": "Optional. Language of lines, text and act_label. Default en."
    },
    "side": {
      "enum": [
        "long",
        "short"
      ],
      "type": "string",
      "description": "Optional. Your position side."
    },
    "entry": {
      "type": "number",
      "description": "Optional. Your entry price."
    },
    "symbol": {
      "type": "string",
      "description": "e.g. BTCUSDT"
    },
    "leverage": {
      "type": "number",
      "description": "Optional. Your leverage."
    }
  }
}

API KEY REQUIRED (a free key works). Liquidation levels for one coin: the same hk.levels.v1 payload as REST GET /api/v1/levels/{symbol} — the nearest wall above and below the mark, every wall with price, side, usd, signed distance_pct, first_seen_ts, age_hours and an evidence label (validated, measured or unmeasured), the snapshot as_of and age_sec, and the public record link. A free key reads the 2 hour delayed snapshot on the free coins (one prepaid credit buys a live coin); a paid key reads the current snapshot. Descriptive, not a forecast.

{
  "type": "object",
  "required": [
    "symbol"
  ],
  "properties": {
    "symbol": {
      "type": "string",
      "description": "Perp symbol, e.g. BTCUSDT."
    }
  },
  "additionalProperties": false
}

FREE (keyless). The public proof summary: headline walk-forward precision with sample n + confidence lower bound, venues measured, per-venue feed-trust verdicts, and evidence pointers — the same aggregate hunterkiller.io/proof serves. Nothing per-level. Descriptive, not a forecast.

{
  "type": "object",
  "properties": {}
}

FREE (keyless). BTC/ETH liquidation-cluster teaser: the top-3 strongest clusters per side (short-liq fuel above price, long-liq below) — the same published teaser data the anonymous free map and the public /learn pages serve, with the free-tier delay/scrub applied by construction. Descriptive positioning context, not a forecast. The full graded ladder (every level with reach-rate + n + CI, real-time, full symbol universe) requires an API key.

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "description": "Optional: BTCUSDT or ETHUSDT (the free-teaser majors). Omit for both."
    }
  }
}

FREE (keyless). Summary of the public feed-trust reconciliation audit: per-venue verdicts on OUR OWN liquidation feed with match rate, coverage and assessable-run n — the same fields hunterkiller.io/proof/feed_trust publishes. A descriptive audit of data quality, not a trading signal.

{
  "type": "object",
  "properties": {}
}

API KEY REQUIRED. Calibrated liquidation magnets for one symbol: per-horizon walk-forward empirical reach-rate (reach probability with sample n + Wilson lower bound) plus the magnet density histogram. Measured out-of-sample; descriptive, not a forecast. Unvalidated horizons are withheld, never served as numbers.

{
  "type": "object",
  "required": [
    "symbol"
  ],
  "properties": {
    "frame": {
      "type": "string",
      "description": "Optional horizon filter: 15m | 1h | 4h | 1D. Omit for all horizons."
    },
    "symbol": {
      "type": "string",
      "description": "Perp symbol, e.g. BTCUSDT."
    }
  }
}

API KEY REQUIRED. Walk-forward horizon reach probabilities for one symbol (out-of-sample backtest record): per-horizon up/down band reach with n + 95% CI. Descriptive history, not a forecast.

{
  "type": "object",
  "required": [
    "symbol"
  ],
  "properties": {
    "symbol": {
      "type": "string",
      "description": "Perp symbol, e.g. ETHUSDT."
    }
  }
}

API KEY REQUIRED. Per-venue reconciliation verdicts for OUR OWN liquidation feed (rolling 7d): each venue's ingested events verified against an independent check, with assessable-run n shown. A descriptive audit of data quality, not a trading signal.

{
  "type": "object",
  "properties": {
    "venue": {
      "type": "string",
      "description": "Optional venue filter (e.g. binance, bybit, okx, deribit). Omit for all."
    }
  }
}

API KEY REQUIRED. The published accuracy-proof aggregate (the same payload as the public /proof/stats): walk-forward precision with n, baselines, and window. Descriptive track record, not a forecast.

{
  "type": "object",
  "properties": {}
}

API KEY REQUIRED. The full /engine_read payload for a symbol+horizon as served to non-owner customers: the descriptive engine read plus horizons_meta with the per-horizon lane label (empirical = a walk-forward-validated measured cell is serving; modeled = the honest-null legacy lane) and the strict per-horizon gate_validated flag. The layer recipe is scrubbed by the standard non-owner egress. A descriptive structure read, not a forecast.

{
  "type": "object",
  "required": [
    "symbol"
  ],
  "properties": {
    "symbol": {
      "type": "string",
      "description": "Perp symbol, e.g. BTCUSDT."
    },
    "horizon": {
      "type": "string",
      "description": "Optional: 1h | 4h | 24h | 168h | 720h (default 1h)."
    }
  }
}

API KEY REQUIRED. The public projection of the daily proof-anchor chain: each anchor day's date + content digest + chain hash (the append-only tamper-evidence ledger for the accuracy track record), with the keyless chain-integrity verification recipe. HMAC signatures and the attestation key are NOT included. Verification metadata — descriptive, not a forecast.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "description": "Optional: how many of the most recent daily anchors to return (default 30, max 200)."
    }
  }
}

API KEY REQUIRED. One composite evidence packet for a symbol: validated liquidation magnets, historical reach, contagion, derived venue structure and feed trust. Components fail independently and report honest unavailable states. Descriptive evidence, not a forecast. No order is placed.

{
  "type": "object",
  "required": [
    "symbol"
  ],
  "properties": {
    "symbol": {
      "type": "string",
      "description": "Perp symbol, e.g. BTCUSDT."
    }
  }
}

API KEY REQUIRED. Calculate position quantity, notional and optional gross reward-to-risk from user-supplied levels, with a supporting decision packet. Fees, funding and slippage are explicitly excluded. Descriptive preparation, not a forecast. Never signs or executes.

{
  "type": "object",
  "required": [
    "symbol",
    "direction",
    "entry",
    "invalidation",
    "risk_usd"
  ],
  "properties": {
    "entry": {
      "type": "number",
      "exclusiveMinimum": 0
    },
    "symbol": {
      "type": "string"
    },
    "target": {
      "type": "number",
      "exclusiveMinimum": 0
    },
    "risk_usd": {
      "type": "number",
      "exclusiveMinimum": 0
    },
    "direction": {
      "enum": [
        "long",
        "short"
      ],
      "type": "string"
    },
    "invalidation": {
      "type": "number",
      "exclusiveMinimum": 0
    }
  }
}

API KEY REQUIRED. The serveable perp symbol universe (the positive allowlist) — the same list as keyed REST GET /api/v1/symbols. Coverage metadata — descriptive, not a forecast.

{
  "type": "object",
  "properties": {}
}

API KEY REQUIRED (a free key works). Buy prepaid live Desk Read calls with a card: returns a Stripe Checkout URL to hand to your human. Packs: p10 ($10, 600 calls), p50 ($50, 3500), p200 ($200, 16000). With credits a free key gets live Desk Read, one credit per call. Balance: GET /api/agents/credits. This is a purchase action, not a trading signal.

{
  "type": "object",
  "required": [
    "pack_id"
  ],
  "properties": {
    "pack_id": {
      "enum": [
        "p10",
        "p50",
        "p200"
      ],
      "type": "string"
    },
    "return_url": {
      "type": "string",
      "description": "Optional hunterkiller.io URL to return to."
    }
  }
}

FREE, no key needed. Tell us what you needed and did not get; a human and our agents read every item. Missing field, wrong shape, unclear verdict, symbol we lack, latency, price: say it plainly. Max 2 KB, 5 items per hour per address. Never include keys or secrets; items that look like secrets are refused. Service feedback, not a trading signal.

{
  "type": "object",
  "required": [
    "need"
  ],
  "properties": {
    "need": {
      "type": "string",
      "description": "What you needed and did not get (required)."
    },
    "tool": {
      "type": "string",
      "description": "Optional. The tool or endpoint this is about."
    },
    "symbol": {
      "type": "string",
      "description": "Optional. Perp pair this is about."
    },
    "contact": {
      "type": "string",
      "description": "Optional. Where a human can reply."
    },
    "context": {
      "type": "string",
      "description": "Optional. What you were trying to do."
    }
  }
}

Advertised by the server during the last successful anonymous check.

The machine-readable endpoint catalog (the same document /api/v1/catalog serves).

hk://catalog

MIME type: application/json

Advertised by the server during the last successful anonymous check.

The published track-record aggregate (the same payload as public /proof/stats).

hk://proof

MIME type: application/json

Advertised by the server during the last successful anonymous check.

Per-venue reconciliation audit of our own liquidation feed (public /proof/feed_trust).

hk://feed-trust

MIME type: application/json