MCP

The tools an AI assistant can call over MCP, grouped into read-only data tools and trading tools that act on your account.

How it works

Connect your assistant to https://mcp.match-trader.com/mcp and give it a Trader API token, as described in the Introduction. The assistant then sees the tools below and picks the right one for whatever you ask it in plain language - you do not call them yourself.

Every tool works on your trading account, with exactly the permissions of the token you gave the assistant. With a read-only token, the assistant can use only the data tools - calling a trading tool returns an error.

Worth deciding before you connect: a token with trading rights lets an assistant place, modify, and close real orders on your account. If you want the assistant for analysis, monitoring, or reporting rather than execution, issue it a read-only token - you can always add a second, trading-capable token later and revoke it independently.

Data tools

These are read-only. They never change anything on your account.

• get_account - your account profile and settings.
• get_platform_details - your broker and the platform address for your account.
• get_account_summary - balance, equity, margin, and other financial figures of your account.
• get_portfolio_state - account summary, open positions, and pending orders in one call.
• get_symbols - available instruments, their trading parameters, and trading hours.
• get_quotes - current prices for one or more instruments.
• get_candles - price history of an instrument as candles.
• list_positions - your open positions.
• list_pending_orders - your pending orders.
• list_closed_positions - history of your closed positions.
• list_ledger - cash-flow entries booked on your account.

Trading tools

These act on your account. They require a token with trading rights on the resource in question.

• open_position - opens a position at the market price.
• modify_position - changes the take profit and stop loss of an open position.
• close_position - closes a position, fully or partially.
• create_pending_order - places a pending order.
• modify_pending_order - changes a pending order before it activates.
• cancel_pending_order - cancels a pending order.

Limits and behavior

Tool calls count toward your account's Trader API rate limits. Connecting an assistant does not add capacity, so an assistant that polls aggressively will hit the limits just as your integration would.