MCP Tools
MCP tools exposed by the Hyperliquid intelligence module for agent and IDE integrations.
HLQ exposes 5 tools via the Model Context Protocol. These are designed for agent consumption — each response includes provenance metadata for traceability.
Starting the server
find_similar_traders
Search for traders matching a natural language query.
Parameters:
| Name | Type | Default | Description |
|---|---|---|---|
query | str | required | Natural language search query |
top_k | int | 50 | Maximum results |
addresses | list[str] | null | Explicit addresses (skips ANN shortlist) |
Response fields:
| Field | Description |
|---|---|
traders | List of matching trader dicts (address, metrics, scores) |
sql_used | The SQL that was executed |
intent_family | How the query was classified |
action | Which RouteAction was selected |
result_count | Number of results |
multi_coin | Whether results span multiple coins |
sort_direction | ASC or DESC |
provenance | Traceability metadata (see Provenance) |
explain_trader
Get a detailed profile and narrative for a single trader.
Parameters:
| Name | Type | Default | Description |
|---|---|---|---|
address | str | required | Trader's blockchain address |
window_days | int | 30 | Analysis window in days |
Response fields: profile, narrative, semantics, provenance
detect_copytrade
Detect copy-trading relationships between traders.
Parameters:
| Name | Type | Default | Description |
|---|---|---|---|
leader | str | null | Leader address |
follower | str | null | Follower address |
lag_days | int | 1 | Lag window for correlation |
Response fields: pairs, lag_days, result_count, addresses_provided, provenance
Key pair metrics: corr_same_day, corr_lagged, lag_lift_score, overlap_days.
screen_risk
Screen traders by risk criteria.
Parameters:
| Name | Type | Default | Description |
|---|---|---|---|
risk_type | str | "leverage" | Type: leverage, liquidation, margin |
threshold | float | 4.0 | Risk threshold value |
Response fields: traders, risk_type, threshold, result_count, provenance
bridge_status
Check bridge health and artifact inventory. No parameters.
Response fields: version, format_version, created_at, actions, ann_items, sql_templates, checksum_errors, health, narrative, issues