Crypto intelligence for AI agents on Hyperliquid
Coinversaa Pulse — MCP Server
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.
Quick Start
Option A: Free Tier (No API Key)
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).
Option B: Full Access (API Key)
Get a key at coinversaa.ai/developers or email chat@coinversaa.ai.
Claude Desktop
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"
}
}
}
}
Cursor
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 Code
claude mcp add coinversaa -- npx -y @coinversaa/mcp-server
Set the env var in your shell:
export COINVERSAA_API_KEY="cvsa_your_key_here"
That's it. No cloning, no building — npx handles everything.
Builder Dex Markets
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.
Available Tools (30)
Free Tier (No API Key Required)
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.
Full Access (API Key Required — 23 additional tools)
All 30 tools with 100 req/min per key. Includes trader profiles, cohort intelligence, closed positions, historical analytics, and more.
Pulse — Trader Intelligence
| 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 |
Pulse — Trader Profiles
| 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 |
| `p |
Tools (9)
pulse_global_statsGet total traders, trades, volume, and PnL across Hyperliquid.pulse_market_overviewGet live prices, funding rates, and OI for every pair, with optional dex filtering.list_marketsDiscover all available markets across all dexes including price, volume, and OI.market_priceGet current mark price for any symbol.market_orderbookGet bid/ask depth for any trading pair.pulse_most_traded_coinsRank coins by volume and trade count.live_long_short_ratioGet global or per-coin long/short ratio.pulse_leaderboardGet top traders ranked by PnL, win rate, volume, or risk-adjusted returns.pulse_trader_profilePerform due diligence on any wallet including PnL, win rate, and profit factor.Environment Variables
COINVERSAA_API_KEYAPI key for full access to 30 tools and higher rate limits.Configuration
{"mcpServers": {"coinversaa": {"command": "npx", "args": ["-y", "@coinversaa/mcp-server"], "env": {"COINVERSAA_API_KEY": "cvsa_your_key_here"}}}}