start_paper_trading MCP Tool

Back to MCP catalog

start_paper_trading

Deploy a compiled strategy on live market data with simulated fills and no real capital.

Area

Paper Trading

Group

Paper Trading

Access

Write

Risk

May change server state

Details

Full description

Deploy a strategy on live market data without real capital. The session processes live bars, simulates fills with the configured fee/slippage, and tracks PnL as if trading.

Prerequisites — the strategy must be compiled (builder_compile) and ideally validated via run_backtest + get_current_signal_state to confirm it isn't already firing on stale signals.

Params — initial_cash (default 100000), fee_pct (e.g. 0.05 = 0.05%), slippage_pct. The caller's email must be verified.

start_paper_trading(strategy_id)   # → session_id, status

Monitor with get_paper_trading_session.

Capabilities

Bounded options and operating modes surfaced above the full JSON schema.

Notification Channel options

notification_channel

allemailpush

Required Inputs

FieldTypeDescription

strategy_idstringStrategy identifier

Optional Inputs

FieldTypeDescription

alert_modebooleanStart this session in alert-only mode: notifies on entry fires instead of placing orders. The strategy's own exits/sizing/rebalance are compiled but inactive for this session — it is not mutated. Requires ALERT_MODE_ENABLED to be set.

fee_pctnumberTrading fee as percentage (0.1 = 0.1%)

initial_cashnumberInitial cash amount

notification_channelenum: all, email, pushAlert delivery preference for alert-mode sessions. 'all' sends to every enabled channel; 'email' sends only email; 'push' sends only registered push devices.

slippage_pctnumberSlippage as percentage (0.05 = 0.05%)