Skip to main content
Glama
cerebrus-pulse-mcp

cerebrus-pulse-mcp

by 0xsl1m

Cerebrus Pulse MCP

PyPI License: MIT Python 3.10+

MCP-Server für Cerebrus Pulse — Echtzeit-Krypto-Intelligence für KI-Agenten. Bietet 15 Tools für technische Analysen, Liquidations-Heatmaps, Marktstress, Finanzierungsraten und mehr für über 50 Hyperliquid-Perpetuals.

Tools

Tool

Beschreibung

Kosten

cerebrus_health

Gateway-Gesundheitsprüfung

Kostenlos

cerebrus_list_coins

Alle verfügbaren Ticker auflisten (50+)

Kostenlos

cerebrus_pulse

Technische Daten über mehrere Zeitrahmen (RSI, EMAs, BBands, VWAP, Regime)

$0.02

cerebrus_sentiment

Aggregiertes Markt-Sentiment + Fear/Greed-Index

$0.01

cerebrus_funding

Analyse der Finanzierungsrate mit historischem Kontext

$0.01

cerebrus_bundle

Pulse + Sentiment + Finanzierung kombiniert (20% Rabatt)

$0.04

cerebrus_screener

Alle Coins auf Top-Signale scannen

$0.04

cerebrus_oi

Open Interest Delta, Perzentil, Trend

$0.01

cerebrus_spread

Geld-Brief-Spanne + Slippage-Schätzungen

$0.008

cerebrus_correlation

BTC-Altcoin-Korrelationsmatrix

$0.03

cerebrus_stress

Aus Cross-Chain-Arbitrage abgeleiteter Marktstress-Index

$0.015

cerebrus_cex_dex

CEX vs. DEX Preisdivergenz

$0.02

cerebrus_basis

Chainlink-Orakel vs. Hyperliquid-Basis

$0.02

cerebrus_depeg

USDC-Sicherheiten-Gesundheit via Chainlink

$0.01

cerebrus_liquidations

Liquidations-Heatmap über 5 Hebelstufen

$0.03

Kostenpflichtige Endpunkte nutzen x402 Mikrozahlungen (USDC auf Base oder Solana). Kostenlose Tools funktionieren ohne Konfiguration.

Related MCP server: Funding-mcp

Installation

Claude Desktop / Cursor / Windsurf

Zur MCP-Konfiguration hinzufügen (claude_desktop_config.json, .cursor/mcp.json, etc.):

{
  "mcpServers": {
    "cerebrus-pulse": {
      "command": "uvx",
      "args": ["cerebrus-pulse-mcp"]
    }
  }
}

Um automatische x402-Zahlungen für kostenpflichtige Endpunkte zu aktivieren, fügen Sie Ihren Wallet-Key hinzu:

{
  "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"
      }
    }
  }
}

Setzen Sie einen oder beide — das x402 SDK wählt die Chain, für die Ihr Wallet konfiguriert ist.

pip

pip install cerebrus-pulse-mcp

CLI-Nutzung

Der Server enthält ein --json Flag für den direkten CLI-Zugriff ohne 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 (returns payment details if wallet not configured)
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 SOL

Argumente können positional (für Coins) oder als key=value Paare übergeben werden.

Konfiguration

Umgebungsvariable

Beschreibung

Erforderlich

CEREBRUS_BASE_URL

API-Basis-URL (Standard: https://api.cerebruspulse.xyz)

Nein

CEREBRUS_WALLET_KEY

Base-Wallet-Private-Key für x402-Autozahlung

Nein

CEREBRUS_WALLET_KEY_SOLANA

Solana-Wallet-Private-Key für x402-Autozahlung

Nein

Beispielantwort

$ cerebrus-pulse-mcp --json health
{
  "status": "ok",
  "engine": "available",
  "kill_switch": "enabled",
  "version": "1.2.0"
}

Entwicklung

git clone https://github.com/0xsl1m/cerebrus-pulse-mcp.git
cd cerebrus-pulse-mcp
pip install -e .

Lizenz

MIT

Available Tools

15 tools
cerebrus_basisA

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).

cerebrus_bundleA

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.

cerebrus_cex_dexA

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).

cerebrus_correlationA

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.

cerebrus_depegA

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.

cerebrus_fundingA

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.

cerebrus_healthB

Check Cerebrus Pulse gateway health status. FREE — no payment required.

Inputs: no named parameters.

cerebrus_liquidationsA

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).

cerebrus_list_coinsA

List all available coins on Cerebrus Pulse. Returns tickers for 30+ Hyperliquid perpetuals. FREE — no payment required.

Inputs: no named parameters.

cerebrus_oiA

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).

cerebrus_pulseA

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.

cerebrus_screenerA

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.

cerebrus_sentimentA

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.

cerebrus_spreadA

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).

cerebrus_stressA

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.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A4.1/5.0

    Scored across 15 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    All tools follow a uniform 'cerebrus_' prefix with descriptive, lowercase, snake_case names, making the set predictable and easy to navigate.

    Tool Count5/5

    With 15 tools, the server covers a broad range of analytics without being overwhelming. Each tool addresses a distinct aspect of Hyperliquid perpetual trading.

    Completeness4/5

    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.

    Maintenance

    ActivityInactive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Real-time perp market-data for AI trading agents — funding rates, funding-arb signals, open interest, volume, orderbook depth/slippage and oracle families across 25 venues, plus HIP-3 RWA coverage (tokenized stocks, metals, oil) that mainstream aggregators lack. x402-native pay-per-call (USDC on Base): one free funding screener tool + 11 paid tools with auto-pay.
      12
      35 npm
      2
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to retrieve real-time and historical Hyperliquid funding rates across 229 perp markets, sort them, and identify funding rate arbitrage opportunities via x402 micropayments.
      MIT