profitabul-mcp

# 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

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`:
```bash
PROFITABUL_API_KEY=pab_live_YOUR_KEY_HERE
```

### 3. Configure mcporter

Add to `config/mcporter.json`:
```json
{
  "mcpServers": {
    "profitabul": {
      "baseUrl": "https://agents.profitabul.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${PROFITABUL_API_KEY}"
      }
    }
  }
}
```

### 4. Verify

```bash
mc...