Profitabul MCP

Real-time futures and options market intelligence for AI trading agents. Get live market context, GEX-derived support/resistance levels, trading signals, historical data, backtesting, and paper trading — all through a single MCP endpoint.

Features

Market Context — Live price, GEX regime, VIX state, and candle summaries for 13 symbols
Heatseeker Signals — Directional trading signals combining gamma exposure, vanna exposure, and VIX trend
GEX Key Levels — King node, gatekeeper, zero gamma, ceiling, and floor levels derived from real options flow
Historical Data — Candle data across multiple timeframes (1m to 1d) with up to 200K bars
Statistics — Realized volatility, average range, volume stats over any lookback period
Reports — Opening Range Breakout (ORB) and Initial Balance (IB) analysis
Backtesting — Server-side strategy backtests (ORB breakout/fade) with configurable parameters
Paper Trading — Open, close, and track hypothetical positions with full P&L
Live Execution — Execute real trades through ProjectX broker (when enabled)

Supported Symbols

Category	Symbols
Indices	SPX, NDX
ETFs	SPY, QQQ, IWM
Futures	ES, NQ, YM, RTY
Commodities	GC (Gold), SI (Silver), CL (Crude Oil), HG (Copper)

Setup

1. Get Your API Key

Sign up at profitabul.com
Subscribe to a Pro plan (API access is included)
Go to Settings > Integrations and generate an Agent API key
Copy the key (shown once, starts with pab_live_)

2. Configure Environment

Add to ~/.clawdbot/.env:

PROFITABUL_API_KEY=pab_live_YOUR_KEY_HERE

3. Configure mcporter

Add to config/mcporter.json:

{
  "mcpServers": {
    "profitabul": {
      "baseUrl": "https://agents.profitabul.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${PROFITABUL_API_KEY}"
      }
    }
  }
}

4. Verify

mcporter list profitabul

Available Tools (16)

Market Intelligence

Tool	Description
`get_market_context`	Comprehensive market snapshot: price, GEX levels, VIX state, candle summary
`get_signal`	Heatseeker trading signal with directional bias, confidence, and entry/exit levels
`get_key_levels`	GEX-derived support/resistance: king node, gatekeeper, zero gamma, floor, ceiling

Historical Data & Analysis

Tool	Description
`get_history`	Fetch historical candles for any symbol/timeframe/date range
`get_statistics`	Summary statistics: realized volatility, average range, volume
`run_report`	Opening Range Breakout (ORB) and Initial Balance (IB) analysis
`run_backtest`	Server-side strategy backtest with configurable parameters

Paper Trading

Tool	Description
`paper_trade`	Open, close, or list paper positions with P&L tracking

profitabul-mcp

Install via CLI (Recommended)