Crypto intelligence for AI agents. Query 710K+ Hyperliquid wallets, 1.8B+ trades, behavioral cohorts, and live market data through any MCP-compatible client.
Now with builder dex support — trade commodities (gold, silver, oil), stocks (TSLA, AAPL), and perps across 8 dexes and 369+ markets.
Try it instantly — no sign-up needed. 7 tools with rate limits:
{
"mcpServers": {
"coinversaa": {
"command": "npx",
"args": ["-y", "@coinversaa/mcp-server"]
}
}
}For all 30 tools and higher rate limits, get an API key (Option B).
Get a key at coinversaa.ai/developers or email chat@coinversaa.ai.
Edit ~/Library/Application Support/Claude/claude_desktop_config.json (Mac) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"coinversaa": {
"command": "npx",
"args": ["-y", "@coinversaa/mcp-server"],
"env": {
"COINVERSAA_API_KEY": "cvsa_your_key_here"
}
}
}
}Add to .cursor/mcp.json in your project root:
{
"mcpServers": {
"coinversaa": {
"command": "npx",
"args": ["-y", "@coinversaa/mcp-server"],
"env": {
"COINVERSAA_API_KEY": "cvsa_your_key_here"
}
}
}
}claude mcp add coinversaa -- npx -y @coinversaa/mcp-serverSet the env var in your shell:
export COINVERSAA_API_KEY="cvsa_your_key_here"That's it. No cloning, no building — npx handles everything.
Hyperliquid supports multiple builder dexes beyond the native perps exchange. Each dex has its own set of markets, collateral token, and symbol format.
| Dex | What it trades | Collateral | Example symbols |
|---|---|---|---|
| (native) | Core perps (crypto) | USDC | BTC, ETH, SOL, HYPE |
xyz |
Commodities, stocks, indices | USDC | xyz:GOLD, xyz:SILVER, xyz:TSLA |
flx |
Perps | USDH | flx:BTC, flx:ETH |
vntl |
Perps | USDH | vntl:ANTHROPIC, vntl:BTC |
hyna |
Perps | USDE | hyna:SOL, hyna:BTC |
km |
Energy & commodities | USDH | km:OIL, km:NATGAS |
abcd |
Misc | USDC | abcd:BITCOIN |
cash |
Stocks & equities | USDT0 | cash:TSLA, cash:AAPL |
Symbol format:
- Native Hyperliquid symbols:
BTC,ETH,SOL - Builder dex symbols:
prefix:COIN— e.g.xyz:GOLD,cash:TSLA,hyna:SOL
Use the list_markets tool to discover all available symbols and which dex they belong to.
These 7 tools work without an API key, with IP-based rate limits:
| Tool | Rate Limit | Description |
|---|---|---|
pulse_global_stats |
10/min | Total traders, trades, volume across Hyperliquid |
pulse_market_overview |
5/min | Live prices, funding rates, OI for every pair (filterable by dex) |
list_markets |
5/min | Discover all available markets with dex, price, volume, OI |
market_price |
30/min | Current mark price for any symbol |
market_orderbook |
10/min | Bid/ask depth for any trading pair |
pulse_most_traded_coins |
5/min | Most actively traded coins by volume |
live_long_short_ratio |
5/min | Global or per-coin long/short ratio |
Daily cap: 500 requests/day per IP.
All 30 tools with 100 req/min per key. Includes trader profiles, cohort intelligence, closed positions, historical analytics, and more.
| Tool | Description |
|---|---|
pulse_global_stats |
Total traders, trades, volume, PnL across Hyperliquid |
pulse_market_overview |
Live prices, funding rates, OI for every pair. Optional dex param to filter by builder dex |
list_markets |
Discover all available markets across all dexes — returns dex, price, volume, funding rate, OI |
pulse_leaderboard |
Top traders ranked by PnL, win rate, volume, score, or risk-adjusted returns |
pulse_hidden_gems |
Underrated high-performers most platforms miss |
pulse_most_traded_coins |
Most actively traded coins ranked by volume and trade count |
pulse_biggest_trades |
Biggest winning or losing trades across all of Hyperliquid |
pulse_recent_trades |
Biggest trades in the last N minutes/hours |
pulse_token_leaderboard |
Top traders for a specific coin |
| Tool | Description |
|---|---|
pulse_trader_profile |
Full due diligence on any wallet (PnL, win rate, tiers, profit factor) |
pulse_trader_performance |
30-day vs all-time comparison with trend direction |
pulse_trader_trades |
Recent trades for any wallet — the copy-trading signal |
pulse_trader_daily_stats |
Day-by-day PnL, win rate, and volume breakdown |
pulse_trader_token_stats |
Per-coin P&L breakdown (find a trader's edge) |
pulse_trader_closed_positions |
Historical position lifecycle — entry/exit prices, hold duration, PnL |
pulse_trader_closed_position_stats |
Aggregate stats: avg hold time, position win rate, scalper vs swing |
710K+ wallets classified into behavioral tiers — unique data nobody else has.
PnL tiers (by profitability): money_printer, smart_money, grinder, humble_earner, exit_liquidity, semi_rekt, full_rekt, giga_rekt
Size tiers (by volume): leviathan, tidal_whale, whale, small_whale, apex_predator, dolphin, fish, shrimp
| Tool | Description |
|---|---|
pulse_cohort_summary |
Behavioral tier breakdown across 710K+ wallets |
pulse_cohort_positions |
What money_printers / whales are holding RIGHT NOW |
pulse_cohort_trades |
Every trade a cohort made in the last N minutes/hours |
pulse_cohort_history |
Historical performance trends for any cohort |
pulse_cohort_bias_history |
Historical hourly bias snapshots for all cohorts |
pulse_cohort_performance_daily |
Historical daily performance stats for all cohorts |
| Tool | Description |
|---|---|
market_price |
Current mark price for any symbol (native or builder dex) |
market_positions |
Open positions for any wallet |
market_orderbook |
Bid/ask depth for any trading pair |
market_historical_oi |
Historical hourly open interest snapshots (notional USD) |
| Tool | Description |
|---|---|
live_liquidation_heatmap |
Liquidation clusters across price levels — support/resistance signals |
live_long_short_ratio |
Global or per-coin long/short ratio with optional history |
live_cohort_bias |
Net long/short stance for every tier on a given coin |
pulse_recent_closed_positions |
Positions just closed across all traders with entry/exit data |
Once connected, try asking your AI:
- "What are the top 5 traders on Hyperliquid by PnL?"
- "Show me what the money_printer tier is holding right now"
- "What are the biggest trades in the last 10 minutes?"
- "What did wallet 0x7fda...7d1 trade in the last hour?"
- "Find underrated traders with 70%+ win rate"
- "Do a deep dive on wallet 0x7fda...7d1 — are they still performing?"
- "Where are the BTC liquidation clusters?"
- "Are smart money traders long or short ETH right now?"
- "Show me the biggest losses in the last 24 hours"
- "What coins are most actively traded right now?"
- "What's this trader's average hold time and position win rate?"
- "What markets are available on the xyz dex?"
- "Show me all gold and silver markets"
- "What's the price of xyz:GOLD?"
- "List all builder dex markets with their prices"
- "What stocks can I trade on Hyperliquid?"
| Variable | Required | Default | Description |
|---|---|---|---|
COINVERSAA_API_KEY |
No | — | Your API key (starts with cvsa_). Without it, only 7 free tools are available. |
COINVERSAA_API_URL |
No | https://staging.api.coinversaa.ai |
API base URL (will move to api.coinversaa.ai for production) |
Free tier: Per-route limits (5-30/min) + 500 requests/day per IP. See the free tier table for details.
Paid tier (API key): 100 requests/minute, no daily cap.
Rate limit headers are included in every response:
X-RateLimit-Limit: your configured limitX-RateLimit-Remaining: requests left in current windowX-RateLimit-Reset: seconds until window resetsX-RateLimit-Tier:freeorpaidX-RateLimit-Daily-Remaining: (free tier only) requests left today
git clone https://github.com/coinversaa/mcp-server.git
cd mcp-server
npm install
npm run build
# Test with MCP Inspector
npx @modelcontextprotocol/inspector build/index.jsThis isn't a wrapper around a public blockchain API. Coinversaa indexes Hyperliquid's clearinghouse directly and computes analytics that don't exist anywhere else:
- Builder dex markets: Access 369+ markets across 8 dexes — commodities, stocks, indices, and perps
- Behavioral cohorts: 710K wallets classified into PnL tiers (money_printer to giga_rekt) and size tiers (leviathan to shrimp)
- Live cohort positions: See what the best traders are holding in real-time
- Real-time trade feed: Every trade by any wallet or cohort, queryable by time window
- Liquidation heatmaps: Cluster analysis across price levels for any coin
- Closed position analytics: Full position lifecycle with hold duration and entry/exit analysis
- Hidden gem discovery: Find skilled traders that ranking sites miss
- 1.8B+ trades indexed: The deepest Hyperliquid dataset available as an API
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
Built by Coinversaa