Skip to main content

Cerebrus Pulse MCP

PyPI License: MIT Python 3.10+

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.

Tools

Tool Description Cost
cerebrus_health Gateway health check Free
cerebrus_list_coins List all available tickers (50+) Free
cerebrus_pulse Multi-timeframe technicals (RSI, EMAs, BBands, VWAP, regime) $0.02
cerebrus_sentiment Aggregated market sentiment + fear/greed $0.01
cerebrus_funding Funding rate analysis with historical context $0.01
cerebrus_bundle Pulse + sentiment + funding combined (20% discount) $0.04
cerebrus_screener Scan all coins for top signals $0.04
cerebrus_oi Open interest delta, percentile, trend $0.01
cerebrus_spread Bid-ask spread + slippage estimates $0.008
cerebrus_correlation BTC-altcoin correlation matrix $0.03
cerebrus_stress Cross-chain arbitrage-derived market stress index $0.015
cerebrus_cex_dex CEX vs DEX price divergence $0.02
cerebrus_basis Chainlink oracle vs Hyperliquid basis $0.02
cerebrus_depeg USDC collateral health via Chainlink $0.01
cerebrus_liquidations Liquidation heatmap across 5 leverage tiers $0.03

Paid endpoints use x402 micropayments (USDC on Base or Solana). Free tools work without any configuration.

Install

Claude Desktop / Cursor / Windsurf

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 your wallet key:

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

Set either or both — the x402 SDK picks the chain your wallet is configured for.

pip

pip install cerebrus-pulse-mcp

CLI Usage

The 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 (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

Arguments can be passed positionally (for coin) or as key=value pairs.

Configuration

Environment Variable Description Required
CEREBRUS_BASE_URL API base URL (default: https://api.cerebruspulse.xyz) No
CEREBRUS_WALLET_KEY Base wallet private key for x402 auto-payment No
CEREBRUS_WALLET_KEY_SOLANA Solana wallet private key for x402 auto-payment No

Example Response

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

Development

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

Links

License

MIT

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

Uploaded Python 3

File details

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

File metadata

  • Download URL: cerebrus_pulse_mcp-0.4.1.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.4.1.tar.gz
Algorithm Hash digest
SHA256 9b21260033775414098edb7f283e739c3d1e6ae41876a1fad73dca2d484de309
MD5 900cec917335942890d89bec85a5972d
BLAKE2b-256 df312a8e095ae5e30cf3417c55691238ce37f3e88322e3850f4c19b942278c7d

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for cerebrus_pulse_mcp-0.4.1-py3-none-any.whl
Algorithm Hash digest
SHA256 46cbae8600efdbdfcbbc71e44a213eb376e315c865f2ef4a80f78b384e32d528
MD5 5bd689b6a43810328a9b04df9513b014
BLAKE2b-256 686c7352f050b0f96e852eddb141782a860b2f4d5552220d4d049f1c64333cf4

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

0.4.1 This release

2 files

0.4.0

2 files

0.3.2

2 files

0.3.1

2 files

0.3.0

2 files

0.2.0

2 files

Supported by

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