Place MT5 order
place_mt5_orderQueue a real order on the user's live MT5 account through the MT5 Bridge EA. REAL MONEY: only call this after the user has explicitly approved the exact symbol, direction, volume, entry, stop loss and take profit. Never place orders on your own initiative. If the result is needs_confirmation, show every warning to the user and only retry with those keys in acknowledgeWarnings if the user says to place it anyway. Market orders expire if the EA does not pick them up within ~20s; check get_my_mt5_account for the result. For market orders, prefer slDistance/tpDistance (SL/TP as a distance from the real fill) over absolute stopLoss/takeProfit — the server re-anchors them to the actual fill price so quote-vs-fill slippage can't skew your risk. Requires a personal SocialForex API token. Create one at /mt5 (section "Connect an AI assistant (MCP)") and add it to the MCP client as header Authorization: Bearer sfmcp_....
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"symbol": "<symbol>",
"orderType": "<orderType>",
"volume": "<volume>"
},
"name": "place_mt5_order"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| price | No | Required for LIMIT/STOP orders, ignored for market | |
| symbol | Yes | Broker-neutral symbol, e.g. EURUSD, XAUUSD (EA maps suffixes) | |
| volume | Yes | Lots | |
| stopLoss | No | Absolute stop loss price. Omit if using slDistance, or a default (10% risk) is applied. | |
| orderType | Yes | BUY/SELL = market; *_LIMIT / *_STOP = pending at `price` | |
| slDistance | No | MARKET orders: SL as a PRICE DISTANCE from the real fill (e.g. 5 for $5 on gold, 0.0030 for 30 pips). The server re-anchors SL to the actual fill price — use this instead of stopLoss to avoid slippage skew. | |
| takeProfit | No | Absolute take profit price | |
| tpDistance | No | MARKET orders: TP as a PRICE DISTANCE from the real fill. Re-anchored like slDistance. | |
| acknowledgeWarnings | No | Warnings from a previous needs_confirmation result that the user chose to override |