mcp-server · coinversaa — Claude Code MCP server: Hyperliquid crypto analytics
MCP server for Hyperliquid analytics: trader data, cohorts, indexed trade history with PnL attribution, order book depth, and live market data.
MIT ★ 10 updated 2026-09-24
claude mcp add mcp-server -e COINVERSAA_API_KEY=<COINVERSAA_API_KEY> -- npx -y @coinversaa/mcp-serverWhat mcp-server 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.
What it helps with
- 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 for the agent
- 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
How to install mcp-server
Platform CLI
claude mcp add mcp-server -e COINVERSAA_API_KEY=<COINVERSAA_API_KEY> -- npx -y @coinversaa/mcp-serverReplace <…> with your own values
Platform CLI
codex mcp add coinversaa-mcp-server --env COINVERSAA_API_KEY=<COINVERSAA_API_KEY> -- npx -y @coinversaa/mcp-serverReplace <…> with your own values
Config file
{
"mcpServers": {
"coinversaa-mcp-server": {
"command": "npx",
"args": [
"-y",
"@coinversaa/mcp-server"
],
"env": {
"COINVERSAA_API_KEY": "<COINVERSAA_API_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"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
Platform CLI
gemini mcp add -e COINVERSAA_API_KEY=<COINVERSAA_API_KEY> coinversaa-mcp-server npx -y @coinversaa/mcp-serverReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about mcp-server
How to install mcp-server in Claude Code?
Run claude mcp add mcp-server -e COINVERSAA_API_KEY=<COINVERSAA_API_KEY> -- npx -y @coinversaa/mcp-server, substituting your API key for the placeholder.
What does mcp-server do?
Connects an agent to Hyperliquid data: trade history with PnL, trader cohorts, L4 order book, entity profiles (owners of multiple wallets), builder analytics, and live markets. 107 tools, some gated to Pro tier.
What does mcp-server require?
A Coinversaa API key passed through the COINVERSAA_API_KEY environment variable. Without a key, the server will not start. Some tools work on the free plan; others require an upgrade.
Similar MCP servers
All MCP servers for Agent setup: memory, context, orchestration →mcp-server by other authors comes first.