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
- 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:
CODEBLOCK0
3. Configure mcporter
Add to config/mcporter.json:
CODEBLOCK1
4. Verify
CODEBLOCK2
Available Tools (16)
Market Intelligence
| Tool | Description |
|---|
| INLINECODE3 | Comprehensive market snapshot: price, GEX levels, VIX state, candle summary |
| INLINECODE4 |
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 |
|---|
| INLINECODE6 | Fetch historical candles for any symbol/timeframe/date range |
| INLINECODE7 |
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 |
|---|
| INLINECODE10 | Open, close, or list paper positions with P&L tracking |
Live Execution (When Enabled)
| Tool | Description |
|---|
| INLINECODE11 | Open a live futures trade with stop/target |
| INLINECODE12 |
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
CODEBLOCK3
Historical Analysis
CODEBLOCK4
Paper Trading
CODEBLOCK5
Recommended Workflow
- 1. Start with context — Call
get_market_context to understand current conditions - Check levels — Use
get_key_levels for precise support/resistance - Get signal — Feed GEX bias, VEX bias, and VIX trend into INLINECODE21
- Validate with history — Use
run_report or run_backtest to check if the setup has edge - Execute — Open a
paper_trade (or live_open if enabled) at signal levels - Manage — Track and close positions based on level targets
Rate Limits
- - 120 requests per minute per API key
- Sliding window rate limiting
- Returns
429 Too Many Requests with Retry-After header when exceeded
Resources
Profitabul MCP
面向AI交易代理的实时期货和期权市场情报。通过单一MCP端点获取实时市场环境、GEX衍生支撑/阻力位、交易信号、历史数据、回测和模拟交易。
功能特性
- - 市场环境 — 13个交易品种的实时价格、GEX机制、VIX状态和K线摘要
- Heatseeker信号 — 结合伽马暴露、万纳暴露和VIX趋势的方向性交易信号
- GEX关键价位 — 基于真实期权流计算的主节点、守门人、零伽马、天花板和地板价位
- 历史数据 — 多时间周期K线数据（1分钟至1天），最多支持20万根K线
- 统计指标 — 任意回溯周期的已实现波动率、平均波幅、成交量统计
- 报告分析 — 开盘区间突破（ORB）和初始平衡（IB）分析
- 回测功能 — 服务端策略回测（ORB突破/反转），支持可配置参数
- 模拟交易 — 开仓、平仓和追踪假设头寸，含完整盈亏记录
- 实盘执行 — 通过ProjectX经纪商执行真实交易（启用时可用）
支持的交易品种
SPY, QQQ, IWM |
| 期货 | ES, NQ, YM, RTY |
| 商品 | GC（黄金）, SI（白银）, CL（原油）, HG（铜） |
配置步骤
1. 获取API密钥
- 1. 在 profitabul.com 注册账号
- 订阅Pro计划（包含API访问权限）
- 进入 设置 > 集成 生成Agent API密钥
- 复制密钥（仅显示一次，以 pablive_ 开头）
2. 配置环境变量
添加到 ~/.clawdbot/.env：
bash
PROFITABULAPIKEY=pabliveYOURKEYHERE
3. 配置mcporter
添加到 config/mcporter.json：
json
{
mcpServers: {
profitabul: {
baseUrl: https://agents.profitabul.ai/mcp,
headers: {
Authorization: Bearer ${PROFITABULAPIKEY}
}
}
}
}
4. 验证配置
bash
mcporter list profitabul
可用工具（16个）
市场情报
| 工具 | 描述 |
|---|
| getmarketcontext | 综合市场快照：价格、GEX价位、VIX状态、K线摘要 |
| get_signal |
Heatseeker交易信号，含方向偏好、置信度和入场/离场价位 |
| get
keylevels | GEX衍生支撑/阻力位：主节点、守门人、零伽马、地板、天花板 |
历史数据与分析
| 工具 | 描述 |
|---|
| gethistory | 获取任意品种/时间周期/日期范围的历史K线 |
| getstatistics |
汇总统计：已实现波动率、平均波幅、成交量 |
| run_report | 开盘区间突破（ORB）和初始平衡（IB）分析 |
| run_backtest | 服务端策略回测，支持可配置参数 |
模拟交易
| 工具 | 描述 |
|---|
| paper_trade | 开仓、平仓或列出模拟持仓，含盈亏追踪 |
实盘执行（启用时可用）
| 工具 | 描述 |
|---|
| liveopen | 开立实盘期货交易，含止损/目标价 |
| liveclose |
平仓追踪的实盘交易 |
| live_reduce | 部分减仓现有头寸 |
| live
addrisk | 为现有持仓添加止损/止盈 |
| live
cancelorders | 取消未成交订单 |
| live_account | 读取账户信息（余额、保证金） |
| live_positions | 读取当前持仓 |
| live_orders | 读取挂单信息 |
使用示例
市场分析工作流
bash
1. 获取当前市场环境
mcporter call profitabul.get
marketcontext(symbol: SPX)
2. 查看关键GEX价位
mcporter call profitabul.get
keylevels(symbol: SPX)
3. 基于当前条件获取交易信号
mcporter call profitabul.get_signal(
symbol: SPX,
gex_bias: positive,
vex_bias: bullish,
vix_trend: falling
)
历史分析
bash
获取30天5分钟K线
mcporter call profitabul.get_history(symbol: ES, timeframe: 5m, days: 30)
运行ORB分析
mcporter call profitabul.run_report(reportType: orb, symbol: ES, days: 60)
回测ORB突破策略
mcporter call profitabul.run_backtest(
symbol: ES,
days: 30,
strategy: { type: orb-breakout, params: { stopMult: 0.75, targetMult: 1.0 } }
)
模拟交易
bash
开立模拟交易
mcporter call profitabul.paper_trade(
action: open,
symbol: ES,
side: long,
entry: 5825,
size: 2,
reason: GEX支撑位零伽马反弹
)
列出当前持仓
mcporter call profitabul.paper_trade(action: list)
平仓
mcporter call profitabul.paper_trade(
action: close,
trade
id: pt1705312200_abc123,
exit: 5850,
close_reason: 主节点目标位已触及
)
推荐工作流程
- 1. 从环境开始 — 调用 getmarketcontext 了解当前状况
- 查看价位 — 使用 getkeylevels 获取精确支撑/阻力位
- 获取信号 — 将GEX偏好、VEX偏好和VIX趋势输入 getsignal
- 历史验证 — 使用 runreport 或 runbacktest 验证策略有效性
- 执行交易 — 在信号价位开立 papertrade（或启用 live_open）
- 持仓管理 — 根据目标价位追踪并平仓
速率限制
- - 每个API密钥每分钟120次请求
- 滑动窗口速率限制
- 超限时返回 429 Too Many Requests，附带 Retry-After 响应头
相关资源
