Skip to content
MCP server

Hydromancer

Read-only Hyperliquid wallet, trader, market, funding and liquidation data

Runs locallyStatus and history
Install
Pricing
Paid
Platforms
CLI, API
Runs
Locally
Version
0.2.1
Listing updated
3 days ago

About Hydromancer

Hydromancer is a paid MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • HYDROMANCER_API_KEYYour Hydromancer API key: https://docs.hydromancer.xyz/readme/get-api-keysRequired

Tools this server provides (5)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Paid

Requires a Hydromancer API key; usage-based plans, early-stage teams may qualify for free access

Prices change. Check hydromancer.xyz before you buy.

Hydromancer 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 to Hydromancer

  1. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  2. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  3. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  4. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  5. World Monitor

    MCP server

    Live geopolitical intelligence dashboard with an API and MCP server for agents

    • Remote
    • Freemium
    • Analytics and data
  6. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments