# mcp-server

MCP server for Hyperliquid analytics: trader data, cohorts, indexed trade history with PnL attribution, order book depth, and live market data.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 10 repo stars
- Author: Coinversaa
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Coinversaa/mcp-server
- Updated: 2026-09-24
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/coinversaa-mcp-server

## What it does

Connects an agent to indexed Hyperliquid trade history — all wallets, PnL attribution, behavioral cohorts, live market feeds. 107 tools: entity profiles (multiple wallets under one owner), builder leaderboards (who earns from order routing), L4 order book analytics (depth, whale positions, clustered stops), HIP-4 outcome contracts (prediction markets, commodities, equities, perps across 8 dexes and 369+ markets).

Requires a Coinversaa API key passed via `COINVERSAA_API_KEY` environment variable. Some tools work on the free Starter tier, others require Pro. The server returns rate limits and an upgrade link when a request exceeds the plan. One tool (`builder_heatmap`) is hidden by default due to upstream timeouts — expose it by setting `COINVERSAA_HIDDEN_TOOLS=` to an empty string.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `COINVERSAA_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add mcp-server -e COINVERSAA_API_KEY=<COINVERSAA_API_KEY> -- npx -y @coinversaa/mcp-server
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add coinversaa-mcp-server --env COINVERSAA_API_KEY=<COINVERSAA_API_KEY> -- npx -y @coinversaa/mcp-server
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "coinversaa-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@coinversaa/mcp-server"
            ],
            "env": {
                "COINVERSAA_API_KEY": "<COINVERSAA_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "coinversaa-mcp-server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@coinversaa/mcp-server"
            ],
            "env": {
                "COINVERSAA_API_KEY": "<COINVERSAA_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e COINVERSAA_API_KEY=<COINVERSAA_API_KEY> coinversaa-mcp-server npx -y @coinversaa/mcp-server
```
Replace <…> with your own values

## When to use it
- identify who owns a wallet and what their real combined book is across all sub-accounts
- rank builders by on-chain ledger revenue and see which other builders share their users
- check where whales hold resting size and where stop orders cluster that a price move would sweep
- pull indexed fill-level detail with PnL attribution
- track 24h volume and open interest per dex with long/short breakdown

## Example prompts
- Show me the entity leaderboard for the last 24 hours, deduplicated by owner rather than wallet
- Which wallets are holding the largest resting orders for `ETH`, and on which side
- How many traders used the MetaMask builder last week, and what other builders do they trade through

## Similar
- [market-microstructure-traditional](https://affpapa.org/en/nevibecode/skills/market-microstructure-traditional.md) — skill · 543 installs
- [Hyperliquid Market Data — Orderbooks, Prices, OHLCV](https://affpapa.org/en/nevibecode/mcp/hyperliquid-market-data-orderbooks-prices-ohlcv.md) — MCP server · 6097 installs
- [hyperliquid](https://affpapa.org/en/nevibecode/skills/hyperliquid.md) — skill · 8700 installs
- [OpenFinance — Easy Trading: Crypto, Stocks, Perps & Prediction Markets](https://affpapa.org/en/nevibecode/mcp/openfinance-easy-trading-crypto-stocks-perps-prediction-markets.md) — MCP server
- [blackforge](https://affpapa.org/en/nevibecode/skills/blackforge.md) — skill · 11500 installs
- [MarketTrace Crypto MCP](https://affpapa.org/en/nevibecode/mcp/markettrace-crypto-mcp.md) — MCP server

## Other versions with the same name
- [mcp-server · heyputer](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — ★ 44226 repo stars
- [mcp-server · sv-number](https://affpapa.org/en/nevibecode/mcp/sv-number-mcp-server.md) — ★ 429 repo stars
- [mcp-server · mapbox](https://affpapa.org/en/nevibecode/mcp/mapbox-mcp-server.md) — ★ 373 repo stars
- [mcp-server · packmindhub](https://affpapa.org/en/nevibecode/mcp/packmindhub-mcp-server.md) — ★ 327 repo stars
- [mcp-server · bingowon](https://affpapa.org/en/nevibecode/mcp/bingowon-mcp-server.md) — ★ 117 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
