MCP Tool Reference Index
This is the master index of CrossTrade MCP tools. Each row links to the dedicated tool page with parameters, response shapes, examples, common errors, and safe placement in an agent loop.
Permission legend:
- 📖
mcp:read - 📝
mcp:trade
For deeper grouping with prose, see Core Tools, Tradovate Tools, NinjaScript and Strategies, Backtesting and Optimization, Platform Tools, and Journal and Diagnostics.
Discovery and capability
| Tool | Scope | Use case |
|---|---|---|
GetMcpCapabilities | 📖 | First call. Confirms add-on version, backtest engine, and features. |
McpSelfTest | 📖 | Verifies transport and tool categories. |
Accounts and connections
| Tool | Scope | Use case |
|---|---|---|
ListAccounts | 📖 | Enumerate accounts visible to the user. |
GetConnections | 📖 | Connection state per account. |
GetAccountSummary | 📖 | Realized and unrealized P&L summary. |
GetWatermarks | 📖 | Daily highs and lows used by drawdown rules. |
GetAccount | 📖 | Single-account read by id. |
Positions and orders
| Tool | Scope | Use case |
|---|---|---|
ListPositions | 📖 | Current positions per account. |
GetAllPositions | 📖 | Same shape, includes all accounts. |
GetPosition | 📖 | Single-instrument read. |
ListOrders | 📖 | Current working and historical orders. |
GetAllOrders | 📖 | All accounts. |
GetOrder | 📖 | Single order by id. |
GetOrderStatus | 📖 | Quick state probe. |
ListExecutions | 📖 | Fill history. |
GetExecutionsByOrderId | 📖 | Fills for a specific order. |
PlaceOrder | 📝 | Place a market, limit, stop, or stop-limit. |
CancelOrder | 📝 | Cancel one order by id. |
Cancel | 📝 | Cancel a single order (alias of CancelOrder shape in some clients). |
CancelOrders | 📝 | Cancel a list of orders. |
CancelAllOrders | 📝 | Cancel everything for an account. |
CancelAndBracket | 📝 | Cancel and re-issue with bracket. |
CancelReplace | 📝 | Cancel a working order and place a replacement. |
Change | 📝 | Modify an open order. |
FlatPlace | 📝 | Flatten then place. |
FlattenEverything | 📝 | Closes all positions in the named account. |
Flatten | 📝 | Flatten a specific position. |
ClosePosition | 📝 | Same shape as Flatten per instrument. |
Reverse / ReversePosition | 📝 | Reverse the current direction. |
Market data
| Tool | Scope | Use case |
|---|---|---|
GetQuote | 📖 | Bid, ask, last, time. |
GetBars | 📖 | OHLC bars by instrument and resolution. |
MarketInfo | 📖 | Static instrument metadata. |
GetVolumeProfile | 📖 | TPO or volume profile. |
GetOrderFlow | 📖 | Footprint / order flow. |
GetIndicatorValue | 📖 | Resolves an indicator value from the running NT8 instance. |
Journal and diagnostics
| Tool | Scope | Use case |
|---|---|---|
GetWebhookSignals | 📖 | Webhook signal history. |
GetAddonActivity | 📖 | CrossTrade Add-On activity log. |
GetJournal | 📖 | Matched-trade journal. |
GetJournalTrades | 📖 | Lower-level journal accessor. |
GetActivityLog | 📖 | Add-on activity entries (alias). |
GetSignalHistory | 📖 | TradingView webhook signal alias. |
NinjaScript
| Tool | Scope | Use case |
|---|---|---|
GetNinjaScriptHelp | 📖 | Help text for an NT8 symbol or topic. |
SearchNinjaScriptSymbols | 📖 | Search NT8 type and member names. |
LookupNinjaScriptSymbol | 📖 | Resolve a single symbol. |
ListNinjaScriptFiles | 📖 | List files in the NT8 user directory. |
ReadNinjaScriptFile | 📖 | Read a NinjaScript file. |
ListCompiledSnippets | 📖 | Inspect compiled snippets in memory. |
CompileNinjaScript | 📝 | Compile NinjaScript in memory or against disk. |
WriteNinjaScriptFile | 📝 | Write a NinjaScript file. |
DeleteCompiledSnippet | 📝 | Remove an in-memory compiled snippet. |
Backtesting and optimization
| Tool | Scope | Use case |
|---|---|---|
RunStrategyBacktest | 📝 | Drive NT8 Strategy Analyzer. |
RunBacktest | 📝 | Lower-level backtest entry point. |
GetBacktestResult | 📖 | Read a completed backtest. |
GetCompileResult | 📖 | Read a compile job result. |
GetMcpJob | 📖 | Job status for async work. |
ListMcpJobs | 📖 | Recent jobs. |
CancelMcpJob | 📝 | Cancel a running job. |
Deployment and strategy lifecycle
| Tool | Scope | Use case |
|---|---|---|
DeployStrategy | 📝 | Deploy a compiled strategy. |
ListDeployedStrategies | 📖 | Enumerate deployed strategies. |
GetDeployedStrategyState | 📖 | Live strategy state. |
StopStrategy | 📝 | Stop a deployed strategy. |
CloseStrategy | 📝 | Close a strategy (alias for stop in some contexts). |
StartStrategy | 📝 | Start a previously stopped strategy. |
EnableStrategy / DisableStrategy | 📝 | Toggle strategy enablement. Do not use on chart-attached strategies. |
GetStrategy / GetStrategyState / ListStrategies / ListAllStrategies | 📖 | Read NT8 strategy state. |
Alerts
| Tool | Scope | Use case |
|---|---|---|
EmitMcpAlert | 📝 | Relay an alert through the user's channels. |
CreateAlert / RemoveAlert | 📝 | Manage configured alerts. |
ListAlerts | 📖 | List configured alerts. |
Charts and drawings
| Tool | Scope | Use case |
|---|---|---|
OpenChart | 📝 | Open or reopen a chart. |
AddDrawing / RemoveDrawing | 📝 | Drawing CRUD. |
ListDrawings | 📖 | List drawings on a chart. |
SaveWorkspace / LoadWorkspace | 📝 | Workspace persistence. |
ListWorkspaces | 📖 | Workspace inventory. |
Connection control
| Tool | Scope | Use case |
|---|---|---|
Connect / Disconnect | 📝 | Manage NT8 connections programmatically. Use sparingly. |
EnsureReplayConnection | 📝 | Ensure replay is up before a replay-only task. |
Reflection and reporting
| Tool | Scope | Use case |
|---|---|---|
McpReflect | 📖 (admin gated) | Reflective inspection. Admin only; not part of the standard agent loop. |
SessionPerformance | 📖 | Session-level performance summary. |
Tradovate (linked account, no add-on)
The Tv_* tools operate on the user's linked Tradovate account server-side; NinjaTrader does not need to be running. Required arguments and examples for every tool live on the Tradovate Tools page.
| Tool | Scope | Use case |
|---|---|---|
Tv_Status | 📖 | Link status, identities, environments, token expiry. |
Tv_ListAccounts | 📖 | Linked Tradovate accounts. |
Tv_AccountSnapshot | 📖 | Balances, positions with P&L, and working orders in one call. |
Tv_GetAccount | 📖 | One account with its cash-balance snapshot. |
Tv_ListPositions / Tv_GetPosition | 📖 | Open positions; single-instrument net position. |
Tv_ListOrders / Tv_GetOrder / Tv_GetOrderLifecycle | 📖 | Orders, single-order reads, and the order audit trail. |
Tv_ListFills | 📖 | Fill history. |
Tv_CashBalances / Tv_MarginSnapshots | 📖 | Balance and margin rows. |
Tv_FindContract / Tv_SuggestContracts / Tv_ListExchanges | 📖 | Contract and exchange reference data. |
Tv_GetWatermarks | 📖 | Account Manager P&L high-water marks. |
Tv_PlaceOrder | 📝 | Place an order with optional OCO brackets or inline atm_* multibracket. |
Tv_FlatPlace | 📝 | Flatten then place in one command. |
Tv_CancelOrder / Tv_CancelOrders / Tv_CancelAllOrders | 📝 | Cancel one order, one account's orders, or everything. |
Tv_ChangeOrder | 📝 | Modify a working order in place. |
Tv_CancelReplace | 📝 | Cancel a working order and place a replacement. |
Tv_CancelAndBracket | 📝 | Cancel and attach a fresh OCO bracket to the live position. |
Tv_ClosePosition / Tv_Flatten / Tv_FlattenEverything | 📝 | Close or flatten positions, filtered or account-wide. |
Tv_Reverse / Tv_ReversePosition | 📝 | Reverse the current direction. |
Common safe-placement patterns
- Discovery first: always call
GetMcpCapabilitiesandMcpSelfTestbefore anything else in a new session. - State before action:
ListAccounts,GetConnections,ListPositions,ListOrders,GetAccountSummary,GetWatermarksbefore any write. - Compile before write:
CompileNinjaScript(in_memory: true)beforeWriteNinjaScriptFile. - Backtest before deploy:
RunStrategyBacktestbeforeDeployStrategy. - Verify after deploy:
GetDeployedStrategyStateafterDeployStrategy. - Confirm before order: explicit user confirmation before
PlaceOrder,Cancel*,Flatten*,Reverse*.