# Hydromancer MCP server

> Allows an AI client to query Hyperliquid market data, wallet balances, top traders, and liquidations using plain English.

- Repository: https://github.com/joshavenue/hydromancer-mcp-python
- Page: https://hostedmcp.org/servers/joshavenue/hydromancer-mcp-python
- Transport: —
- Stars: 0
- License: MIT

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `HYDROMANCER_API_KEY` | no | no |  |
| `HYDROMANCER_LIVE` | no | no |  |

## Tools (12)

- `hydromancer_wallet_overview`
- `hydromancer_wallet_trades`
- `hydromancer_wallet_closed_trades`
- `hydromancer_top_traders`
- `hydromancer_market_snapshot`
- `hydromancer_price_history`
- `hydromancer_funding_history`
- `hydromancer_recent_liquidations`
- `hydromancer_market_depth`
- `hydromancer_list_markets`
- `hydromancer_my_usage`
- `hydromancer_raw_request`

## FAQ

### What information can I get about a specific wallet?

You can retrieve balance information, open positions, entry prices, liquidation prices, leverage, PnL, spot balances, and trading records.

### How do I use the testnet instead of the mainnet?

You can use the testnet by setting the HYDROMANCER_BASE_URL environment variable to the testnet URL.

### Does the server require an API key?

Yes, you need a Hydromancer API key to use the server.
