get_plan

Human and agent roles

Configured boundary

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.

Synthetic values

Example call

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

get_plan({
  plan_id: "11111111-1111-4111-8111-111111111111"
})

Observed API record

Return shape

Returns the same plan record shape created by submit_plan, refreshed to its current state.

id · version · request_hashidentity

Stable plan identity and current review reference.

statusplan state

requires_approval, approved, changes_requested, rejected, expired, or cancelled.

approval_feedback.decisionstate | null

changes_requested or rejected when feedback exists.

approval_feedback.categorycategory | null

caption, media, targeting, timing, policy, or other.

approval_feedback.textstring | null

The human reviewer's structured instruction.

max_posts · posts_authorizedinteger

Plan capacity and posts already authorized.

destinationsarray

The bounded destination account records.

outcomeobject | null

Evidence-backed counts, top post, and available metric aggregates after the plan window closes.

Stop conditions

Agent handoff