<div align="center">

neleus-mcp

MCP server exposing Neleus Hyperliquid tools to Claude

Run market analysis, inspect order books, search docs, and place trades from Claude with Neleus-backed MCP tools.

</div>

<br />

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.

<br />

Preview

<p align="center"> <img src="./assets/neleus-preview.jpeg" alt=" Neleus MCP demo showing SOL market analysis in Claude" width="1000" /> </p>

Tools

Market (no credentials)

Tool	Description
neleus_list_markets	List markets by scope: perps, all-perps, hip3, spot, hip4
neleus_analyze_market	TA analysis — RSI, trend, Bollinger bands, support/resistance
neleus_scan_markets	Rank markets by composite TA score
neleus_get_order_book	L2 order book snapshot with spread and imbalance

Docs (no credentials)

Tool	Description
neleus_list_docs	List Neleus documentation pages
neleus_search_docs	Search the Neleus docs
neleus_read_doc	Read a documentation page by route

Trading (requires HYPERLIQUID_SIGNER_PRIVATE_KEY)

Tool	Description
neleus_place_limit_order	Place a limit order
neleus_place_market_order	Place a market order
neleus_cancel_order	Cancel an open order by ID
neleus_get_open_orders	List open orders
neleus_get_fills	Recent fill history

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

2. 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"
      }
    }
  }
}

Environment variables

Variable	Required	Description
HYPERLIQUID_SIGNER_PRIVATE_KEY	Trading only	Wallet private key (0x...)
HYPERLIQUID_TESTNET	No	true to use testnet for all tools
NELEUS_DOCS_URL	No	Override the docs manifest URL
NELEUS_DOCS_MANIFEST_PATH	No	Use a local manifest file (offline/dev)

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.