Documentation
Master Every Feature
AI Assistants & API
Use your subscription from Claude, ChatGPT, Cursor, or your own code
Profitabul runs a Model Context Protocol (MCP) server, so an AI assistant can read the same market data, levels, reports and backtests you see in the app, and work with your journal. Any paid plan can connect. Everything runs as you: the assistant sees only your account.
Server URL: https://mcp.profitabul.com
Building with code? Open the API Reference for every endpoint with request and response schemas, code samples in many languages, webhook payloads and test requests you can send with your key.
Claude (web, desktop, mobile)
Settings → Connectors → Add custom connector, paste the server URL, then sign in with your Profitabul account. Once Profitabul is in the connector directory you can add it from there instead.
ChatGPT
Add Profitabul from the apps directory once it is listed, and sign in with your Profitabul account.
Claude Code
claude mcp add --transport http profitabul https://mcp.profitabul.comRun /mcp in Claude Code to sign in.
Cursor, VS Code and other MCP clients
Add a remote (streamable HTTP) server with the URL above. Clients without sign-in support can use an API key:
{
"mcpServers": {
"profitabul": {
"url": "https://mcp.profitabul.com",
"headers": { "Authorization": "Bearer pab_live_..." }
}
}
}Create a key in Settings → Integrations. Send it as Authorization: Bearer pab_live_.... Keys stop working when your subscription ends, and you can revoke one at any time. Treat a key like a password: it acts as your account.
Turn on Read-only next to the key to let an assistant or script read data, reports and your settings without being able to change alerts, saved reports, your journal or settings.
Every assistant tool is also a REST endpoint, for scripts, notebooks and your own apps. Send the tool’s arguments as a JSON body with your API key. Plans, limits and results are the same as over MCP.
curl https://compute.profitabul.ai/v1/tools/get_history \
-H "Authorization: Bearer $PROFITABUL_API_KEY" \
-H "Content-Type: application/json" \
-d '{"symbol":"ES","timeframe":"5m","days":5,"max_candles":500}'GET /v1/toolslists the tools your plan includes, each with its JSON schema.POST /v1/tools/{name}runs one. Errors come back as{ ok: false, error: { code, message } }with a matching HTTP status.GET /v1/whoamishows your access, limits and usage today.- API Reference: every endpoint with schemas, code samples and test requests you can send with your key.
- OpenAPI 3.1: https://compute.profitabul.ai/openapi.json (import it into Postman, or generate a client).
Ask your assistant to set an alert, save a report setup, or switch your primary market. Alerts made this way are the same alerts as on the live chart: they are checked around the clock and sent to your devices.
get_settingslists your alerts, saved reports, chart layouts, presets and primary market.manage_alertcreates, changes, pauses, resumes or deletes a price alert, or a GEX alert on a gamma flip, wall cross, reshuffle or wall move (Options plans).manage_saved_reportsaves, renames or deletes a report setup.update_settingssets your primary market (ES, NQ or CL).
curl https://compute.profitabul.ai/v1/tools/manage_alert \
-H "Authorization: Bearer $PROFITABUL_API_KEY" \
-H "Content-Type: application/json" \
-d '{"action":"create","symbol":"NQ","price":21500,"condition":"crosses_above"}'Send alerts, agent condition fires and timer results to your own server, bot or automation. Add up to 5 https endpoints in Settings → Integrations or with the manage_webhook tool (list_webhook_endpoints shows delivery health). Events: alert.fired, condition.fired and timer.ran. Every delivery is signed (Profitabul-Signature, HMAC-SHA256); the cookbook shows how to verify it.
Draw your call wall, put wall, zero gamma, max gamma strike and key gamma level on the charts you already trade from. Each plug-in refreshes every minute with your API key (a read-only key is enough).
- NinjaTrader 8: copy to
Documents\NinjaTrader 8\bin\Custom\Indicators, press F5 in the NinjaScript Editor, add “Profitabul Levels” to a chart. - Quantower: build it as an indicator project in the Algo Lab, then add it to a chart.
- Sierra Chart: copy to
ACS_Source, Analysis → Build Custom Studies DLL, add “Profitabul Levels”.
Building your own? GET https://compute.profitabul.ai/v1/plugin/levels?symbol=NQ answers one label,price line per level (&format=json for JSON). On TradingView, use the Profitabul browser extension.
Sweeps, walk-forward tests, long backtests, studies and edge scans can run in the background, so your script or assistant does not have to wait on one long request.
submit_jobtakes a tool name and its usual arguments and answers at once with a job id. Up to 3 jobs run at once per account.get_jobreturns the status and, when finished, the same result the tool returns directly. Results are kept for 24 hours.list_jobsandcancel_jobdo what they say.manage_market_studysaves a study you built,list_market_studieslists them, andrun_saved_market_studyreruns one with a new date range.
curl https://compute.profitabul.ai/v1/tools/submit_job \
-H "Authorization: Bearer $PROFITABUL_API_KEY" \
-H "Content-Type: application/json" \
-d '{"tool":"walk_forward","args":{"symbol":"ES","strategy_type":"breakout","total_days":365}}'Stream live quotes and the in-session snapshot into your own dashboard or script as Server-Sent Events. Any language with an HTTP client can read it.
curl -N "https://compute.profitabul.ai/v1/stream/market?symbols=ES,NQ" -H "Authorization: Bearer $PROFITABUL_API_KEY"quote: last, bid and ask whenever they change, checked every second.snapshot: session CVD, VWAP bands, POC, VAH and VAL, initial balance, opening range and bias every 5 seconds. Add&snapshot=falsefor quotes only.pingevery 15 seconds, andendafter 4 hours, when you reconnect.- Up to 6 symbols per stream and 2 open streams per account.
What it can do
Market data
Price history, orderflow bars with footprint, CVD and VWAP, time and sales, live snapshot
Levels and positioning
Key levels, options GEX levels and positioning, market context, signals, confluence
Reports and statistics
Every report on the Reports page (initial balance, opening range, gaps, sessions, volume profile, options positioning, your own trading reports and more) with the same settings, an edge scan that ranks every outcome for a symbol, plus statistics and a daily summary
Research
Market studies, pattern and regime detection, session comparison, economic calendar
Backtesting
Strategy and custom-signal backtests, parameter sweeps, walk-forward, portfolio and Monte Carlo tests
Your account
Journal (log, list, analyze), paper trading, alert conditions and timers, risk settings
Things to ask
- “What are today’s key levels and GEX walls for NQ, and where is price relative to them?”
- “Pull the last 6 months of 5-minute orderflow bars for GC and tell me how often a CVD divergence at the session high led to a 20-point drop.”
- “Run the initial balance report for ES over the last year and summarize breakout and hold rates by weekday.”
- “Backtest an opening range breakout on NQ with a 15-minute range, then run a walk-forward test on the best settings.”
- “Review my journal for the last 30 days and tell me which setups and times of day are costing me money.”
Limits
- 120 requests a minute per account. Every response carries
RateLimit-Limit,RateLimit-RemainingandRateLimit-Reset. - 1,000,000 bars a day of price history and orderflow bars (a bar with its footprint ladder counts as 10).
- 1,000,000 time and sales rows a day.
- Summaries, levels, reports, statistics and backtests do not count against the daily allowances.
- Allowances are per account across all keys and sessions, and reset at 00:00 UTC.
retry_after_sec. Well-behaved agents wait that long and carry on.- UNAUTHORIZED (401) — Sign in again, or check that your API key is current and your subscription is active.
- RATE_LIMITED (429) — More than 120 requests in a minute. Wait for Retry-After (or retry_after_sec) and continue.
- DAILY_DATA_BUDGET_EXCEEDED — Today’s bar or time and sales allowance is used up. It resets at 00:00 UTC; summaries and analytics keep working.
- UPGRADE_REQUIRED — That tool or report is part of a different plan than yours.
- RANGE_TOO_LARGE / INVALID_TIME_RANGE — Narrow the requested window; the message says the maximum.
- Sign-in window loops or closes — remove the connector, add it again, and finish the Profitabul sign-in in the same browser.
- Still stuck? Email support@profitabul.com.
Access is for your own use under your subscription: your research, your tools, your agents. Data may not be redistributed, resold, shown to other people, or used to power another product or service, and keys may not be shared.
Your assistant sends Profitabul only the tool requests it makes; we do not receive your conversations. See the privacy policy for what we store and for how long.