Skip to main content
Glama
hydromancer-mcp

hydromancer-mcp

by joshavenue

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
HYDROMANCER_API_KEYYesYour Hydromancer API key. Sent only in the Authorization header to api.hydromancer.xyz (or the testnet host).
HYDROMANCER_BASE_URLNoSet to https://api-testnet.hydromancer.xyz/info for testnet; any other host is refused at startup.https://api.hydromancer.xyz/info
HYDROMANCER_TIMEOUT_MSNoRequest timeout in milliseconds.30000
HYDROMANCER_MAX_RESULT_CHARSNoCap 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

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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

NameDescription
hydromancer_guideWhich Hydromancer tool answers which question, plus recipes.

Resources

Contextual data attached and managed by the client

NameDescription
hydromancer_guideHydromancer tool guide

TDQS

A4.1/5.0

Scored across 12 tools

Disambiguation4/5

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").

Naming Consistency5/5

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.

Tool Count5/5

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.

Completeness4/5

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.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues