{
  "markdown": "# Cerebrus Pulse MCP\n\n<!-- Ownership marker for the MCP registry; must match server.json name. -->\nmcp-name: io.github.0xsl1m/cerebrus-pulse-mcp\n\n\n[![PyPI](https://img.shields.io/pypi/v/cerebrus-pulse-mcp)](https://pypi.org/project/cerebrus-pulse-mcp/)\n[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)\n[![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://pypi.org/project/cerebrus-pulse-mcp/)\n\nMCP server for [Cerebrus Pulse](https://cerebruspulse.xyz) — 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.\n\n## Tools\n\n| Tool | Description | Cost |\n|------|-------------|------|\n| `cerebrus_health` | Gateway health check | Free |\n| `cerebrus_list_coins` | List all available tickers (50+) | Free |\n| `cerebrus_pulse` | Multi-timeframe technicals (RSI, EMAs, BBands, VWAP, regime) | $0.02 |\n| `cerebrus_sentiment` | Aggregated market sentiment + fear/greed | $0.01 |\n| `cerebrus_funding` | Funding rate analysis with historical context | $0.01 |\n| `cerebrus_bundle` | Pulse + sentiment + funding combined (20% discount) | $0.04 |\n| `cerebrus_screener` | Scan all coins for top signals | $0.04 |\n| `cerebrus_oi` | Open interest delta, percentile, trend | $0.01 |\n| `cerebrus_spread` | Bid-ask spread + slippage estimates | $0.008 |\n| `cerebrus_correlation` | BTC-altcoin correlation matrix | $0.03 |\n| `cerebrus_stress` | Cross-chain arbitrage-derived market stress index | $0.015 |\n| `cerebrus_cex_dex` | CEX vs DEX price divergence | $0.02 |\n| `cerebrus_basis` | Chainlink oracle vs Hyperliquid basis | $0.02 |\n| `cerebrus_depeg` | USDC collateral health via Chainlink | $0.01 |\n| `cerebrus_liquidations` | Liquidation heatmap across 5 leverage tiers | $0.03 |\n\nPaid endpoints use [x402](https://x402.org/) micropayments (USDC on **Base** or **Solana**). Free tools work without any configuration.\n\n## Install\n\n### Claude Desktop / Cursor / Windsurf\n\nAdd to your MCP config (`claude_desktop_config.json`, `.cursor/mcp.json`, etc.):\n\n```json\n{\n  \"mcpServers\": {\n    \"cerebrus-pulse\": {\n      \"command\": \"uvx\",\n      \"args\": [\"cerebrus-pulse-mcp\"]\n    }\n  }\n}\n```\n\nTo enable automatic x402 payments for paid endpoints, install the payment\nextra and add your wallet key:\n\n```bash\npip install \"cerebrus-pulse-mcp[pay]\"\n```\n\nThen:\n\n```json\n{\n  \"mcpServers\": {\n    \"cerebrus-pulse\": {\n      \"command\": \"uvx\",\n      \"args\": [\"cerebrus-pulse-mcp\"],\n      \"env\": {\n        \"CEREBRUS_WALLET_KEY\": \"your-base-wallet-private-key\",\n        \"CEREBRUS_WALLET_KEY_SOLANA\": \"your-solana-wallet-private-key\"\n      }\n    }\n  }\n}\n```\n\nAutomatic payment currently covers **Base** only. `CEREBRUS_WALLET_KEY_SOLANA`\nis reserved for a future Solana signer — the API accepts Solana today, but you\nwould need to settle those payments yourself.\n\nWithout a wallet key (or without the `[pay]` extra) paid tools still work as\ndiscovery: they return the exact price, network, and recipient so the calling\nagent can pay however it likes.\n\n### pip\n\n```bash\npip install cerebrus-pulse-mcp\n```\n\n## CLI Usage\n\nThe server includes a `--json` flag for direct CLI access without an MCP client:\n\n```bash\n# List all available CLI tools\ncerebrus-pulse-mcp --json\n\n# Free endpoints\ncerebrus-pulse-mcp --json health\ncerebrus-pulse-mcp --json list-coins\n\n# Paid endpoints (returns payment details if wallet not configured)\ncerebrus-pulse-mcp --json pulse BTC\ncerebrus-pulse-mcp --json funding ETH lookback_hours=48\ncerebrus-pulse-mcp --json screener top_n=10\ncerebrus-pulse-mcp --json liquidations SOL\n```\n\nArguments can be passed positionally (for coin) or as `key=value` pairs.\n\n## Configuration\n\n| Environment Variable | Description | Required |\n|---------------------|-------------|----------|\n| `CEREBRUS_BASE_URL` | API base URL (default: `https://api.cerebruspulse.xyz`) | No |\n| `CEREBRUS_WALLET_KEY` | Base wallet private key for x402 auto-payment (requires the `[pay]` extra) | No |\n| `CEREBRUS_WALLET_KEY_SOLANA` | Reserved; Solana auto-payment not yet implemented | No |\n\n## Example Response\n\n```bash\n$ cerebrus-pulse-mcp --json health\n{\n  \"status\": \"ok\",\n  \"engine\": \"available\",\n  \"kill_switch\": \"enabled\",\n  \"version\": \"1.2.0\"\n}\n```\n\n## Development\n\n```bash\ngit clone https://github.com/0xsl1m/cerebrus-pulse-mcp.git\ncd cerebrus-pulse-mcp\npip install -e .\n```\n\n## Links\n\n- [Cerebrus Pulse](https://cerebruspulse.xyz) — API documentation and guides\n- [x402 Protocol](https://x402.org/) — HTTP 402 micropayment standard\n- [PyPI Package](https://pypi.org/project/cerebrus-pulse-mcp/)\n- [Changelog](CHANGELOG.md)\n\n## License\n\nMIT\n",
  "bytes": 4689,
  "sha": "48bdec7bb2189332620669f6018f24f92ca492e511fc2dc7abe6cac88a6b4028",
  "repo_slug": "0xsl1m/cerebrus-pulse-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_0xsl1m_cerebrus_pulse_mcp_9961a6ec/readme"
}