Troubleshooting

Most issues come down to the connection between your AI client and the MCP server. Start here before contacting support.

The basics

• Make sure you’ve connected your AI client to the NinjaTrader MCP server. See Connect Your AI Agent.
• If something isn’t working, disconnect and reconnect the MCP server in your client. This re-runs authorization and starts a fresh session, which resolves most problems.
• For client-specific issues, follow your AI platform’s documentation for inspecting and debugging MCP connections. Most clients can show the NinjaTrader server’s connection status and which tools it exposes.
• If your agent reports an error that’s clearly on the NinjaTrader side, contact support.

Common Issues

No tools appear / the agent can’t see NinjaTrader

The client isn’t connected, or the session never completed authorization. Reconnect the server and finish the sign-in in a desktop browser. After connecting, you should see tools such as my_portfolio, search_contracts, market_snapshot, and place_order.

”Account not found”

You’re almost certainly crossing environments. A Demo account exists only on the Demo server and a Live account only on the Live server. Make sure your agent is using the right environment URL for the account you named, and keep each conversation on a single environment. See Environments.

The agent stopped working after a while

Sessions expire after a period of inactivity. Reconnect the server in your client to start a new session. See Sessions.

The server denies a specific tool

A tool fails while others keep working when your account lacks the access that tool requires. For example, an account without trading permission can read data but can’t place_order. Check your account’s permissions and see Permissions and Scopes.

The agent says it can’t see your risk limits

Expected. The server enforces the connection’s risk limits from the consent screen on every opening order, but no tool returns them—risk_settings covers account-level settings only. Your agent notices a limit only when an order would exceed it, through the estimate_order or place_order error that names the limit and the current value. To review or change the configured values, open your authorized-apps settings.

The server throttles your calls

If your agent makes rapid repeated calls it can hit a tool’s rate limit and receive a short time penalty. Have it slow down and retry. Normal use rarely reaches these limits.

Orders aren’t behaving as expected

If a bracket’s profit target or stop seems to land at the wrong price, remember that place_order treats bracket legs as signed offsets from the entry’s working price, not absolute prices. Ask your agent to describe(topic='place_order_examples'). See the bracket warning.

Getting help

If you’ve confirmed your client’s connection and the issue is on the NinjaTrader side, contact support.