{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_k3567p8fac25","handle":"neleus-mcp","url":"https://wellknown.network/agents/neleus-mcp","links":{"self":"https://wellknown.network/agents/neleus-mcp/record.json","html":"https://wellknown.network/agents/neleus-mcp","markdown":"https://wellknown.network/agents/neleus-mcp/record.md","api":"https://wellknown.network/api/v1/agents/neleus-mcp","status":"https://wellknown.network/api/v1/agents/neleus-mcp/status","claim":"https://wellknown.network/agents/neleus-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/neleus-mcp/claim.json","badge":"https://wellknown.network/agents/neleus-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/neleus-mcp/history","tools":"https://wellknown.network/api/v1/agents/neleus-mcp/tools"},"ard":{"identifier":"urn:air::server:neleus-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"neleus-mcp","summary":"MCP server exposing Neleus Hyperliquid market tools to Claude","description":"# neleus-mcp\n\nMCP server exposing [Neleus](https://github.com/auralshin/neleus) Hyperliquid tools to Claude.\n\n## Tools\n\n### Market (no credentials)\n\n| Tool | Description |\n|---|---|\n| `neleus_list_markets` | List markets by scope: perps, all-perps, hip3, spot, hip4 |\n| `neleus_analyze_market` | TA analysis — RSI, trend, Bollinger bands, support/resistance |\n| `neleus_scan_markets` | Rank markets by composite TA score |\n| `neleus_get_order_book` | L2 order book snapshot with spread and imbalance |\n\n### Docs (no credentials)\n\n| Tool | Description |\n|---|---|\n| `neleus_list_docs` | List Neleus documentation pages |\n| `neleus_search_docs` | Search the Neleus docs |\n| `neleus_read_doc` | Read a documentation page by route |\n\n### Trading (requires `HYPERLIQUID_SIGNER_PRIVATE_KEY`)\n\n| Tool | Description |\n|---|---|\n| `neleus_place_limit_order` | Place a limit order |\n| `neleus_place_market_order` | Place a market order |\n| `neleus_cancel_order` | Cancel an open order by ID |\n| `neleus_get_open_orders` | List open orders |\n| `neleus_get_fills` | Recent fill history |\n\n## Installation\n\n### 1. Install uv (once)\n\n`uvx` is required to run MCP servers without managing Python environments manually.\n\n```bash\n# macOS / Linux\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n\n# or via Homebrew\nbrew install uv\n```\n\n### 2. Add to Claude Code\n\n```bash\nclaude mcp add neleus -- uvx neleus-mcp\n```\n\nWith trading credentials:\n\n```bash\nclaude mcp add neleus \\\n  -e HYPERLIQUID_SIGNER_PRIVATE_KEY=0x... \\\n  -e HYPERLIQUID_TESTNET=false \\\n  -- uvx neleus-mcp\n```\n\n### 2. Add to Claude Desktop\n\nEdit `~/Library/Application Support/Claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"neleus\": {\n      \"command\": \"uvx\",\n      \"args\": [\"neleus-mcp\"]\n    }\n  }\n}\n```\n\nWith trading credentials:\n\n```json\n{\n  \"mcpServers\": {\n    \"neleus\": {\n      \"command\": \"uvx\",\n      \"args\": [\"neleus-mcp\"],\n      \"env\": {\n        \"HYPERLIQUID_SIGNER_PRIVATE_KEY\": \"0x...\",\n        \"HYPERLIQUID_TESTNET\": \"f…","publisher":{"name":"Neleus Team","url":null},"homepage":"https://auralshin.github.io/neleus/","repository":"https://github.com/auralshin/neleus-mcp/issues","version":"0.1.4","license":"MIT","protocols":["mcp"],"tags":["claude","hyperliquid","mcp","neleus","trading"],"pricing":null,"endpoints":[{"url":"pypi:neleus-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"finance.markets","name":"Markets & Trading","confidence":1,"provenance":"declared"}],"categories":["finance"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"neleus-mcp","registry":"pypi","observedAt":"2026-11-03T19:31:42.488Z","publishedAt":"2026-04-05T02:11:44.369791Z","latestVersion":"0.1.4"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"neleus-mcp","url":"https://pypi.org/project/neleus-mcp/","firstSeenAt":"2026-09-10T07:21:16.329Z","fetchedAt":"2026-11-03T19:30:46.509Z","normalizedAt":"2026-11-03T19:30:46.509Z"}]},"firstSeenAt":"2026-09-10T07:21:16.329Z","updatedAt":"2026-11-03T19:31:42.488Z"}