Trading via the local MCP server¶

This guide covers basic tools and prompt examples for placing, managing and closing trades through the cTrader local MCP server.

Warning

An AI agent can execute real trades in cTrader. You can configure the local MCP server to request confirmation for every trading operation.

Tip

When starting a new session with your AI agent, begin your prompt with Using the cTrader local MCP server.... This helps ensure that the agent calls the MCP server instead of routing requests to web search.

Place orders¶

Market order¶

Buy 1 lot of EURUSD at market.

Sell 0.5 lots of GBPUSD at market price.

i

Limit order¶

Place a limit buy on EURUSD at 1.1200 for 1 lot.

Stop order¶

Place a sell stop on EURUSD at 1.1100 for 1 lot.

Stop-limit order¶

Place a buy stop-limit on EURUSD: trigger at 1.1250, 
limit at 1.1255, for 1 lot.

i

Stop loss and take profit¶

Buy 1 lot of EURUSD at market with a stop loss at 1.1150 
and take profit at 1.1300.

When placing an order, the MCP server takes stop loss and take profit as distances in pips, so the AI agent converts the prices you give into pips. When amending an open position, it takes prices directly.

Place a limit buy on GBPUSD at 1.3200 for 0.5 lots with a 
50-pip stop loss and 100-pip take profit.

i

Labels and comments¶

Buy 1 lot of EURUSD at market. Label it 'swing-trade' 
and add the comment 'Breakout entry'.

i

View positions¶

Show me all my open positions.

Show me the details of position 456789 including its 
related orders and deals.

Do I have any open positions on EURUSD?

Manage positions¶

Modify stop loss and take profit¶

Set the stop loss on position 456789 to 1.1100.

Move the take profit on position 456789 to 1.1400.

Remove the stop loss from position 456789.

Close positions¶

Full close¶

Close position 456789.

Partial close¶

Close half of position 456789.

Close 0.5 lots of position 456789.

Conditional close¶

Close all positions that are losing more than $500.

Close all EURUSD positions.

Manage pending orders¶

View orders¶

Show me all my pending orders.

Amend orders¶

Change the limit price on order 987654 to 1.1180 
and increase the volume to 2 lots.

Cancel orders¶

Cancel order 987654.

Cancel all my pending orders.

Volume reference¶

Volume is expressed in units of the base asset. For standard forex pairs, 1 lot equals 100,000 units. For metals, indices and crypto, lot sizes vary by symbol. The agent reads the correct size from the symbol details.

You say	Meaning
1 lot	100,000 units
0.1 lots	10,000 units
0.01 lots	1,000 units

Operation details

Market range cannot currently be set through the cTrader local MCP server. For stop-limit orders, place_stop_limit_order accepts an absolute limitPrice, not a limit range in pips.
Stop and stop-limit orders placed through the cTrader local MCP server support two trigger methods: trade (the default) and opposite. Choose the method when placing the order; it cannot be changed later, and MCP order lists do not show it. A pending order can also be given an optional expiry (good till date) when it is placed, or one can be added, changed or removed afterwards. Without an expiry, the order stays open until it is filled or cancelled.
cTrader MCP servers support single stop-loss and take-profit levels. Trailing stop loss, break-even protection and multiple take-profit levels are currently unavailable for AI-assisted flows.
AI agents can set and read labels and comments when placing orders through cTrader MCP servers and listing positions and pending orders, but cannot change either field afterwards. In Trade Watch of cTrader Windows and Mac, enable the Label and Comment columns to make information added by AI agents visible.

Warning

The MCP server is a tool for AI-assisted trading and does not provide financial, investment, legal or tax advice. AI-generated actions may trigger real trades and result in losses. Users are solely responsible for verifying outputs, supervising strategies, securing credentials and using the MCP server at their own risk.