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
  • Market sentiment — Fear/greed, momentum, funding bias
  • Funding rates — Current and historical with annualized projections
  • Market Stress Index — Cross-chain arbitrage-derived stress signal
  • CEX-DEX divergence — Centralized vs decentralized exchange price comparison
  • Analysis bundles — All data combined at 17% 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

Tool Cost Description
cerebrus_list_coins Free List available coins (30+ Hyperliquid perpetuals)
cerebrus_health Free Check gateway health status
cerebrus_pulse $0.02 Multi-timeframe technical analysis (RSI, EMAs, Bollinger, trend, regime)
cerebrus_sentiment $0.01 Aggregated crypto market sentiment
cerebrus_funding $0.01 Funding rate analysis with historical data
cerebrus_bundle $0.04 Complete bundle: pulse + sentiment + funding (20% discount)
cerebrus_screener $0.04 Scan 30+ coins for signals, trends, vol regime, confluence
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

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?"
  • "Show me ETH funding rates for the last 48 hours"
  • "What's the current market sentiment?"
  • "Get a complete analysis bundle for SOL"
  • "List all available coins"

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.0.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.0-py3-none-any.whl (8.1 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: cerebrus_pulse_mcp-0.3.0.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.0.tar.gz
Algorithm Hash digest
SHA256 0e1d698be77c7c21714de629ae5914166d6ab1fe8ca7aa59961ba303ab52650d
MD5 74d7af15f2d2d0e57041eab76c059913
BLAKE2b-256 3b89470c565fc11207c885edaf16737f0d0cb219d268324eb9d8c8748e86cec3

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for cerebrus_pulse_mcp-0.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 73393935b27c74fbd3110c087873e01a27f4a2d5a0c6d2eec860bc05c823ae59
MD5 2366aceb0d072e284f20c36b1dafc093
BLAKE2b-256 3a1f8168f0a29a2ffc6944952ea9cc3f1142c72264ac7949948c1b09aa74c012

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