{"$schema": "https://static.modelcontextprotocol.io/schemas/v1/server-card.schema.json", "name": "com.fxsocket/mcp", "version": "1.0.0", "description": "Read-only MT4, MT5 and cTrader accounts: balances, positions, trade history, quotes and candles.", "title": "FxSocket", "websiteUrl": "https://fxsocket.com/docs/mcp", "icons": [{"src": "https://fxsocket.com/icon-512.png", "mimeType": "image/png", "sizes": ["512x512"]}], "remotes": [{"type": "streamable-http", "url": "https://mcp.fxsocket.com/mcp", "headers": [{"name": "X-API-Key", "description": "FxSocket API key, needed for tool calls. A read-only key (fxs_ro_...) is enough: https://app.fxsocket.com/dashboard/api-key", "isRequired": true, "isSecret": true}], "supportedProtocolVersions": ["2026-07-28", "2025-11-25", "2025-06-18", "2025-03-26"]}], "serverInfo": {"name": "fxsocket", "title": "FxSocket", "version": "1.0.0", "description": "Read-only access to MetaTrader 4, MetaTrader 5 and cTrader accounts connected to FxSocket: balances, positions, trade history, quotes, symbol specs and candles.", "websiteUrl": "https://fxsocket.com/docs/mcp", "icons": [{"src": "https://fxsocket.com/icon-512.png", "mimeType": "image/png", "sizes": ["512x512"]}]}, "authentication": {"required": true, "schemes": ["apiKey"]}, "instructions": "FxSocket gives read-only access to the MetaTrader 4, MetaTrader 5 and cTrader trading accounts linked to this API key: balances, open positions, closed trades, quotes, symbol specifications and price history. It cannot place, modify or close orders.\n\nStart with list_accounts to get account ids. Symbol names are broker-specific (EURUSD at one broker, EURUSD.sd or EURUSDm at another), so look them up with search_symbols before asking for quotes or candles. Money is in each account's deposit currency: never add amounts across currencies, use the totals_by_currency the tools return. Times and date filters are in the broker's server time, not UTC.", "tools": [{"name": "list_accounts", "title": "List trading accounts", "description": "Every MT4, MT5 and cTrader account linked to this API key: id, nickname, platform, broker server, login and connection status (connected / connecting / disconnected / error). Call this first: the other tools take its account_id values. Set include_balances to also read each account's live balance, equity and floating profit from its terminal, plus totals per currency; that reads at most 50 accounts, and one that cannot be read gets a balance_error instead of failing the call. For one account's margin, leverage and settings, use get_account instead.", "inputSchema": {"type": "object", "properties": {"include_balances": {"type": "boolean", "default": false, "description": "Also read live balance, equity and floating profit from each account's terminal (one extra read per account, so slower)."}}, "additionalProperties": false}, "annotations": {"title": "List trading accounts", "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false}}, {"name": "get_account", "title": "Get account details", "description": "One account in full, read live from its terminal: financials (balance, equity, margin, free margin, margin level, leverage, currency), account settings (margin mode, stop-out level, whether trading is allowed) and terminal health (broker connection, login state). Takes one account_id from list_accounts; if part of the read fails, the rest is still returned and the failure is listed under errors. For balance and equity across several accounts at once, use list_accounts with include_balances; for positions, use get_open_positions.", "inputSchema": {"type": "object", "properties": {"account_id": {"type": "string", "format": "uuid", "description": "An account_id from list_accounts."}}, "additionalProperties": false, "required": ["account_id"]}, "annotations": {"title": "Get account details", "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false}}, {"name": "get_open_positions", "title": "Get open positions", "description": "Open positions and pending orders on one or more accounts, newest first, with per-account counts, floating profit and swap, and totals per currency. Lists at most 300 orders across all accounts; counts and totals always cover everything. Narrow it with symbol (EURUSD also matches EURUSD.sd) and kind (position or pending); omit account_ids to read every account. Only what is open now: for closed trades, win rate or realised profit, use get_trade_history.", "inputSchema": {"type": "object", "properties": {"account_ids": {"type": "array", "items": {"type": "string", "format": "uuid"}, "minItems": 1, "description": "Account ids from list_accounts. Omit to read every account this key can see."}, "symbol": {"type": "string", "description": "Only this instrument. Matches broker suffixes too, so EURUSD also matches EURUSD.sd and EURUSDm."}, "kind": {"type": "string", "enum": ["any", "position", "pending"], "default": "any", "description": "position = filled trades, pending = resting limit/stop orders."}}, "additionalProperties": false}, "annotations": {"title": "Get open positions", "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false}}, {"name": "get_trade_history", "title": "Get closed trades", "description": "Closed positions (one row per round trip) on one or more accounts, with per-account stats: trade count, wins, losses, win rate, net profit after commission and swap, best and worst trade, and a per-symbol breakdown. Defaults to the last 7 days; the window can be up to 366 days. Lists at most 300 trades across all accounts, newest first; the stats always cover the whole window. For positions that are still open, use get_open_positions.", "inputSchema": {"type": "object", "properties": {"account_ids": {"type": "array", "items": {"type": "string", "format": "uuid"}, "minItems": 1, "description": "Account ids from list_accounts. Omit to read every account this key can see."}, "from": {"type": "string", "description": "Start of the window. Date (YYYY-MM-DD) or ISO-8601 datetime, in the broker's server time."}, "to": {"type": "string", "description": "End of the window (a bare date includes that whole day). Defaults to now. Date (YYYY-MM-DD) or ISO-8601 datetime, in the broker's server time."}, "symbol": {"type": "string", "description": "Only this instrument. Matches broker suffixes too, so EURUSD also matches EURUSD.sd and EURUSDm."}}, "additionalProperties": false}, "annotations": {"title": "Get closed trades", "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false}}, {"name": "search_symbols", "title": "Search symbols", "description": "Find the exact symbol names an account's broker uses, by case-insensitive substring. Brokers spell instruments differently (EURUSD, EURUSD.sd, EURUSDm, XAUUSD.r), so look a name up here before calling get_quotes, get_symbol_info or get_price_history. Returns up to limit names (default 100) with how many matched and whether the list was cut; names only, one symbol's contract details come from get_symbol_info.", "inputSchema": {"type": "object", "properties": {"account_id": {"type": "string", "format": "uuid", "description": "An account_id from list_accounts."}, "query": {"type": "string", "description": "Case-insensitive substring, e.g. EUR or XAU. Omit to list all."}, "limit": {"type": "integer", "minimum": 1, "maximum": 500, "default": 100, "description": "Most names to return; truncated says whether more matched."}}, "additionalProperties": false, "required": ["account_id"]}, "annotations": {"title": "Search symbols", "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false}}, {"name": "get_quotes", "title": "Get live quotes", "description": "Latest bid, ask and spread for up to 20 symbols, read live from this account's terminal, so prices are the broker's own. A symbol the broker does not know is listed under errors while the others still return; if none resolve, the call fails. The current price only: for past prices use get_price_history, for contract size, swaps or sessions use get_symbol_info.", "inputSchema": {"type": "object", "properties": {"account_id": {"type": "string", "format": "uuid", "description": "An account_id from list_accounts."}, "symbols": {"type": "array", "items": {"type": "string"}, "minItems": 1, "maxItems": 20, "description": "Exact broker symbol names (see search_symbols)."}}, "additionalProperties": false, "required": ["account_id", "symbols"]}, "annotations": {"title": "Get live quotes", "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false}}, {"name": "get_symbol_info", "title": "Get symbol specification", "description": "Contract specification for one symbol at this account's broker, read live from its terminal: digits, contract size, tick size and value, minimum/maximum/step volume, stops level, current spread, swap rates, commissions and trading sessions. symbol must be the broker's exact name, so look it up with search_symbols first; an unknown symbol fails the call with the terminal's reason. For just the live bid and ask of several symbols, get_quotes is lighter.", "inputSchema": {"type": "object", "properties": {"account_id": {"type": "string", "format": "uuid", "description": "An account_id from list_accounts."}, "symbol": {"type": "string", "description": "Exact broker symbol name (see search_symbols)."}}, "additionalProperties": false, "required": ["account_id", "symbol"]}, "annotations": {"title": "Get symbol specification", "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false}}, {"name": "get_price_history", "title": "Get price history", "description": "OHLC candles for one symbol from this account's broker. Returns the most recent `limit` bars (default 100, max 500) in the window; omit from/to for the latest bars. A window spanning more than 20000 bars is refused (narrow it or pick a larger timeframe). For the current price only, use get_quotes.", "inputSchema": {"type": "object", "properties": {"account_id": {"type": "string", "format": "uuid", "description": "An account_id from list_accounts."}, "symbol": {"type": "string", "description": "Exact broker symbol name (see search_symbols)."}, "timeframe": {"type": "string", "enum": ["M1", "M5", "M15", "M30", "H1", "H4", "D1", "W1", "MN1"], "description": "Bar size, M1 to MN1. The same nine on MT4, MT5 and cTrader."}, "from": {"type": "string", "description": "Start of the window. Date (YYYY-MM-DD) or ISO-8601 datetime, in the broker's server time."}, "to": {"type": "string", "description": "End of the window. Defaults to now. Date (YYYY-MM-DD) or ISO-8601 datetime, in the broker's server time."}, "limit": {"type": "integer", "minimum": 1, "maximum": 500, "default": 100}}, "additionalProperties": false, "required": ["account_id", "symbol", "timeframe"]}, "annotations": {"title": "Get price history", "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false}}], "resources": [], "prompts": []}