Configured tool · write

`connect_account`

Create a platform authorization URL for a human to complete when the workspace connection gate is unlocked.

writenon-destructiveopen-world

Human and agent roles

Configured boundary

Configured workspace

This tool initiates a handoff only. It cannot authorize a social account, enter credentials, unlock the workspace gate, or connect another organization's profile.

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

Callable schema

Input fields

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

FieldTypeContract

platformRequired

enum

the eight destinations that authorize by redirect

The destination platform the human intends to authorize. Bluesky is deliberately absent: it authorizes with an app password rather than a redirect, so there is no URL for this tool to return and a human connects it in the dashboard instead.

Synthetic values

Example call

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

EXAMPLE CALL · CONFIGURED TOOL SCHEMA

connect_account({
  platform: "instagram"
})

Configured behavior

When you connect

The same claims the dashboard shows beside Connect. They are derived from the connect mechanism map, not written a second time here.

WILL

Will

Publish the video you supply, under the policy you set.

WILL NOT

Will not

Store a platform password for OAuth — you sign in on the destination. Bluesky uses an app password once to connect and does not keep it.

YOU CAN

You can

Revoke the connection anytime.

Observed API record

Return shape

Returns a provider authorization URL whose completion belongs to the human.

connect_urlURL: Open this URL for the human; never request or enter their social credentials.

Stop conditions

Agent handoff

connect_url returned

Give the URL to the human

Wait for the human to finish authorization, then poll list_accounts for the connected destination.

connect_disabled

Stop and report the gate

Do not attempt to unlock the workspace or route around the human-controlled gate.

supplier_spend_guard or account_cap_reached

Ask the human

Postdom intentionally stopped before adding supplier cost or exceeding the account cap.