This MCP server gives AI agents real-time crypto intelligence for Hyperliquid perpetuals via 14 tools (free health/coin-listing plus paid x402-micropayment analytics).
Free: check gateway health (cerebrus_health) and list available coin tickers (cerebrus_list_coins).
Technical analysis: multi-timeframe RSI/EMA/ATR/Bollinger/VWAP/regime via cerebrus_pulse, or a combined pulse+sentiment+funding cerebrus_bundle.
Sentiment & rates: aggregated market sentiment/fear-greed (cerebrus_sentiment) and funding-rate history (cerebrus_funding).
Derivatives data: open interest deltas and trends (cerebrus_oi), bid-ask spread and slippage (cerebrus_spread), and liquidation heatmaps across leverage tiers (cerebrus_liquidations).
Screening & correlation: scan all coins for top signals (cerebrus_screener) and get BTC-altcoin correlation matrices (cerebrus_correlation).
Cross-market signals: arbitrage-based market stress index (cerebrus_stress), CEX vs DEX price divergence (cerebrus_cex_dex), Chainlink-oracle basis (cerebrus_basis), and USDC depeg/collateral health (cerebrus_depeg).
Payment: paid tools use x402 USDC micropayments on Base (auto-pay via wallet key with spend limits) or return payment terms for the agent to settle; Solana accepted but not yet auto-signed.
Leverages Chainlink oracle data to provide basis analysis against perpetual markets and to monitor the collateral health of USDC.
Allows for CEX-DEX price divergence analysis by comparing Coinbase exchange data with decentralized exchange and oracle pricing.
Enables USDC micropayments via the x402 protocol on the Solana blockchain to facilitate access to real-time crypto intelligence and premium technical analysis tools.
mcp-name: io.github.0xsl1m/cerebrus-pulse-mcp
MCP server for Cerebrus Pulse — real-time crypto intelligence for AI agents. Provides 15 tools covering technical analysis, liquidation heatmaps, market stress, funding rates, and more across 50+ Hyperliquid perpetuals.
Tool | Description | Cost |
| Gateway health check | Free |
| List all available tickers (50+) | Free |
| Multi-timeframe technicals (RSI, EMAs, BBands, VWAP, regime) | $0.025 |
| Aggregated market sentiment + fear/greed | $0.01 |
| Funding rate analysis with historical context | $0.01 |
| Pulse + sentiment + funding combined | $0.05 |
| Scan all coins for top signals | $0.06 |
| Open interest delta, percentile, trend | $0.015 |
| Bid-ask spread + slippage estimates | $0.015 |
| BTC-altcoin correlation matrix | $0.05 |
| Cross-chain arbitrage-derived market stress index | $0.02 |
| CEX vs DEX price divergence | $0.02 |
| Chainlink oracle vs Hyperliquid basis | $0.02 |
| USDC collateral health via Chainlink | $0.01 |
| Liquidation heatmap across 5 leverage tiers | $0.03 |
Paid endpoints use x402 micropayments (USDC on Base or Solana). Free tools work without any configuration.
Prices are checked against the API's live x402 manifest
(https://api.cerebruspulse.xyz/.well-known/x402) with
python scripts/check_prices.py --live, which CI runs. The auto-pay payee pin
is checked against a live 402 with python scripts/check_payto.py --live,
which CI and the release workflow run.
Related MCP server: Funding-mcp
Add to your MCP config (claude_desktop_config.json, .cursor/mcp.json, etc.):
{
"mcpServers": {
"cerebrus-pulse": {
"command": "uvx",
"args": ["cerebrus-pulse-mcp"]
}
}
}To enable automatic x402 payments for paid endpoints, add a wallet key. The
x402 client ships with the package, so the same uvx command pays; there is no
extra to install:
{
"mcpServers": {
"cerebrus-pulse": {
"command": "uvx",
"args": ["cerebrus-pulse-mcp"],
"env": {
"CEREBRUS_WALLET_KEY": "your-base-wallet-private-key",
"CEREBRUS_WALLET_KEY_SOLANA": "your-solana-wallet-private-key"
}
}
}
}Automatic payment currently covers Base only. CEREBRUS_WALLET_KEY_SOLANA
is reserved for a future Solana signer — the API accepts Solana today, but you
would need to settle those payments yourself.
Use a dedicated hot wallet that holds a few dollars of USDC on Base, never a main wallet: the key sits in plain text in the MCP config.
Auto-payment has spend limits, checked before anything is signed:
no single payment above CEREBRUS_MAX_PAYMENT_USD (default 0.10; the
priciest tool costs $0.06);
no more than CEREBRUS_MAX_SPEND_USD in total while the server process runs
(default 1.00; restart the server to reset it). The --json CLI starts a
new process on every call, so this budget cannot span CLI calls, and the CLI
does not auto-pay unless you opt in (see CLI Usage);
only USDC on Base, and only to an address in CEREBRUS_ALLOWED_PAYTO
(default: the published Cerebrus Pulse Base address), so a hijacked or
mistyped CEREBRUS_BASE_URL cannot redirect payments.
A refused payment returns "status": "payment_blocked" with the reason; a
malformed limit disables auto-payment rather than lifting the limit.
Without a wallet key, paid tools still work as discovery: they return the exact price, network, and recipient so the calling agent can pay however it likes.
pip install cerebrus-pulse-mcpThe server includes a --json flag for direct CLI access without an MCP client:
# List all available CLI tools
cerebrus-pulse-mcp --json
# Free endpoints
cerebrus-pulse-mcp --json health
cerebrus-pulse-mcp --json list-coins
# Paid endpoints (return the payment terms unless CLI auto-pay is on, below)
cerebrus-pulse-mcp --json pulse BTC
cerebrus-pulse-mcp --json funding ETH lookback_hours=48
cerebrus-pulse-mcp --json screener top_n=10
cerebrus-pulse-mcp --json liquidations SOLArguments can be passed positionally (for coin) or as key=value pairs.
The CLI does not auto-pay by default, even with CEREBRUS_WALLET_KEY set.
Every call is a new process with a fresh CEREBRUS_MAX_SPEND_USD budget, so
the budget cannot stop a script that runs the CLI in a loop. Set
CEREBRUS_CLI_AUTOPAY=1 to let it pay anyway: each call may then sign one
payment of up to CEREBRUS_MAX_PAYMENT_USD, and limiting how many calls run
is up to your script.
Environment Variable | Description | Required |
| API base URL (default: | No |
| Base wallet private key for x402 auto-payment | No |
| Largest single payment auto-pay may sign (default: | No |
| Total auto-pay may sign per server process (default: | No |
| Set to | No |
| Comma-separated payTo addresses auto-pay may pay (default: the published Cerebrus Pulse Base address) | No |
| Reserved; Solana auto-payment not yet implemented | No |
$ cerebrus-pulse-mcp --json health
{
"status": "ok",
"engine": "available",
"kill_switch": "enabled",
"version": "1.2.0"
}git clone https://github.com/0xsl1m/cerebrus-pulse-mcp.git
cd cerebrus-pulse-mcp
pip install -e .Cerebrus Pulse — API documentation and guides
x402 Protocol — HTTP 402 micropayment standard
MIT
Get Chainlink basis analysis — compares Hyperliquid perpetual oracle price vs Chainlink aggregated spot price on Arbitrum. Returns basis in bps, direction (hl_premium/hl_discount/aligned), and contrarian signal. Positive = longs paying shorts, negative = deleveraging. Cost: $0.02 USDC via x402.
Inputs: coin (required).
Get complete analysis bundle: multi-timeframe technical analysis (5m/15m/1h/4h/1d/1w) + sentiment + funding combined in one call. 20% discount vs individual endpoints. Cost: $0.04 USDC via x402.
Inputs: coin (required), timeframes.
Get CEX-DEX price divergence for a token. Compares Coinbase (CEX) vs Chainlink/Uniswap (DEX) prices. Returns spread in bps, direction (cex_premium or dex_premium), and interpretation. Refreshes every 5 minutes. Cost: $0.02 USDC via x402.
Inputs: coin (required).
Get BTC-altcoin correlation matrix for top 15 Hyperliquid perpetuals. Returns 30-day rolling correlations, correlation regime (CORRELATED/DECORRELATED/MIXED), and sector averages. Cost: $0.03 USDC via x402.
Inputs: no named parameters.
Get USDC collateral health monitor via Chainlink oracle. Checks USDC/USD deviation from $1.00 peg, reports peg status (HEALTHY/ELEVATED/WARNING/CRITICAL), risk level, and Arbitrum sequencer status. Essential before sizing USDC-margined positions. Cost: $0.01 USDC via x402.
Inputs: no named parameters.
Get funding rate analysis for a Hyperliquid perpetual. Returns current rate, annualized percentage, historical min/max/average. Cost: $0.01 USDC via x402.
Inputs: coin (required), lookback_hours.
Check Cerebrus Pulse gateway health status. FREE — no payment required.
Inputs: no named parameters.
Get estimated liquidation heatmap for a Hyperliquid perpetual. Maps where liquidation clusters sit across 5 leverage tiers (3x-50x) for both longs and shorts. Returns cascade risk level (LOW/MODERATE/HIGH/EXTREME), estimated USD at each zone, proximity to current price, long/short ratio from funding skew, and nearest cluster alert. No other MCP provider offers this signal. Cost: $0.03 USDC via x402.
Inputs: coin (required).
List all available coins on Cerebrus Pulse. Returns tickers for 30+ Hyperliquid perpetuals. FREE — no payment required.
Inputs: no named parameters.
Get open interest analysis for a Hyperliquid perpetual. Returns OI delta (1h/4h/24h), percentile rank, trend direction, and price-OI divergence signals. Cost: $0.01 USDC via x402.
Inputs: coin (required).
Get multi-timeframe technical analysis for a Hyperliquid perpetual. Supports 6 timeframes: 5m, 15m, 1h, 4h, 1d, 1w (daily/weekly aggregated from 1h). Returns RSI, EMAs (20/50/200), ATR, Bollinger Bands, VWAP, Z-score, trend direction, cross-timeframe confluence with alignment scoring, derivatives data (funding, OI, spread), and market regime. Cost: $0.02 USDC via x402.
Inputs: coin (required), timeframes.
Scan all 30+ coins for top trading signals. Returns RSI zone, trend, volatility regime, funding bias, multi-TF confluence score with alignment, and OI trend for each coin. Much cheaper than calling pulse individually. Cost: $0.04 USDC via x402.
Inputs: top_n.
Get aggregated crypto market sentiment analysis. Returns overall sentiment, fear/greed, momentum, and funding bias. Not coin-specific. Cost: $0.01 USDC via x402.
Inputs: no named parameters.
Get spread and liquidity analysis for a Hyperliquid perpetual. Returns bid-ask spread, estimated slippage at $10k/$50k/$100k/$500k, and liquidity score (1-10). Cost: $0.008 USDC via x402.
Inputs: coin (required).
Get market stress index derived from cross-chain arbitrage detection. Scans 8 chains (Arbitrum, Base, Optimism, Polygon, etc.) for price dislocations. Returns stress level (LOW/MODERATE/HIGH/EXTREME), score (0-1), spread statistics, chain routes, and recent scan summaries. Unique signal — not available from any other provider. Cost: $0.015 USDC via x402.
Inputs: limit.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 15 tools
Each tool serves a unique purpose, from specific analyses like funding rates and liquidations to aggregated signals like the screener and bundle. Descriptions clearly differentiate them.
All tools follow a uniform 'cerebrus_' prefix with descriptive, lowercase, snake_case names, making the set predictable and easy to navigate.
With 15 tools, the server covers a broad range of analytics without being overwhelming. Each tool addresses a distinct aspect of Hyperliquid perpetual trading.
The toolkit is comprehensive, covering technical analysis, sentiment, funding, liquidations, OI, spreads, and more. Minor gaps exist (e.g., no raw price feed or historical data export), but core workflows are well-supported.
Live crypto market data and Hyperliquid wallet reports for AI agents, paid per call with x402.
Live data for AI agents: crypto, Hyperliquid, stocks, news, macro, predictions. Free key or x402.
Hyperliquid perp funding, OI, preflight & news sentiment for agents. Pay per call in USDC (x402).
Hyperliquid data and liquidation alerts for AI agents: fills, candles, funding, wallet analytics.
