Blacklight MCP endpoint

Updated 2026-11-02 - read-only - public on-chain data - not financial advice

Blacklight (blacklight.observer) answers one question about Hyperliquid and Polymarket wallets: could a follower actually copy this and still net money after copy-lag, fees, de-levering and market exposure? This endpoint gives AI agents the same answers over the Model Context Protocol.

4 read-only tools · no key · no sign-up
Endpoint https://blacklight.observer/mcp · transport Streamable HTTP (JSON-RPC 2.0 over POST) · protocol 2025-06-18 · server name blacklight-signals
Read-only is the headline: the server has no write tools, never asks for keys or a wallet connection, and cannot trade or move funds. Its output is research, not advice.

The tools

toolwhat it answersarguments & example
find_copyable_tradersWhich Hyperliquid wallets could a follower actually copy and still net money? Pre-filtered by copy-lag decay, de-leverage and skill-beyond-market-exposure, ranked by Realizability Score.
technical descriptionList Hyperliquid traders that are actually copyable AND realizable for a follower, pre-gated by copy-lag decay, de-leverage, and alpha-vs-beta (NOT raw leaderboard PnL). Returns copyability tier, Realizability Score 0-100, risk grade, PnL, return, copy-lag tolerance. Use when you need vetted copy candidates, not noisy 'top trader' lists.
limit (integer), min_realizability (number)
{"limit": 10, "min_realizability": 30}
find_vaultsWhich Hyperliquid vaults look worth a deposit? Ranked on drawdown, Sharpe, operator skin-in-the-game and fees.
technical descriptionList Hyperliquid vaults ranked by allocation-worthiness (Sharpe, drawdown, operator skin-in-game, concentration, fees). Vaults are deposit products. Returns verdict, risk score, CAGR, max drawdown, TVL, APR.
limit (integer)
{"limit": 10}
find_pm_tradersWhich Polymarket wallets have a copyable kind of edge at all? Most do not; the edge-family label says why.
technical descriptionList Polymarket wallets with copyability classification (edge-family), PnL, edge-per-dollar, drawdown, category, invisible-maker volume. PM is structurally near-uncopyable; useful for edge-family research.
limit (integer)
{"limit": 10}
analyze_walletOne wallet, one honest read: copyable or not, Realizability Score, risk grade, and the binding reason.
technical descriptionLook up a specific wallet's worth-copying read (copyability / Realizability Score / risk) by address. venue 'hl' (Hyperliquid) or 'pm' (Polymarket).
address (string), venue (string)
{"address": "0x0000000000000000000000000000000000000000", "venue": "hl"}

Realizability Score (rs, 0-100) = would the returns survive a follower: a product of gates (copy-lag survival, de-levered edge, skill beyond market exposure, regime, persistence). copyability_for_us = is the edge mechanically follow-able at all. risk_grade is a separate axis. A withheld score (rs: null, "Not scored yet") means we could not measure it yet -- not that it failed.

Connect a client

Claude Code
claude mcp add --transport http blacklight https://blacklight.observer/mcp
Generic MCP client (Cursor, Windsurf, Claude Code .mcp.json, most agent frameworks)
{
  "mcpServers": {
    "blacklight": {
      "type": "http",
      "url": "https://blacklight.observer/mcp"
    }
  }
}
Claude Desktop

Settings → Connectors → Add custom connector → paste https://blacklight.observer/mcp (no OAuth; leave the client credentials empty). Clients that only speak stdio can bridge with mcp-remote:

{
  "mcpServers": {
    "blacklight": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://blacklight.observer/mcp"
      ]
    }
  }
}
Raw JSON-RPC (any language)
curl -s https://blacklight.observer/mcp -H 'Content-Type: application/json' -H 'Accept: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
curl -s https://blacklight.observer/mcp -H 'Content-Type: application/json' -H 'Accept: application/json' \
  -d '{"jsonrpc": "2.0", "id": 2, "method": "tools/call", "params": {"name": "find_copyable_traders", "arguments": {"limit": 5, "min_realizability": 30}}}'

A plain GET from a non-browser client returns a small JSON descriptor (tool names, transport, this page). Browsers get this page.

Starter prompts

Usage etiquette

FAQ

Is this financial advice?

No. The tools return research signals computed from public on-chain data: copyability, a Realizability Score and a risk grade with the reason behind each. They are not recommendations, and Blacklight has no view on what you should buy.

Can the server trade, move funds or see my keys?

No. There are no write tools. The server never asks for a wallet connection, a private key or an exchange API key; it only reads data Blacklight has already computed.

Do I need an API key?

No. The MCP endpoint is an open beta with no key. The separate REST API (/api/v1) is keyed.

How fresh is the data?

The Hyperliquid roster is re-screened nightly and the Polymarket set on its own schedule; every response carries a generated timestamp. Cache results for at least an hour -- nothing changes faster than that.

What is logged?

Each tool call appends a timestamp, the tool name and the arguments to a usage log so we can see which tools agents actually use. No IP address or client identity is stored with it.

Why is a wallet missing?

The ranked set is a screened roster, not every address. analyze_wallet returns found:false for wallets outside it; the web app at blacklight.observer can X-Ray any address on demand.

Read the humans' version

The Realizability Call is the same data written up daily: which wallets clear the bar and why most "top traders" do not. The full X-Ray of any wallet or vault is at blacklight.observer; browsable rosters at Hyperliquid traders, Hyperliquid vaults and Polymarket wallets.

Follow @Blacklightobs on X for new findings.

Blacklight is read-only wallet-copyability & realizability intelligence for Hyperliquid and Polymarket. Public data only; not affiliated with Hyperliquid, Polymarket or Anthropic; not financial advice. Past performance does not predict future results.