Annalist

Name: Annalist
Author: ryanroskowski

Server Details

Hyperliquid crowd state, smart-money positioning and base rates; pay per call via x402 (Base USDC)

If you are the author of this connector, you can claim ownership by verifying the domain or GitHub account it belongs to. Claimed connector authors can inspect health checks, view analytics, and manage their listing.

Status: Healthy
Last Tested: 2026-10-12 22:09
Transport: Streamable HTTP · MCP 2025-11-25
URL
Repository: ryanroskowski/annalist-ledger
GitHub Stars: 0

TDQS

Score is being calculated.

Available Tools

11 tools

annalist_aboutWhat Annalist offers (free)

Read-only

Inspect

Free. What Annalist is, every tool and its price, how payment works (x402, USDC on Base), and how fresh the data is.

ParametersJSON Schema

Name	Required	Description	Default
No parameters

annalist_baseratesBase-rate tables (free)

Read-only

Inspect

Free. Historical base rates for every crowd state: sample size, median and spread of later returns, chance of further run-ups. Optional state filter.

ParametersJSON Schema

Name	Required	Description	Default
`state`	No

annalist_market_sampleMarket view, 24h delayed (free)

Read-only

Inspect

Free. The crowd_market view as it was 24 hours ago, to evaluate the data before paying.

ParametersJSON Schema

Name	Required	Description	Default
No parameters

annalist_track_recordLive track record (free)

Read-only

Inspect

Free. Every crowd-state event's later outcome, compared with its backtest base rate.

ParametersJSON Schema

Name	Required	Description	Default
No parameters

crowd_changesCrowd-state events since a time

Read-only

Inspect

For bots that poll: crowd-state events (a perp entering or leaving a state) since a timestamp, newest first, up to 7 days back. Each event is signed with the mark price at the time. Not investment advice. Price: $0.005 USDC per call via x402 on Base.

ParametersJSON Schema

Name	Required	Description	Default
`since`	Yes	ISO timestamp within the last 7 days

crowd_historyHistorical crowd-state events

Read-only

Inspect

Signed historical crowd-state events for backtesting: up to 30 days per call, optionally filtered by coin and state. The archive is append-only and its daily hashes are published and Bitcoin-timestamped. Price: $0.05 USDC per call via x402 on Base.

ParametersJSON Schema

Name	Required	Description
`to`	Yes	YYYY-MM-DD, at most 30 days after from
`coin`	No	Hyperliquid perp symbol, for example BTC, ETH, SOL, HYPE, kPEPE (case-sensitive)
`from`	Yes	YYYY-MM-DD
`state`	No

crowd_marketMarket-wide crowding

Read-only

Inspect

Market-wide crowding on Hyperliquid: breadth of 7-day moves, how many perps are up 50%+/100%+ in a week, share of perps with funding in their own top/bottom 5%, total open interest and its 24h change, BTC and ETH funding percentiles, and Wikipedia attention to cryptocurrency. Signed. Not investment advice. Price: $0.01 USDC per call via x402 on Base.

ParametersJSON Schema

Name	Required	Description	Default
No parameters

crowd_perpCrowd state for one Hyperliquid perp

Read-only

Inspect

Use before acting on a Hyperliquid perpetual to see whether it is crowded or in a hype state and what historically followed. Returns 7-day move, funding (hourly, APR, percentile vs its own 90 days and vs all perps), open interest and its 24h/7d change, premium, Wikipedia attention, active crowd states, and each state's base rates (sample size, median and spread of 7/30/90-day returns). Signed. Not investment advice. Price: $0.01 USDC per call via x402 on Base.

ParametersJSON Schema

Name	Required	Description	Default
`coin`	Yes	Hyperliquid perp symbol, for example BTC, ETH, SOL, HYPE, kPEPE (case-sensitive)

crowd_statesAll perps in a crowd state

Read-only

Inspect

Every Hyperliquid perp currently in a crowd state (7-day moves of +50/+100/+200%, funding in its own top or bottom 5%, Wikipedia attention spikes, new listings), ranked by 7-day move, each with base rates for what followed similar states historically. Optional ?state= filter. Signed. Not investment advice. Price: $0.02 USDC per call via x402 on Base.

ParametersJSON Schema

Name	Required	Description	Default
`state`	No

smart_marketSmart-money positioning across all perps

Read-only

Inspect

Where Hyperliquid's most profitable traders are positioned across all perps: the cohort's overall net long or short, the coins it is most net long and most net short, the biggest 24-hour changes, and coins where smart money is positioned against the crowd. Cohort definition included. Aggregates only. Signed. Not investment advice. Price: $0.02 USDC per call via x402 on Base.

ParametersJSON Schema

Name	Required	Description	Default
No parameters

smart_perpSmart-money positioning for one perp

Read-only

Inspect

Use before acting on a Hyperliquid perpetual to see how the most profitable Hyperliquid traders are positioned in it: how many wallets in a 200-wallet smart-money cohort are long vs short, their long, short and net exposure in USD, the 24h change, how concentrated it is (largest wallet's share, trader-count view), leverage settings, their share of open interest, and how that compares with the crowd (funding, 7-day move). Flags smart money broadly positioned against a crowded move. Aggregates only, never wallet addresses. Signed. Not investment advice. Price: $0.01 USDC per call via x402 on Base.

ParametersJSON Schema

Name	Required	Description	Default
`coin`	Yes	Hyperliquid perp symbol, for example BTC, ETH, SOL, HYPE, kPEPE (case-sensitive)

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

11 tool updatesOct 12, 2026
- First observedannalist_about
- First observedannalist_baserates
- First observedannalist_market_sample
- First observedannalist_track_record
- First observedcrowd_changes
- First observedcrowd_history
- First observedcrowd_market
- First observedcrowd_perp
- First observedcrowd_states
- First observedsmart_market
- First observedsmart_perp

Related MCP Connectors

Carry Intel — Hyperliquid funding-carry intelligence
io.github.TheArkofTech
Hyperliquid funding-carry intel, per-call via x402 (USDC/Solana). Free sample tool included.
41
chiefofstaff Hyperliquid perp data + token safety A
com.run402.chiefofstaff-solana
Hyperliquid perp data (funding, whale liq levels, positioning, brief) + token safety, x402 per call.
Blockchain Cryptocurrency
101
mcp-server A
xyz.lonestaroracle
Paid market-data MCP: crypto, equities, smart-money, macro, wallet PnL. x402 per call on Base.
Cryptocurrency Finance Government Data
62
Buildix: Hyperliquid Orderflow A
trade.buildix
Read-only Hyperliquid analytics: orderflow, liquidation levels, whale positioning, funding.
Cryptocurrency Finance Blockchain
51

Related MCP Servers

hyperd-mcpofficial
Blockchain Cryptocurrency Web3 & Decentralized Tech
hyperd-ai
A
license
A
quality
D
maintenance
Pre-trade DeFi intelligence for AI agents. 20 paid x402 endpoints, USDC on Base.
Updated 4 months ago (2026-06-09 22:01 UTC)
23
53 npm
1
MIT
carrydesk
Finance Cryptocurrency
pelazas
A
license
A
quality
B
maintenance
Cross-sectional funding-carry rankings for Hyperliquid perpetual futures, metered per call in USDC via x402 on Base.
Updated a month ago (2026-09-01 03:00 UTC)
6
30 PyPI
MIT
x402-dex-intel
Blockchain Cryptocurrency Finance
Zydanny
A
license
A
quality
B
maintenance
Real-time DEX token momentum, orderbook liquidity depth, and whale flows on Base Mainnet gated with gasless x402 micropayments.
Updated a month ago (2026-08-28 14:41 UTC)
3
MIT
whaletape-mcp-server
Finance
Elipacosta88
A
license
Not graded
quality
A
maintenance
Provides pay-per-call Hyperliquid whale, funding, open-interest, and liquidation intelligence via x402 payments (USDC on Base, Solana, or Algorand), with free preview routes and no account or API key required.
Updated 19 days ago (2026-09-23 18:16 UTC)
49 npm
MIT