Read-only MCP server for the Hydromancer Hyperliquid API: wallets, top traders, markets, funding and liquidations
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"hydromancer-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# hydromancer-mcp Read-only [MCP](https://modelcontextprotocol.io) server for the [Hydromancer](https://hydromancer.xyz) Hyperliquid API, in Python. Ask your AI app about wallets, top traders, markets, funding and liquidations in plain English. > **Disclosure:** this package is maintained by the Hydromancer team. You need a Hydromancer API key to use it. ```bash uvx hydromancer-mcp ``` > - "What is this wallet holding, and is it a good trader?" > - "Who were the best traders this week, without bots?" > - "Who got liquidated in the last 6 hours?" > - "How much BTC can I sell before the price moves 0.5%?" - **12 read-only tools**: wallets, trades, top traders, markets, funding, depth, liquidations, your API usage, plus a raw request tool for other `/info` endpoints - **Friendly inputs**: coin names in any case (`btc`, `$ETH`, `ETH-PERP`, `xyz:tsla`), times like `24h`, `7d` or `2026-10-01` - **Read-only**: it cannot place, cancel or sign orders, and it never handles funds or private keys - **Few dependencies**: besides the MCP SDK it uses only `httpx` and `pydantic`; Python 3.10+ ## Hosts contacted The server makes HTTPS requests to one of these hosts: | Host | When | |---|---| | `api.hydromancer.xyz` | Every tool call (default) | | `api-testnet.hydromancer.xyz` | Instead of the above, only if you set `HYDROMANCER_BASE_URL` to the testnet URL | Any other `HYDROMANCER_BASE_URL` is refused at startup, so your key cannot be sent elsewhere. Redirects are not followed. No telemetry. (Installing with `uvx` or `pip` downloads the package from PyPI; the server itself never contacts PyPI.) ## 1. Get a Hydromancer API key See [Get API keys](https://docs.hydromancer.xyz/readme/get-api-keys). ## 2. Add it to your AI app You need [uv](https://docs.astral.sh/uv/getting-started/installation/) (for `uvx`). Replace `YOUR_KEY` with your key. ### Claude Desktop Settings → Developer → Edit Config, then add: ```json { "mcpServers": { "hydromancer": { "command":…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.