Skip to main content

MCP server for Cerebrus Pulse — real-time crypto intelligence API for Hyperliquid perpetuals

Project description

Cerebrus Pulse MCP Server

MCP server for Cerebrus Pulse — real-time crypto intelligence API for 50+ Hyperliquid perpetuals. Pays with USDC on Base or Solana via x402.

Use this server to give any MCP-compatible AI agent (Claude Desktop, Cursor, Windsurf, etc.) access to:

  • Technical analysis — RSI, EMAs, ATR, Bollinger Bands, VWAP, Z-score, trend, regime, confluence scoring
  • Liquidation heatmap — Estimated liquidation zones by leverage tier with cascade risk
  • Market Stress Index — Cross-chain arbitrage-derived stress signal across 8 chains
  • CEX-DEX divergence — Centralized vs decentralized exchange price comparison
  • Chainlink basis — HL perpetual oracle vs Chainlink spot with contrarian signals
  • USDC depeg monitor — Collateral health via Chainlink oracle + sequencer status
  • Market sentiment — Fear/greed, momentum, funding bias
  • Funding rates — Current and historical with annualized projections
  • Analysis bundles — All data combined at discount

Quick Start

Install

pip install cerebrus-pulse-mcp

Or with uvx:

uvx cerebrus-pulse-mcp

Claude Desktop

Add to your claude_desktop_config.json:

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

Cursor / Windsurf

Add to your MCP settings:

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

Available Tools (15)

Tool Cost Description
cerebrus_list_coins Free List available coins (50+ Hyperliquid perpetuals)
cerebrus_health Free Check gateway health status
cerebrus_pulse $0.025 Multi-timeframe technical analysis (RSI, EMAs, Bollinger, trend, regime)
cerebrus_screener $0.06 Scan 50+ coins for signals, trends, vol regime, confluence
cerebrus_liquidations $0.03 Liquidation heatmap by leverage tier (3x-50x) with cascade risk
cerebrus_sentiment $0.01 Aggregated crypto market sentiment
cerebrus_funding $0.01 Funding rate analysis with historical data
cerebrus_oi $0.01 Open interest analysis: delta, percentile, trend, divergence
cerebrus_spread $0.008 Spread analysis: slippage estimates, liquidity scoring
cerebrus_correlation $0.03 BTC-alt correlation matrix with regime classification
cerebrus_stress $0.015 Cross-chain market stress index (8 chains, arb-derived)
cerebrus_cex_dex $0.02 CEX-DEX price divergence (Coinbase vs Chainlink/Uniswap)
cerebrus_basis $0.02 Chainlink basis: HL perp oracle vs Chainlink spot price
cerebrus_depeg $0.01 USDC collateral health via Chainlink oracle
cerebrus_bundle $0.05 Complete bundle: pulse + sentiment + funding (9% discount)

How Payment Works

Cerebrus Pulse uses x402 — USDC micropayments on Base blockchain. No API keys or subscriptions.

Free tools (cerebrus_list_coins, cerebrus_health) work immediately with no setup.

Paid tools require x402 payment. Without a wallet configured, the server returns payment details (cost, address) so you can see what data is available. To enable auto-payment:

  1. Get a Base wallet with USDC
  2. Set CEREBRUS_WALLET_KEY environment variable
  3. Payments happen automatically per query

Example Usage

Once connected, you can ask your AI agent:

  • "What's the technical analysis for BTC on the 1h timeframe?"
  • "Where are the liquidation clusters for ETH?"
  • "What's the current market stress level?"
  • "Show me CEX-DEX divergence for BTC"
  • "Is USDC holding its peg right now?"
  • "Get a complete analysis bundle for SOL"
  • "Scan all coins for the strongest signals"

Environment Variables

Variable Default Description
CEREBRUS_BASE_URL https://api.cerebruspulse.xyz API base URL
CEREBRUS_WALLET_KEY Base wallet private key for x402 auto-payment

Links

Disclaimer

Cerebrus Pulse provides market data and technical indicators for informational purposes only. Nothing provided by this MCP server or the underlying API constitutes financial advice, investment advice, or trading advice. AI-generated analysis, signals, and sentiment labels are algorithmic outputs — not recommendations to buy, sell, or hold any asset. Cryptocurrency trading involves substantial risk of loss. You are solely responsible for your own trading decisions.

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cerebrus_pulse_mcp-0.3.2.tar.gz (64.6 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

cerebrus_pulse_mcp-0.3.2-py3-none-any.whl (8.9 kB view details)

Uploaded Python 3

File details

Details for the file cerebrus_pulse_mcp-0.3.2.tar.gz.

File metadata

  • Download URL: cerebrus_pulse_mcp-0.3.2.tar.gz
  • Upload date:
  • Size: 64.6 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.0

File hashes

Hashes for cerebrus_pulse_mcp-0.3.2.tar.gz
Algorithm Hash digest
SHA256 23b1bb4ff05426f8cbcad51ec7ff401b42ace5ec519e9e23ded4046870a4dffd
MD5 ca46b75f617f1d28dd2f2a0c8d34ea65
BLAKE2b-256 d9edd27665976b1f1353a9c341d21893a07ed5f4e7789418d94632e1f84bcb1d

See more details on using hashes here.

File details

Details for the file cerebrus_pulse_mcp-0.3.2-py3-none-any.whl.

File metadata

File hashes

Hashes for cerebrus_pulse_mcp-0.3.2-py3-none-any.whl
Algorithm Hash digest
SHA256 c7556fe37865470926a7f5da97f4d96c0769b61ac991ae8e852685e918220911
MD5 b5ead04e67981bedc755c708620f65a1
BLAKE2b-256 27686375e069c49c569f822ce24edd75e1db90bc53778cf57133f3eece0bceeb

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page