# Hydromancer

> Hydromancer is a paid MCP server for finance and payments. Read-only Hyperliquid wallet, trader, market, funding and liquidation data. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** CLI, API
- **Website:** https://hydromancer.xyz
- **Repository:** https://github.com/joshavenue/hydromancer-mcp
- **MCP Registry name:** io.github.joshavenue/hydromancer-mcp
- **Categories:** finance and payments, analytics and data
- **Listing updated:** 2026-11-14

## About

Hydromancer MCP is maintained by the Hydromancer team and wraps its Hyperliquid data API in 19 read-only tools. It cannot place, cancel or sign orders and never touches keys or funds. You supply a Hydromancer API key, which is read from the app's settings and sent only to api.hydromancer.xyz, or the testnet host if configured.

Inputs are forgiving: coin names in any case, including btc, $ETH, ETH-PERP and HIP-3 symbols like xyz:tsla, and times such as 24h, 7d or a date. Questions it targets include a wallet's holdings and trading record, top traders without bots, recent liquidations, open interest and funding rates, order book depth for slippage estimates, and builder fees.

The wider Hydromancer service sells REST and WebSocket access with usage-based token plans. Early-stage teams may qualify for free access.

## Features

- **Wallet overview:** Balances, positions, spot holdings, trading record and bot score.
- **Wallet comparison:** Up to 1,000 wallets sorted by balance.
- **Trade history:** Fills and round-trip trades with PnL, fees and win rate.
- **Forgiving inputs:** Flexible coin names and relative times.
- **Read-only safety:** No order placement, signing or fund access.
- **Market and liquidation data:** Funding, open interest and recent liquidations.

## Good for

- Check whether a wallet trades well
- Rank last week's top traders excluding bots
- See who got liquidated in the last hours
- Estimate how much BTC can be sold before price moves 0.5%
- Track builder fee earnings

## Install

### Claude Code (Terminal)

```sh
claude mcp add hydromancer-mcp --env HYDROMANCER_API_KEY='<HYDROMANCER_API_KEY>' -- npx -y hydromancer-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "hydromancer-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "hydromancer-mcp"
      ],
      "env": {
        "HYDROMANCER_API_KEY": "<HYDROMANCER_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "hydromancer-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "hydromancer-mcp"
      ],
      "env": {
        "HYDROMANCER_API_KEY": "<HYDROMANCER_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "hydromancer-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "hydromancer-mcp"
      ],
      "env": {
        "HYDROMANCER_API_KEY": "<HYDROMANCER_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "hydromancer-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "hydromancer-mcp"
      ],
      "env": {
        "HYDROMANCER_API_KEY": "<HYDROMANCER_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "hydromancer-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "hydromancer-mcp"
      ],
      "env": {
        "HYDROMANCER_API_KEY": "<HYDROMANCER_API_KEY>"
      }
    }
  }
}
```

## Tools

- `hydromancer_wallet_overview`: Balance, account mode, open positions, spot balances, trading record and bot score for a wallet.
- `hydromancer_compare_wallets`: Compare up to 1,000 wallets by balance and account mode.
- `hydromancer_wallet_trades`: Fills in a time window with volume, PnL, fees and per-coin totals.
- `hydromancer_wallet_closed_trades`: Round-trip trades with win rate, net PnL, hold time and best coin.
- `hydromancer_wallet_open_orders`: Resting limits, stop-losses and take-profits for a wallet.

## FAQ

### Do I need an API key?

Yes. A Hydromancer API key is required.

### Can it trade for me?

No. It is read-only.

### Which clients work?

Claude Desktop, Claude Code, Cursor, Codex, VS Code, Gemini CLI, Windsurf, Cline and others.

### Does it support testnet?

Yes, if configured, it uses api-testnet.hydromancer.xyz.

### Is Hydromancer free?

No. Hydromancer is a paid product.

### How do I add Hydromancer to Claude Code?

Run this command in your terminal: claude mcp add hydromancer-mcp --env HYDROMANCER_API_KEY='<HYDROMANCER_API_KEY>' -- npx -y hydromancer-mcp

### What are the best alternatives to Hydromancer?

The closest alternatives to Hydromancer are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP and World Monitor.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/hydromancer
