Coinversaa MCP Server

Crypto intelligence for AI agents. Query the full Hyperliquid wallet universe, indexed trade history with PnL attribution, behavioral cohorts, and live market data through any MCP-compatible client.…

Local serverstdioMIT

What is the Coinversaa MCP Server?

Coinversaa Pulse is an MCP project maintained in the coinversaa/mcp-server repository. The maintainer describes its purpose as “Crypto intelligence for AI agents. Query the full Hyperliquid wallet universe, indexed trade history with PnL attribution, behavioral cohorts, and live market data through any…”. Read the project documentation for the complete scope.

Installation

The documented npm package is @coinversaa/mcp-server. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares COINVERSAA_API_KEY. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
GoalRecommended tool
pulse_global_statsTotal traders, trades, volume, PnL across Hyperliquid — call this for current coverage numbers
list_marketsCanonical market discovery — every symbol with dex, price, volume, funding rate, OI
pulse_market_overviewDeprecated alias for list_markets (same payload)
pulse_leaderboardTop traders ranked by PnL, win rate, volume, score, or risk-adjusted returns
pulse_hidden_gemsUnderrated high-performers most platforms miss
pulse_most_traded_coinsMost actively traded coins ranked by volume and trade count
pulse_biggest_tradesBiggest winning or losing trades across all of Hyperliquid
pulse_recent_tradesBiggest trades in the last N minutes/hours
pulse_token_leaderboardTop traders for a specific coin
list_assetsDirectory of canonical assets — every asset grouped by economic exposure, with venues, synonyms, and a cross-market flag. Use crossMarketOnly: true to filter…
list_assetSingle canonical lookup with venue breakdown. Accepts synonyms — list_asset({canonical: "PAXG"}) returns the GOLD asset.
pulse_cross_market_assetAggregated per-venue long/short/bias/OI for one asset, plus cross-venue totals and a biasRange metric (venues agree vs disagree on direction). The agent-native
hip4_outcomesFree API key
hip4_outcomeFree API key
hip4_outcome_summaryStarter+
hip4_outcome_recent_tradesFree API key
hip4_questionsFree API key
hip4_recent_settlementsFree API key
hip4_daily_volumeFree API key
hip4_most_activeFree API key
hip4_top_tradersStarter+
hip4_trader_outcomesStarter+
hip4_cross_product_overlapPro+
hip4_perp_position_contextPro+
builder_leaderboardStarter
builder_profileStarter
trader_buildersStarter
builder_tradersPro
builder_fillsPro
builder_cohortsPro
builder_retentionPro
builder_overlapPro
builder_journeyPro
builder_lifecyclePro
builder_ordersPro
pulse_trader_profileFull due diligence on any wallet (PnL, win rate, tiers, profit factor)
pulse_trader_performance30-day vs all-time comparison with trend direction
pulse_trader_demoFast wallet briefing: lifecycle summary plus recent top wins and losses
pulse_trader_tradesRecent trades for any wallet — the copy-trading signal
pulse_trader_daily_statsDay-by-day PnL, win rate, and volume breakdown
pulse_trader_token_statsPer-coin P&L breakdown (find a trader's edge)
pulse_trader_lifecycle_summaryPreferred 0.8 wallet position summary — wins/losses, liquidation count, hold time, fees, biggest win/loss
pulse_trader_lifecyclesPreferred 0.8 lifecycle history — one reconstructed open->close position per row
pulse_lifecycleOne lifecycle by ID, including composing fills
pulse_trader_closed_positionsLegacy closed-position payload; prefer pulse_trader_lifecycles for new position analysis
pulse_trader_closed_position_statsLegacy aggregate stats; prefer pulse_trader_lifecycle_summary for new position analysis
Apexapex
Sharpssharps
Grindersgrinders
Scrapersscrapers
Bleedersbleeders
Trappedtrapped
Heavyweightsheavyweights
Cruiserweightscruiserweights
Middleweightsmiddleweights
Welterweightswelterweights
Lightweightslightweights
Featherweightsfeatherweights
Flyweightsflyweights
Strawweightsstrawweights
pulse_cohort_summaryBehavioral tier breakdown across every tracked wallet
pulse_cohort_positionsWhat the Apex / Heavyweights tiers are holding RIGHT NOW
pulse_cohort_tradesEvery trade a cohort made in the last N minutes/hours
pulse_cohort_historyHistorical performance trends for any cohort
pulse_cohort_bias_historyHistorical hourly bias snapshots for all cohorts
pulse_cohort_performance_dailyHistorical daily performance stats for all cohorts
market_priceCurrent mark price for any symbol (native or builder dex)
market_positionsOpen positions for any wallet
market_orderbookBid/ask depth for any trading pair
market_historical_oiHistorical hourly open interest snapshots (notional USD)
market_recent_candlesRecent 1-minute candles for a market, capped to the last 12 hours to keep MCP responses practical
live_liquidation_heatmapLiquidation clusters across price levels — support/resistance signals
live_risk_overviewExchange-wide risk snapshot: OI, leverage, crowding, near-liquidation exposure, and 7-day liquidation totals
live_coin_risk_snapshotCurrent single-coin fragility snapshot: OI, crowding, top positions, liquidation heatmap, and 7-day stress
live_coin_risk_historyMulti-lane history for a coin: OI, long/short, cohort rotation, candles, dislocations, and liquidation flow
live_mark_dislocationsMark/oracle dislocation history for a coin — useful for spotting basis stress before or during unwinds
live_recent_liquidationsReal syncer liquidation events with wallet, coin, penalty fee, and closed PnL
live_liquidation_summaryBest liquidation summary tool: counts, totals, by-coin rollups, and timeline buckets
live_long_short_ratioGlobal or per-coin long/short ratio with optional history
live_cohort_biasNet long/short stance for every tier on a given coin
live_oi_historyHistorical open interest for any coin or global — hourly snapshots up to 30 days (our derived OI)
live_official_oiOfficial per-dex OI pulled from Hyperliquid's Info API (venue ground truth, not derived) — hourly snapshots up to 30 days
live_cohort_bias_historyHow each cohort's long/short bias evolved over time — useful for tracking smart-money rotation
pulse_recent_closed_positionsPositions just closed across all traders with entry/exit data

How to install the Coinversaa MCP Server

{
  "mcpServers": {
    "coinversa": {
      "command": "npx",
      "args": [
        "-y",
        "@coinversaa/mcp-server@0.12.0"
      ],
      "env": {
        "COINVERSAA_API_KEY": "YOUR_COINVERSAA_API_KEY"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
COINVERSAA_API_KEYDeclared in the maintainer’s client configuration.Yes