Title99/100
List accounts
The title clearly communicates the tool’s action and subject. Keep it concise.
Description75/100
Your connected MetaTrader accounts, newest first.
The description explains the capability, when to use it, and what to expect.
Inputs75/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
limit
Items per page, 1 to 100 (default 50).
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
cursor
The `next_cursor` of the previous page. Leave it out for the first page.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
Annotations100/100
All four behavior hints are declared.
{
"title": "List accounts",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}Output schema84/100
The output schema explains the structured result.
View output schema
{
"type": "object",
"required": [
"object",
"data",
"has_more",
"next_cursor"
],
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"object",
"name",
"nickname",
"platform",
"server",
"login",
"credential_kind",
"can_trade",
"status",
"error",
"released",
"proxy_type",
"proxy_address",
"role",
"figures",
"created_at"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"examples": [
"6f1c2d4e-8a9b-4c3d-9e2f-1a2b3c4d5e6f"
],
"description": "The account's ID."
},
"name": {
"type": "string",
"examples": [
"Gold master"
],
"description": "Its nickname, or the platform and login."
},
"role": {
"enum": [
"master",
"follower",
null
],
"type": [
"string",
"null"
],
"description": "Whether a copier uses it, and how. An account is never both."
},
"error": {
"type": [
"string",
"null"
],
"description": "Why it's in `error` or `disconnected`, if known."
},
"login": {
"type": "integer",
"examples": [
51234567
],
"description": "The MetaTrader account number."
},
"object": {
"enum": [
"account"
],
"type": "string",
"description": "What this object is."
},
"server": {
"type": "string",
"examples": [
"ICMarketsSC-Demo"
],
"description": "The broker's server."
},
"status": {
"enum": [
"connecting",
"connected",
"error",
"disconnected"
],
"type": "string",
"description": "`connecting` while its terminal starts and logs in (two to three minutes), `connected` once it's ready, `error` when the login failed (see `error`), `disconnected` when its terminal lost the broker or was released."
},
"figures": {
"anyOf": [
{
"type": "object",
"required": [
"balance",
"equity",
"profit",
"margin",
"free_margin",
"margin_level",
"currency",
"open_positions",
"as_of",
"source"
],
"properties": {
"as_of": {
"type": "string",
"format": "date-time",
"examples": [
"2026-10-25T14:03:51.204Z"
],
"description": "When the terminal reported these figures."
},
"equity": {
"type": "number",
"examples": [
10250.5
]
},
"margin": {
"type": "number",
"examples": [
400
]
},
"profit": {
"type": "number",
"examples": [
250.5
],
"description": "Floating profit or loss of the open positions."
},
"source": {
"enum": [
"live",
"snapshot"
],
"type": "string",
"description": "`live`: streamed by the copier engine, at most 30 seconds old. `snapshot`: the last stored snapshot, taken every few minutes."
},
"balance": {
"type": "number",
"examples": [
10000
]
},
"currency": {
"type": "string",
"examples": [
"USD"
],
"description": "As the broker reports it: usually ISO 4217, but also codes such as `USC` (US cents) or `USDT`."
},
"free_margin": {
"type": "number",
"examples": [
9850.5
]
},
"margin_level": {
"type": [
"number",
"null"
],
"description": "In percent; null while no margin is used."
},
"open_positions": {
"type": "integer",
"examples": [
2
]
}
},
"description": "The account's freshest figures."
},
{
"type": "null"
}
]
},
"nickname": {
"type": "string",
"examples": [
"Gold master"
],
"description": "Empty when none was given."
},
"platform": {
"enum": [
"mt4",
"mt5"
],
"type": "string"
},
"released": {
"type": "boolean",
"description": "Its terminal was released after the subscription lapsed. The account and its history are kept: reconnect it to resume."
},
"can_trade": {
"type": "boolean",
"description": "Whether it can place trades, so it can be a follower. Any account can be a master."
},
"created_at": {
"type": "string",
"format": "date-time",
"examples": [
"2026-10-25T14:03:51.204Z"
]
},
"proxy_type": {
"enum": [
"socks5",
"socks4",
"http",
null
],
"type": [
"string",
"null"
],
"description": "The proxy's protocol; null without one."
},
"proxy_address": {
"type": [
"string",
"null"
],
"examples": [
"198.51.100.10:1080"
],
"description": "The proxy its terminal reaches the broker through, as `host:port`; null for a direct connection."
},
"credential_kind": {
"enum": [
"investor",
"master"
],
"type": "string",
"description": "Which password it was connected with: `master` can trade, `investor` only reads."
}
},
"description": "A MetaTrader 4 or 5 account, connected through its own hosted terminal."
},
"description": "Newest first."
},
"object": {
"enum": [
"list"
],
"type": "string",
"description": "Always `list`."
},
"has_more": {
"type": "boolean",
"description": "Whether there's another page: pass `next_cursor` as `cursor`."
},
"next_cursor": {
"type": [
"string",
"null"
],
"description": "The cursor of the next page; null on the last one."
}
}
}