Configured tool · read-only

`list_accounts`

Read the destination account IDs and connection state available inside this workspace.

read-onlynon-destructiveclosed-world

Human and agent roles

Configured boundary

The workspace agent key scopes this read to one organization. The tool cannot discover or read accounts belonging to another workspace.

This reference describes a connection made with @postdom/mcp@0.3.0 and a workspace-scoped agent key created in Accounts.

Callable schema

Field names match the configured tool schema. Runtime-only constraints are labeled separately from schema validation.

FieldTypeContract

Synthetic values

Identifiers and values are examples. They do not represent a connected workspace or accepted media source.

EXAMPLE CALL · CONFIGURED TOOL SCHEMA

list_accounts({})

Observed API record

Returns the provider-backed accounts visible to the configured workspace.

accounts[].providerAccountIdstring: The exact destination ID accepted by account_ids in planning and publishing tools.
accounts[].platforminstagram | tiktok | youtube | linkedin | facebook | snapchat | twitter | threads | bluesky: The account's destination platform.
accounts[].handlestring | null: Provider handle when available.
accounts[].statusconnected | expired | disconnected: Current provider connection state.
accounts[].trust_levelinteger: Current human-selected autonomy level.
accounts[].pausedboolean: Whether execution is paused for this account.
accounts[].timezoneIANA timezone: Account timezone used to evaluate policy quiet hours; UTC is the fallback.
accounts[].autonomy_prompt_eligibleboolean: Whether the dashboard still offers its one-time autonomy-default decision for this account.

Stop conditions

connected

Pass providerAccountId to later tools; never substitute a handle or invent an ID.

empty

Call get_workspace_status before attempting connect_account.

expired or disconnected

The human must complete provider authorization; this tool neither requests nor carries social credentials.