# Hydromancer (npm · hydromancer-mcp)

Read-only Hyperliquid data: wallets, top traders, markets, funding and liquidations.

- Trust score: 69/100 (medium)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-05

## Components

- npm · `hydromancer-mcp`: 69/100 (this document), [markdown](https://verifymcp.io/servers/joshavenue-hydromancer-mcp/hydromancer-mcp.md), [page](https://verifymcp.io/servers/joshavenue-hydromancer-mcp/hydromancer-mcp)

## Channel facts

- Registry: `npm`
- Package: `hydromancer-mcp`
- Version: `0.2.1`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-05.

- **Supply Chain Security**: 98/100
  - No malware found by supply-chain analysis.
  - No known CVEs affecting this package version or its production dependencies.
  - No install/post-install scripts declared.
  - 30 of 92 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 5 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 58/100
  - 50% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 3002 tokens (~150/item across 20 items; 19 tools + 1 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 17/100
  - Stability observed for 5 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 96/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 87% of tool parameters carry a description.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 19 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 21 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### How do I install the Hydromancer MCP server?

Hydromancer runs locally as an npm package, launched with npx -y hydromancer-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add joshavenue-hydromancer-mcp -- npx -y hydromancer-mcp
```

### Cursor

```json
{
  "mcpServers": {
    "joshavenue-hydromancer-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "hydromancer-mcp"
      ]
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "joshavenue-hydromancer-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "hydromancer-mcp"
      ]
    }
  }
}
```

### Codex

```bash
codex mcp add joshavenue-hydromancer-mcp -- npx -y hydromancer-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "joshavenue-hydromancer-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "hydromancer-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add joshavenue-hydromancer-mcp --command npx --arg -y --arg hydromancer-mcp
```

### Hermes

```yaml
mcp_servers:
  joshavenue-hydromancer-mcp:
    command: "npx"
    args: ["-y", "hydromancer-mcp"]
```

### Netclaw

```json
{
  "McpServers": {
    "joshavenue-hydromancer-mcp": {
      "Transport": "stdio",
      "Command": "npx",
      "Arguments": [
        "-y",
        "hydromancer-mcp"
      ]
    }
  }
}
```

### Vellum

```bash
assistant mcp add joshavenue-hydromancer-mcp -t stdio -c npx -a -y hydromancer-mcp
```

### Other

```json
{
  "mcpServers": {
    "joshavenue-hydromancer-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "hydromancer-mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-11-05 (score 69, +1)

No change was recorded against any check on this day. Stability & Change Management went from 13 to 17. That category is still filling its 30-day observation window: 4 days of observed history at the previous scan, 5 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-11-03 (score 68, +1)

- [functional improvement] Stability: unverified → 0.10

### 2026-11-01 (score 67, 0)

- [functional regression] Security disclosure: unverified → fail

### 2026-10-31 (score 67)

First indexed and scored.

## MCP tools (19)

### `hydromancer_wallet_overview` (~153 tokens)

Wallet overview: balance, open positions, PnL record

One-call profile of any Hyperliquid wallet: account value, every open perp position (side, size, entry, liquidation price, leverage, unrealized PnL), spot balances and its realized trading record (PnL, win rate, trade count, volume, human score). Use this first for questions like "what is this wallet holding?" or "is this trader any good?". Set includeHip3=true to include HIP-3 markets such as xyz:TSLA.

Input parameters:

- `address` (string, required): Wallet address, 0x followed by 40 hex characters.
- `includeHip3` (boolean): Also include positions on HIP-3 markets (stocks, indices, commodities). Default false.

### `hydromancer_compare_wallets` (~139 tokens)

Compare many wallets at once

Look up balance, account mode and open positions for up to 1,000 wallets (100 when includeHip3=true), sorted by balance. Handles unified-account and portfolio-margin wallets, whose money sits in spot rather than perps. Use for watchlists: "which of these wallets are whales?", "what do these 50 traders hold?".

Input parameters:

- `addresses` (array, required): Wallet addresses to look up.
- `includeHip3` (boolean): Include HIP-3 markets (limit drops to 100 wallets).
- `minBalanceUsd` (number): Only return wallets with at least this balance (see balanceNote on each wallet).

### `hydromancer_wallet_trades` (~323 tokens)

Wallet trade history (fills)

Every fill (buy/sell execution) a wallet made in a time window, newest first, with totals: volume, realized PnL, fees and a per-coin breakdown. since/until accept Relative ("30m", "6h", "24h", "7d"), a date ("2026-10-01"), a date-time ("2026-10-01T12:00:00Z"), "now", or Unix ms. Default window: last 24h. Large orders split into many fills are merged by default.

Input parameters:

- `address` (string, required): Wallet address, 0x followed by 40 hex characters.
- `coin` (string): Market name, any case: "BTC", "eth", "HYPE", "kPEPE", or a HIP-3 market such as "xyz:TSLA".
- `limit` (integer): How many rows to return (default 100, max 2000).
- `mergeSplitOrders` (boolean): Merge pieces of one order into a single fill (default true).
- `offset` (integer): Rows to skip, for paging.
- `since` (string|number): Start of window. Relative ("30m", "6h", "24h", "7d"), a date ("2026-10-01"), a date-time ("2026-10-01T12:00:00Z"), "now", or Unix ms. Default "24h".
- `until` (string|number): End of window. Default now.

### `hydromancer_wallet_closed_trades` (~242 tokens)

Wallet closed trades (open-to-close round trips)

Completed trades for a wallet: each row is a full position from open to close with entry, exit, size, gross and net PnL, fees, funding and how long it was held. Best tool for judging trading skill ("what is this wallet's win rate and best coin?"). Default window: last 30 days. since/until accept Relative ("30m", "6h", "24h", "7d"), a date ("2026-10-01"), a date-time ("2026-10-01T12:00:00Z"), "now", or Unix ms.

Input parameters:

- `address` (string, required): Wallet address, 0x followed by 40 hex characters.
- `coin` (string): Market name, any case: "BTC", "eth", "HYPE", "kPEPE", or a HIP-3 market such as "xyz:TSLA".
- `limit` (integer): How many rows to return (default 100, max 500).
- `since` (string|number): Start of window. Default "30d".
- `until` (string|number)

### `hydromancer_wallet_open_orders` (~60 tokens)

Wallet open orders (limits, stop-losses, take-profits)

All resting orders for a wallet right now, including stop-loss and take-profit triggers. Shows where a trader plans to buy, sell or exit.

Input parameters:

- `address` (string, required): Wallet address, 0x followed by 40 hex characters.

### `hydromancer_wallet_transfers` (~161 tokens)

Wallet deposits, withdrawals, transfers and liquidations

Money movements for a wallet: deposits, withdrawals, sends, spot/perp transfers, vault deposits and liquidations. Default window: last 30 days. since/until accept Relative ("30m", "6h", "24h", "7d"), a date ("2026-10-01"), a date-time ("2026-10-01T12:00:00Z"), "now", or Unix ms.

Input parameters:

- `address` (string, required): Wallet address, 0x followed by 40 hex characters.
- `limit` (integer): How many rows to return (default 100, max 2000).
- `since` (string|number): Default "30d".
- `until` (string|number)

### `hydromancer_wallet_funding` (~89 tokens)

Wallet funding payments

Funding paid or received by a wallet's open positions, hour by hour, with totals per coin. Positive = received, negative = paid. Default window: last 7 days.

Input parameters:

- `address` (string, required): Wallet address, 0x followed by 40 hex characters.
- `since` (string|number): Default "7d".
- `until` (string|number)

### `hydromancer_top_traders` (~251 tokens)

Top traders leaderboard

Rank Hyperliquid traders by realized profit, win rate or volume over 1 day to all time, with filters that remove bots and one-off wallets. Use for "who are the best traders this week?", "find consistent winners on stocks (dex xyz)" or "top traders using builder X". Pair with hydromancer_wallet_overview to see what they hold now.

Input parameters:

- `builder` (string): Only traders who have traded through this builder's app.
- `excludeBots` (boolean): Drop wallets that look automated (human score below 60). Default true.
- `limit` (integer): How many rows to return (default 25, max 1000).
- `market` (string): Only "main" (native Hyperliquid) or a HIP-3 dex such as "xyz". Omit for all.
- `minDaysActive` (integer): Minimum distinct active days (default 1).
- `minTrades` (integer): Minimum completed trades (default 5).
- `offset` (integer): Rows to skip, for paging.
- `period` (string): Time period (default "30d").
- `rankBy` (string): Ranking (default "profit").

### `hydromancer_market_snapshot` (~132 tokens)

Live price, volume and open interest for markets

Current mark/oracle/mid price, 24h volume and open interest (in coins and USD) for one or more markets. The top-markets list also shows max leverage. Leave coins empty for the top markets by 24h volume. Works for HIP-3 markets (e.g. "xyz:TSLA").

Input parameters:

- `coins` (array): Markets to show, e.g. ["BTC","ETH","xyz:TSLA"]. Omit for the busiest markets.
- `top` (integer): When coins is empty, how many top markets by 24h volume (default 15).

### `hydromancer_price_history` (~200 tokens)

Price candles (OHLCV)

Price history as candles (open, high, low, close, volume) for any market. Intervals from 1 second to 1 month. Default: 1h candles for the last 24h. since/until accept Relative ("30m", "6h", "24h", "7d"), a date ("2026-10-01"), a date-time ("2026-10-01T12:00:00Z"), "now", or Unix ms.

Input parameters:

- `coin` (string, required): Market name, any case: "BTC", "eth", "HYPE", "kPEPE", or a HIP-3 market such as "xyz:TSLA".
- `interval` (string): Candle size (default "1h"). "1s" only covers about the last 30 minutes.
- `since` (string|number): Default "24h".
- `until` (string|number)

### `hydromancer_funding_history` (~108 tokens)

Funding rate history for a market

Hourly funding rates for a market over time, with the average and annualized rate. Positive funding means longs pay shorts. Default window: last 7 days.

Input parameters:

- `coin` (string, required): Market name, any case: "BTC", "eth", "HYPE", "kPEPE", or a HIP-3 market such as "xyz:TSLA".
- `since` (string|number): Default "7d".
- `until` (string|number)

### `hydromancer_open_interest_history` (~138 tokens)

Open interest history

How open interest (total open positions) in a market changed over time, in coins and USD. Rising OI with rising price usually means new longs; falling OI means positions are closing. Default: hourly for the last 24h.

Input parameters:

- `coin` (string, required): Market name, any case: "BTC", "eth", "HYPE", "kPEPE", or a HIP-3 market such as "xyz:TSLA".
- `interval` (string): Bucket size (default "1h").
- `since` (string|number): Default "24h".
- `until` (string|number)

### `hydromancer_recent_liquidations` (~119 tokens)

Recent liquidations

Positions that were force-closed (liquidated), newest first, for one market or the whole exchange, with totals by side. "Long liquidated" means a long position was wiped out. Default window: last 24h.

Input parameters:

- `coin` (string): Market to check; omit for every market.
- `limit` (integer): How many rows to return (default 50, max 1000).
- `since` (string|number): Default "24h".
- `until` (string|number)

### `hydromancer_market_depth` (~146 tokens)

Order book depth and slippage

How much can be bought or sold near the current price. Returns USD depth on each side within 0.1% to 2% of the price for a market, plus the expected slippage for a market order of a given size over time.

Input parameters:

- `coin` (string, required): Market name, any case: "BTC", "eth", "HYPE", "kPEPE", or a HIP-3 market such as "xyz:TSLA".
- `orderSizeUsd` (number): Order size for the slippage estimate, in USD (default 100,000).
- `since` (string|number): Slippage history window. Default "24h".

### `hydromancer_list_markets` (~120 tokens)

List every market and HIP-3 exchange

Lists every tradable perp market, optionally filtered by search text or category (crypto, stocks, indices, commodities, fx), plus the HIP-3 exchanges (perp DEXs) that list stocks and other assets. Use when unsure of a market's exact name.

Input parameters:

- `category` (string)
- `limit` (integer): How many rows to return (default 100, max 2000).
- `search` (string): Text to search for, e.g. "tsla", "gold", "pepe".

### `hydromancer_builder_activity` (~176 tokens)

Builder app activity (trades routed through an app)

Fills routed through a builder (a trading app such as MetaMask, Phantom or a Telegram bot) by its builder address, with volume, builder fees earned, unique traders and top coins. Default window: last 1h (busy builders produce thousands of fills). since/until accept Relative ("30m", "6h", "24h", "7d"), a date ("2026-10-01"), a date-time ("2026-10-01T12:00:00Z"), "now", or Unix ms.

Input parameters:

- `builder` (string, required): Builder (app) address.
- `limit` (integer): How many rows to return (default 25, max 2000).
- `since` (string|number): Default "1h".
- `until` (string|number)

### `hydromancer_prediction_markets` (~119 tokens)

Prediction markets (HIP-4 outcomes)

Settled Hyperliquid prediction markets (HIP-4 outcomes) with their result and trading stats, searchable by text, underlying asset or category.

Input parameters:

- `category` (string): Category, e.g. "sports", "politics".
- `limit` (integer): How many rows to return (default 20, max 100).
- `search` (string): Free text, e.g. "election", "BTC above".
- `underlying` (string): Underlying asset, e.g. "HYPE", "BTC".

### `hydromancer_my_usage` (~61 tokens)

My Hydromancer API usage

Your own Hydromancer API usage by day and request type: requests, failures, speed and billable tokens. Use to check how much of your plan you are using.

Input parameters:

- `days` (integer): Days to look back (default 7).

### `hydromancer_raw_request` (~143 tokens)

Advanced: any Hydromancer API request

Send any Hydromancer /info request directly, for endpoints the other tools do not cover (e.g. vaultSummaries, historicalOrders, spotMeta, outcomeMeta, delegations, perpDexStatus). Pass the request body as JSON including "type". Full list: https://docs.hydromancer.xyz/llms.txt . Read-only: this server never places orders.

Input parameters:

- `body` (object, required): Request body, e.g. {"type":"vaultSummaries"} or {"type":"historicalOrders","user":"0x..."}.
- `limit` (integer): How many rows to return (default 200, max 5000).

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/joshavenue-hydromancer-mcp/hydromancer-mcp#diagnostics

## Score history

- 2026-11-05: 69
- 2026-11-04: 68
- 2026-11-03: 68
- 2026-11-02: 67
- 2026-11-01: 67
- 2026-10-31: 67

## Common questions

### What is the Hydromancer MCP server?

Hydromancer is an MCP server listed in the public MCP registry as io.github.joshavenue/hydromancer-mcp. Read-only Hyperliquid data: wallets, top traders, markets, funding and liquidations. This page covers its npm package (hydromancer-mcp).

### Is the Hydromancer MCP server safe to use?

Hydromancer scores 69 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 5 November 2026. It declares no install or post-install scripts. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the Hydromancer MCP server expose?

Hydromancer exposes 19 tools: hydromancer_wallet_overview, hydromancer_compare_wallets, hydromancer_wallet_trades, hydromancer_wallet_closed_trades, hydromancer_wallet_open_orders, and 14 more. Their descriptions and schemas cost roughly 2,880 tokens of context every time the server is loaded.

### Is the Hydromancer MCP server still maintained?

Hydromancer is still listed as active in the MCP registry. We last reached this channel on 5 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What licence is the Hydromancer MCP server under?

Hydromancer declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

## Links

- npm package: https://www.npmjs.com/package/hydromancer-mcp
- Socket report: https://socket.dev/npm/package/hydromancer-mcp
- Repository: https://github.com/joshavenue/Hydromancer-MCP
- Website: https://hydromancer.xyz/
- Changelog RSS feed: https://verifymcp.io/servers/joshavenue-hydromancer-mcp/hydromancer-mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/joshavenue-hydromancer-mcp/hydromancer-mcp.json
- HTML version of this page: https://verifymcp.io/servers/joshavenue-hydromancer-mcp/hydromancer-mcp