@coinversaa/mcp-server

finance MCP Server

Hyperliquid trading intelligence for AI agents — cohort analytics, liquidation heatmaps, trader profiling, and real-time market data across 710K+ wallets.

VerifiedInstall Ready
financefinance
5 views4 stars1 forksv0.6.0MIT

Why This Matters

Discovered via github-topic:model-context-protocol and last synced 3mo ago.

VerifiedInstall Ready
Source
github-topic:model-context-protocol
Stars
4
Last synced
3mo ago
Install
Instructions detected

Install

1. Install the package

npx -y @coinversaa/[email protected]

2. Add to claude_desktop_config.json

{
  "mcpServers": {
    "coinversaa-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@coinversaa/[email protected]"
      ]
    }
  }
}

Config file location: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) / %APPDATA%\Claude\claude_desktop_config.json (Windows)

57
Tools
0
Resources
0
Prompts
Standard I/O
Transport

Available Tools (57)

flx

Perps

live_coin_risk_history

Multi-lane history for a coin: OI, long/short, cohort rotation, candles, dislocations, and liquidation flow

pulse_recent_closed_positions

Positions just closed across all traders with entry/exit data

market_orderbook

Bid/ask depth for any trading pair

live_recent_liquidations

Real syncer liquidation events with wallet, coin, penalty fee, and closed PnL

COINVERSAA_API_KEY

No

pulse_cross_market_asset

Aggregated 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 answer to "is X crowded?" and "do venues disagree on Y?".

abcd

Misc

pulse_biggest_trades

Biggest winning or losing trades across all of Hyperliquid

pulse_trader_performance

30-day vs all-time comparison with trend direction

pulse_cohort_trades

Every trade a cohort made in the last N minutes/hours

market_recent_candles

Recent 1-minute candles for a market, capped to the last 12 hours to keep MCP responses practical

xyz

Commodities, stocks, indices

list_markets

Canonical market discovery — every symbol with dex, price, volume, funding rate, OI

list_assets

Directory of canonical assets — every asset grouped by economic exposure, with venues, synonyms, and a cross-market flag. Use `crossMarketOnly: true` to filter to multi-venue assets.

pulse_trader_closed_positions

Historical position lifecycle — entry/exit prices, hold duration, PnL

live_coin_risk_snapshot

Current single-coin fragility snapshot: OI, crowding, top positions, liquidation heatmap, and 7-day stress

live_cohort_bias_history

How each cohort's long/short bias evolved over time — useful for tracking smart-money rotation

list_asset

Single canonical lookup with venue breakdown. Accepts synonyms — `list_asset({canonical: "PAXG"})` returns the GOLD asset.

km

Energy & commodities

pulse_most_traded_coins

Most actively traded coins ranked by volume and trade count

pulse_trader_profile

Full due diligence on any wallet (PnL, win rate, tiers, profit factor)

pulse_cohort_positions

What money_printers / whales are holding RIGHT NOW

market_historical_oi

Historical hourly open interest snapshots (notional USD)

live_liquidation_summary

Best liquidation summary tool: counts, totals, by-coin rollups, and timeline buckets

COINVERSAA_API_URL

No

vntl

Perps

Tool

Description

live_official_oi

**Official per-dex OI** pulled from Hyperliquid's Info API (venue ground truth, not derived) — hourly snapshots up to 30 days

cash

Stocks & equities

Goal

Best tools

pulse_recent_trades

Biggest trades in the last N minutes/hours

pulse_trader_trades

Recent trades for any wallet — the copy-trading signal

pulse_token_leaderboard

Top traders for a specific coin

USDC

BTC, ETH, SOL, HYPE

pulse_global_stats

Total traders, trades, volume, PnL across Hyperliquid — call this for current coverage numbers

pulse_trader_token_stats

Per-coin P&L breakdown (find a trader's edge)

pulse_trader_daily_stats

Day-by-day PnL, win rate, and volume breakdown

pulse_cohort_bias_history

Historical hourly bias snapshots for all cohorts

live_liquidation_heatmap

Liquidation clusters across price levels — support/resistance signals

live_oi_history

Historical open interest for any coin or global — hourly snapshots up to 30 days (our derived OI)

pulse_cohort_history

Historical performance trends for any cohort

live_cohort_bias

Net long/short stance for every tier on a given coin

pulse_cohort_performance_daily

Historical daily performance stats for all cohorts

live_risk_overview

Exchange-wide risk snapshot: OI, leverage, crowding, near-liquidation exposure, and 7-day liquidation totals

live_long_short_ratio

Global or per-coin long/short ratio with optional history

Dex

What it trades

hyna

Perps

pulse_hidden_gems

Underrated high-performers most platforms miss

pulse_cohort_summary

Behavioral tier breakdown across every tracked wallet

pulse_market_overview

Deprecated alias for `list_markets` (same payload)

pulse_trader_closed_position_stats

Aggregate stats: avg hold time, position win rate, scalper vs swing

market_price

Current mark price for any symbol (native or builder dex)

pulse_leaderboard

Top traders ranked by PnL, win rate, volume, score, or risk-adjusted returns

market_positions

Open positions for any wallet

live_mark_dislocations

Mark/oracle dislocation history for a coin — useful for spotting basis stress before or during unwinds

Variable

Required