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:
- Get a Base wallet with USDC
- Set
CEREBRUS_WALLET_KEYenvironment variable - 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
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
23b1bb4ff05426f8cbcad51ec7ff401b42ace5ec519e9e23ded4046870a4dffd
|
|
| MD5 |
ca46b75f617f1d28dd2f2a0c8d34ea65
|
|
| BLAKE2b-256 |
d9edd27665976b1f1353a9c341d21893a07ed5f4e7789418d94632e1f84bcb1d
|
File details
Details for the file cerebrus_pulse_mcp-0.3.2-py3-none-any.whl.
File metadata
- Download URL: cerebrus_pulse_mcp-0.3.2-py3-none-any.whl
- Upload date:
- Size: 8.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c7556fe37865470926a7f5da97f4d96c0769b61ac991ae8e852685e918220911
|
|
| MD5 |
b5ead04e67981bedc755c708620f65a1
|
|
| BLAKE2b-256 |
27686375e069c49c569f822ce24edd75e1db90bc53778cf57133f3eece0bceeb
|