Profitabul

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

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

1. Sign up at profitabul.com 2. Subscribe to a Pro plan (API access is included) 3. Go to Settings > Integrations and generate an Agent API key 4. 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 |

Live Execution (When Enabled)

| Tool | Description | |------|-------------| | live_open | Open a live futures trade with stop/target | | live_close | Close a tracked live trade | | live_reduce | Partially reduce an open position | | live_add_risk | Add stop-loss/take-profit to existing position | | live_cancel_orders | Cancel open orders | | live_account | Read account info (balance, margin) | | live_positions | Read open positions | | live_orders | Read working orders |

Usage Examples

Market Analysis Workflow

# 1. Get current market context
mcporter call 'profitabul.get_market_context(symbol: "SPX")'
2. Check key GEX levels
mcporter call 'profitabul.get_key_levels(symbol: "SPX")'
3. Get trading signal based on current conditions
mcporter call 'profitabul.get_signal(
  symbol: "SPX",
  gex_bias: "positive",
  vex_bias: "bullish",
  vix_trend: "falling"
)'

Historical Analysis

# Get 30 days of 5-minute candles
mcporter call 'profitabul.get_history(symbol: "ES", timeframe: "5m", days: 30)'
Run ORB analysis
mcporter call 'profitabul.run_report(reportType: "orb", symbol: "ES", days: 60)'
Backtest ORB breakout strategy
mcporter call 'profitabul.run_backtest(
  symbol: "ES",
  days: 30,
  strategy: { type: "orb-breakout", params: { stopMult: 0.75, targetMult: 1.0 } }
)'

Paper Trading

# Open a paper trade
mcporter call 'profitabul.paper_trade(
  action: "open",
  symbol: "ES",
  side: "long",
  entry: 5825,
  size: 2,
  reason: "GEX support bounce at zero gamma"
)'
List open positions
mcporter call 'profitabul.paper_trade(action: "list")'
Close a trade
mcporter call 'profitabul.paper_trade(
  action: "close",
  trade_id: "pt_1705312200_abc123",
  exit: 5850,
  close_reason: "Target reached at king node"
)'

Recommended Workflow

1. Start with context — Call get_market_context to understand current conditions 2. Check levels — Use get_key_levels for precise support/resistance 3. Get signal — Feed GEX bias, VEX bias, and VIX trend into get_signal 4. Validate with history — Use run_report or run_backtest to check if the setup has edge 5. Execute — Open a paper_trade (or live_open if enabled) at signal levels 6. Manage — Track and close positions based on level targets

Rate Limits

Resources

1. Get Your API Key

1. Sign up at profitabul.com 2. Subscribe to a Pro plan (API access is included) 3. Go to Settings > Integrations and generate an Agent API key 4. 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