Session and connection
Paper or live mode for the session, and the state of the connection.
get_mode
Current session mode: "live" or "paper". Paper mode forces dry_run:true on every trading tool for this MCP session only (it resets to live on a new session). Available on every tier.
Capability: read · read-only · REST: POST /v1/tools/get_mode
No parameters.
Example request:
{}set_mode
Switch this session between "live" and "paper". In paper mode every trading call is forced to dry_run:true and responses carry mode_clamped:true. This is not a simulated account (see simulated connections). Available on every tier.
Capability: read · read-only · REST: POST /v1/tools/set_mode
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
mode | live | paper | yes | — |
Example request:
{
"mode": "live"
}list_connections
Describes the connection this access token is bound to {connection_id, label, exchange, mode, market_types, status}. A token is bound to exactly one connection; other connections are not visible. Available on every tier.
Capability: read · read-only · REST: POST /v1/tools/list_connections
No parameters.
Example request:
{}get_connection_info
The session's exchange connection: mode, market types, position mode, leverage cap, permissions (withdraw is always false), capability matrix, clock skew, rate-limit budget, protection health. Available on every tier.
Capability: read · read-only · REST: POST /v1/tools/get_connection_info
No parameters.
Example request:
{}get_connection_log
Recent adapter events (rejects, reconciles, protection restores, rate-limit trips, permission re-validation). Secrets are scrubbed. Available on every tier.
Capability: read · read-only · REST: POST /v1/tools/get_connection_log
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
count | integer | no | 100 | |
level | info | warn | error | no | — |
Example request:
{}