Cerebrus Pulse MCP

io.github.0xsl1mPublished by GitHub account 0xsl1mv0.5.1Updated Oct 24, 2026

Real-time Hyperliquid perps intelligence: TA, funding, OI, liquidations. Pay-per-call via x402.

VerifiedSTDIODesktop onlyFinanceData & Analytics

Overview

AI-generated overview

Local MCP server giving assistants real-time Hyperliquid perpetuals intelligence: technicals, funding, open interest, liquidations and market stress, paid per-c

What you can do
Check gateway health and list the 50+ available Hyperliquid perpetual tickers for free. Retrieve multi-timeframe technicals (RSI, EMAs, Bollinger Bands, VWAP, regime) and aggregated sentiment with fear/greed. Analyze funding rates with historical context, open interest deltas and percentiles, bid-ask spreads and slippage. Scan all coins for top signals, build BTC-altcoin correlation matrices, and compare CEX vs DEX prices, Chainlink oracle basis and USDC depeg health. Map liquidation heatmaps across five leverage tiers, or fetch a combined pulse, sentiment and funding bundle.
When to use it
Useful when an assistant needs live crypto derivatives context on Hyperliquid perpetuals — technical setups, funding and open-interest shifts, liquidation levels or market stress — for trading research or market commentary. Free tools work for simple ticker and health checks without any setup.
Requirements
Runs locally as a Python package (PyPI cerebrus-pulse-mcp), typically launched with uvx or installed via pip; desktop MCP client such as Claude Desktop, Cursor or Windsurf. Network access to the Cerebrus Pulse API. Paid tools need a Base wallet private key in CEREBRUS_WALLET_KEY for automatic x402 USDC payments; optional limits via CEREBRUS_MAX_PAYMENT_USD, CEREBRUS_MAX_SPEND_USD and CEREBRUS_ALLOWED_PAYTO.
Before you install
Paid tools cost real USDC on Base per call (roughly $0.01 to $0.06), so usage spends money. CEREBRUS_WALLET_KEY is a plain-text private key in the MCP config; the README advises a dedicated hot wallet holding only a few dollars, never a main wallet. Auto-payment is capped per payment and per server process, but the CLI budget resets on every call and CEREBRUS_CLI_AUTOPAY=1 can sign a payment per call. CEREBRUS_WALLET_KEY_SOLANA is reserved and not yet used. Queries go to a third-party API.

Installation

In SourceWeft

  1. Open Cerebrus Pulse MCP in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

Cerebrus Pulse MCP

mcp-name: io.github.0xsl1m/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

ToolDescriptionCost
cerebrus_healthGateway health checkFree
cerebrus_list_coinsList all available tickers (50+)Free
cerebrus_pulseMulti-timeframe technicals (RSI, EMAs, BBands, VWAP, regime)$0.025
cerebrus_sentimentAggregated market sentiment + fear/greed$0.01
cerebrus_fundingFunding rate analysis with historical context$0.01
cerebrus_bundlePulse + sentiment + funding combined$0.05
cerebrus_screenerScan all coins for top signals$0.06
cerebrus_oiOpen interest delta, percentile, trend$0.015
cerebrus_spreadBid-ask spread + slippage estimates$0.015
cerebrus_correlationBTC-altcoin correlation matrix$0.05
cerebrus_stressCross-chain arbitrage-derived market stress index$0.02
cerebrus_cex_dexCEX vs DEX price divergence$0.02
cerebrus_basisChainlink oracle vs Hyperliquid basis$0.02
cerebrus_depegUSDC collateral health via Chainlink$0.01
cerebrus_liquidationsLiquidation heatmap across 5 leverage tiers$0.03

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

Prices are checked against the API's live x402 manifest (https://api.cerebruspulse.xyz/.well-known/x402) with python scripts/check_prices.py --live, which CI runs. The auto-pay payee pin is checked against a live 402 with python scripts/check_payto.py --live, which CI and the release workflow run.

Install

Claude Desktop / Cursor / Windsurf

Add to your MCP config (claude_desktop_config.json, .cursor/mcp.json, etc.):

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

To enable automatic x402 payments for paid endpoints, add a wallet key. The x402 client ships with the package, so the same uvx command pays; there is no extra to install:

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

Automatic payment currently covers Base only. CEREBRUS_WALLET_KEY_SOLANA is reserved for a future Solana signer — the API accepts Solana today, but you would need to settle those payments yourself.

Use a dedicated hot wallet that holds a few dollars of USDC on Base, never a main wallet: the key sits in plain text in the MCP config.

Auto-payment has spend limits, checked before anything is signed:

  • no single payment above CEREBRUS_MAX_PAYMENT_USD (default 0.10; the priciest tool costs $0.06);
  • no more than CEREBRUS_MAX_SPEND_USD in total while the server process runs (default 1.00; restart the server to reset it). The --json CLI starts a new process on every call, so this budget cannot span CLI calls, and the CLI does not auto-pay unless you opt in (see CLI Usage);
  • only USDC on Base, and only to an address in CEREBRUS_ALLOWED_PAYTO (default: the published Cerebrus Pulse Base address), so a hijacked or mistyped CEREBRUS_BASE_URL cannot redirect payments.

A refused payment returns "status": "payment_blocked" with the reason; a malformed limit disables auto-payment rather than lifting the limit.

Without a wallet key, paid tools still work as discovery: they return the exact price, network, and recipient so the calling agent can pay however it likes.

pip

bash
pip install cerebrus-pulse-mcp

CLI Usage

The server includes a --json flag for direct CLI access without an MCP client:

bash
# List all available CLI toolscerebrus-pulse-mcp --json
# Free endpointscerebrus-pulse-mcp --json healthcerebrus-pulse-mcp --json list-coins
# Paid endpoints (return the payment terms unless CLI auto-pay is on, below)cerebrus-pulse-mcp --json pulse BTCcerebrus-pulse-mcp --json funding ETH lookback_hours=48cerebrus-pulse-mcp --json screener top_n=10cerebrus-pulse-mcp --json liquidations SOL

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

The CLI does not auto-pay by default, even with CEREBRUS_WALLET_KEY set. Every call is a new process with a fresh CEREBRUS_MAX_SPEND_USD budget, so the budget cannot stop a script that runs the CLI in a loop. Set CEREBRUS_CLI_AUTOPAY=1 to let it pay anyway: each call may then sign one payment of up to CEREBRUS_MAX_PAYMENT_USD, and limiting how many calls run is up to your script.

Configuration

Environment VariableDescriptionRequired
CEREBRUS_BASE_URLAPI base URL (default: https://api.cerebruspulse.xyz)No
CEREBRUS_WALLET_KEYBase wallet private key for x402 auto-paymentNo
CEREBRUS_MAX_PAYMENT_USDLargest single payment auto-pay may sign (default: 0.10)No
CEREBRUS_MAX_SPEND_USDTotal auto-pay may sign per server process (default: 1.00); does not span --json CLI callsNo
CEREBRUS_CLI_AUTOPAYSet to 1 to let the --json CLI auto-pay (default: off, because the budget resets on every CLI call)No
CEREBRUS_ALLOWED_PAYTOComma-separated payTo addresses auto-pay may pay (default: the published Cerebrus Pulse Base address)No
CEREBRUS_WALLET_KEY_SOLANAReserved; Solana auto-payment not yet implementedNo

Example Response

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

Development

bash
git clone https://github.com/0xsl1m/cerebrus-pulse-mcp.gitcd cerebrus-pulse-mcppip install -e .

Links

License

MIT

Source: README.md at commit e8c6ca2

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.5.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts