About Neleus MCP
Neleus MCP is an MCP server published by auralshin in the Blockchain category: enables interaction with Hyperliquid markets for technical analysis, order book data retrieval, and cryptocurrency trading. Supports read-only market access without credentials and authenticated trading operations via private key configuration.
Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.
Install
git clone https://github.com/auralshin/neleus-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (4)
neleus_analyze_marketTA analysis — RSI, trend, Bollinger bands, support/resistance
Parameters not published.
neleus_get_order_bookL2 order book snapshot with spread and imbalance
Parameters not published.
neleus_list_marketsList markets by scope: perps, all-perps, hip3, spot, hip4
Parameters not published.
neleus_scan_marketsRank markets by composite TA score
Parameters not published.
Ask AI
Ask AI about Neleus MCP
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
README
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)
| 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
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
| 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
PermissionErrorifHYPERLIQUID_SIGNER_PRIVATE_KEYis not set. - Docs are fetched from the live Neleus docs site and cached for 1 hour.
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.