hydromancer-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| HYDROMANCER_API_KEY | Yes | Your Hydromancer API key. Sent only in the Authorization header to api.hydromancer.xyz (or the testnet host). | |
| HYDROMANCER_BASE_URL | No | Set to https://api-testnet.hydromancer.xyz/info for testnet; any other host is refused at startup. | https://api.hydromancer.xyz/info |
| HYDROMANCER_TIMEOUT_MS | No | Request timeout in milliseconds. | 30000 |
| HYDROMANCER_MAX_RESULT_CHARS | No | Cap on one tool result (minimum 1000), so the AI is not flooded. | 40000 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| hydromancer_wallet_overviewA | 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. |
| hydromancer_wallet_tradesA | 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. |
| hydromancer_wallet_closed_tradesA | 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. The summary covers all trades returned for the window (up to 500); rows are newest first. 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. |
| hydromancer_top_tradersA | 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. |
| hydromancer_market_snapshotA | Current mark/oracle/mid price, 24h volume and open interest (in coins and USD) for one or more markets. Leave coins empty for the top native markets by 24h volume, which also shows max leverage. Works for HIP-3 markets (e.g. "xyz:TSLA"). |
| hydromancer_price_historyA | 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. |
| hydromancer_funding_historyA | 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. |
| hydromancer_recent_liquidationsA | 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. |
| hydromancer_market_depthA | 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. |
| hydromancer_list_marketsA | 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. |
| hydromancer_my_usageA | Your own Hydromancer API usage by day and request type: requests, failures, response times and tokens consumed. |
| hydromancer_raw_requestA | Send any Hydromancer /info request directly, for endpoints the other tools do not cover (e.g. vaultSummaries, historicalOrders, spotMeta, outcomeMeta, delegations, perpDexStatus, userFunding, openInterestHistory). Pass the request body as JSON including "type". Full list: https://docs.hydromancer.xyz/llms.txt. Read-only: /info cannot place orders. Binary snapshot endpoints are not supported. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| hydromancer_guide | Which Hydromancer tool answers which question, plus recipes. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| hydromancer_guide | Hydromancer tool guide |
TDQS
Scored across 12 tools
Most tools map cleanly to one resource+action (wallet overview, fills, closed positions, snapshot, candles, funding, liquidations, depth, market list). The one soft overlap is between wallet_overview and wallet_closed_trades, both pitched as ways to judge trading skill/win rate, but the descriptions explicitly steer usage ("Use this first", "Best tool for judging trading skill").
Every tool uses the same hydromancer_ prefix plus snake_case noun/verb structure (wallet_overview, market_snapshot, price_history, recent_liquidations). No camelCase or verb-style mixing anywhere in the set.
Twelve tools is well within a comfortable range for a data/analytics server. Each tool covers a distinct slice of the Hyperliquid surface (wallets, traders, markets, funding, liquidations, depth, usage) with no filler entries.
Wallet analytics, market data, leaderboards and usage are covered end-to-end for a read-only analytics domain. A few gaps exist (vault summaries, spot metadata, historical open interest), but hydromancer_raw_request acts as an explicit escape hatch so agents aren't blocked.