neleus-mcp

MCP server exposing Neleus Hyperliquid tools to Claude and Codex

Run market analysis, inspect order books, search docs, and place trades from Claude, Codex, or any stdio-compatible MCP client with Neleus-backed MCP tools.

Mock Questions

• What’s the current RSI and trend for SOL?
• Analyze ETH on the 1h timeframe.
• Show support and resistance for BTC.
• Scan perps for the strongest bullish setups.
• Which markets have rising momentum right now?
• What does the order book look like for HYPE?
• Show bid/ask imbalance for SOL.
• List the Neleus docs pages.
• Search the docs for limit orders.
• Read the docs page for market orders.
• Place a limit buy for ETH at 3200.
• Show my open orders.
• Cancel my latest order.
• Show my recent fills.

Preview

Market (no credentials)

Docs (no credentials)

Trading (requires HYPERLIQUID_SIGNER_PRIVATE_KEY)

Installation

1. Install uv (once)

uvx is required to run MCP servers without managing Python environments manually.

# macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# or via Homebrew
brew install uv

2. Add to Claude Code

claude mcp add neleus -- uvx neleus-mcp

With trading credentials:

claude mcp add neleus \
  -e HYPERLIQUID_SIGNER_PRIVATE_KEY=0x... \
  -e HYPERLIQUID_TESTNET=false \
  -- uvx neleus-mcp

3. Add to Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "neleus": {
      "command": "uvx",
      "args": ["neleus-mcp"]
    }
  }
}

With trading credentials:

{
  "mcpServers": {
    "neleus": {
      "command": "uvx",
      "args": ["neleus-mcp"],
      "env": {
        "HYPERLIQUID_SIGNER_PRIVATE_KEY": "0x...",
        "HYPERLIQUID_TESTNET": "false"
      }
    }
  }
}

4. Add to Codex CLI

codex mcp add neleus -- uvx neleus-mcp

With trading credentials:

codex mcp add neleus \
  --env HYPERLIQUID_SIGNER_PRIVATE_KEY=0x... \
  --env HYPERLIQUID_TESTNET=false \
  -- uvx neleus-mcp

Environment variables

Notes

• HIP-4 outcome markets require testnet=true.
• Trading tools raise PermissionError if HYPERLIQUID_SIGNER_PRIVATE_KEY is not set.
• Docs are fetched from the live Neleus docs site and cached for 1 hour.