FxSocket is an MCP server published by com.fxsocket, hosted at mcp.fxsocket.com. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 8 tools, including list_accounts, get_account, get_open_positions, get_trade_history, search_symbols.
Read-only MetaTrader 4 and 5 accounts: balances, positions, trade history, quotes and candles.
1 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
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.
| Parameter | Type | Description |
|---|---|---|
| include_balances | boolean | Also read live balance, equity and floating profit from each account's terminal (one extra read per account, so slower). |
{
"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,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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, and in health.account.authError the broker's reason when it refused the login, e.g. Invalid account for a wrong password). 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.
| Parameter | Type | Description |
|---|---|---|
| account_id * | string | An account_id from list_accounts. |
{
"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, and in health.account.authError the broker's reason when it refused the login, e.g. Invalid account for a wrong password). 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",
"required": [
"account_id"
],
"properties": {
"account_id": {
"type": "string",
"format": "uuid",
"description": "An account_id from list_accounts."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Get account details",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| kind | string | position = filled trades, pending = resting limit/stop orders. |
| symbol | string | Only this instrument. Matches broker suffixes too, so EURUSD also matches EURUSD.sd and EURUSDm. |
| account_ids | array | Account ids from list_accounts. Omit to read every account this key can see. |
{
"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": {
"kind": {
"enum": [
"any",
"position",
"pending"
],
"type": "string",
"default": "any",
"description": "position = filled trades, pending = resting limit/stop orders."
},
"symbol": {
"type": "string",
"description": "Only this instrument. Matches broker suffixes too, so EURUSD also matches EURUSD.sd and EURUSDm."
},
"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."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Get open positions",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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. Each trade has its open and close price and time and the stop-loss and take-profit it closed with (sl, tp; 0 = not set, and always 0 on cTrader). For positions that are still open, use get_open_positions.
| Parameter | Type | Description |
|---|---|---|
| to | string | 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. |
| from | string | Start of the window. Date (YYYY-MM-DD) or ISO-8601 datetime, in the broker's server time. |
| symbol | string | Only this instrument. Matches broker suffixes too, so EURUSD also matches EURUSD.sd and EURUSDm. |
| account_ids | array | Account ids from list_accounts. Omit to read every account this key can see. |
{
"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. Each trade has its open and close price and time and the stop-loss and take-profit it closed with (sl, tp; 0 = not set, and always 0 on cTrader). For positions that are still open, use get_open_positions.",
"inputSchema": {
"type": "object",
"properties": {
"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."
},
"from": {
"type": "string",
"description": "Start of the window. 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."
},
"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."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Get closed trades",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Most names to return; truncated says whether more matched. |
| query | string | Case-insensitive substring, e.g. EUR or XAU. Omit to list all. |
| account_id * | string | An account_id from list_accounts. |
{
"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",
"required": [
"account_id"
],
"properties": {
"limit": {
"type": "integer",
"default": 100,
"maximum": 500,
"minimum": 1,
"description": "Most names to return; truncated says whether more matched."
},
"query": {
"type": "string",
"description": "Case-insensitive substring, e.g. EUR or XAU. Omit to list all."
},
"account_id": {
"type": "string",
"format": "uuid",
"description": "An account_id from list_accounts."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Search symbols",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| symbols * | array | Exact broker symbol names (see search_symbols). |
| account_id * | string | An account_id from list_accounts. |
{
"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",
"required": [
"account_id",
"symbols"
],
"properties": {
"symbols": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 20,
"minItems": 1,
"description": "Exact broker symbol names (see search_symbols)."
},
"account_id": {
"type": "string",
"format": "uuid",
"description": "An account_id from list_accounts."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Get live quotes",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| symbol * | string | Exact broker symbol name (see search_symbols). |
| account_id * | string | An account_id from list_accounts. |
{
"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",
"required": [
"account_id",
"symbol"
],
"properties": {
"symbol": {
"type": "string",
"description": "Exact broker symbol name (see search_symbols)."
},
"account_id": {
"type": "string",
"format": "uuid",
"description": "An account_id from list_accounts."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Get symbol specification",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| to | string | End of the window. Defaults to now. Date (YYYY-MM-DD) or ISO-8601 datetime, in the broker's server time. |
| from | string | Start of the window. Date (YYYY-MM-DD) or ISO-8601 datetime, in the broker's server time. |
| limit | integer | |
| symbol * | string | Exact broker symbol name (see search_symbols). |
| timeframe * | string | Bar size, M1 to MN1. The same nine on MT4, MT5 and cTrader. |
| account_id * | string | An account_id from list_accounts. |
{
"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",
"required": [
"account_id",
"symbol",
"timeframe"
],
"properties": {
"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."
},
"from": {
"type": "string",
"description": "Start of the window. Date (YYYY-MM-DD) or ISO-8601 datetime, in the broker's server time."
},
"limit": {
"type": "integer",
"default": 100,
"maximum": 500,
"minimum": 1
},
"symbol": {
"type": "string",
"description": "Exact broker symbol name (see search_symbols)."
},
"timeframe": {
"enum": [
"M1",
"M5",
"M15",
"M30",
"H1",
"H4",
"D1",
"W1",
"MN1"
],
"type": "string",
"description": "Bar size, M1 to MN1. The same nine on MT4, MT5 and cTrader."
},
"account_id": {
"type": "string",
"format": "uuid",
"description": "An account_id from list_accounts."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Get price history",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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. Start 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.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.