Profitabul MCP

---

name: profitabul-mcp

description: Real-time futures market intelligence, GEX/options flow analysis, trading signals, paper trading, backtesting, and live execution via MCP. Covers ES, NQ, SPX, NDX, QQQ, IWM, GC, SI, CL, and more.

version: 0.2.3

metadata:

openclaw:

requires:

env:

- PROFITABUL_API_KEY

primaryEnv: PROFITABUL_API_KEY

emoji: "\U0001F4C8"

homepage: https://profitabul.ai

---

# 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](https://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