> Discover all available Postdom documentation from the machine-readable index: https://postdom.com/llms.txt

Configured tool · read-only

# `get_workspace_status`

Start here to read setup progress, connection availability, accounts, policy, brief, and activity counts.

read-only · non-destructive · closed-world

Human and agent roles

## Configured boundary

### Configured workspace

This tool observes only the workspace identified by the configured agent key. It cannot unlock connections, change policy, or create credentials.

This reference describes the hosted server at https://api.postdom.com/mcp, which runs current source, with a workspace-scoped key created under Connected apps → For developers. The published `@postdom/mcp@0.4.0` package has 14 of these tools: it lacks list_posts, create_slideshow, account_music and the media array.

Callable schema

## Input fields

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

 Field  Type  Contract

**For AI agents:** Send only fields exposed by the current tool schema.

**Known failure:** Do not invent platform settings, account IDs, media fields, or setup steps.

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_

```
get_workspace_status({})
```

Observed API record

## Return shape

Returns an org-scoped setup snapshot and the exact connection gate the agent must respect.

**`accounts[]` (account status[])** — Connected destination IDs, platform, health, pause state, trust level, and bounded policy.

**`brief.version` (integer | null)** — Current Workspace Brief version, or null when unavailable.

**`counts.plans` (integer)** — Plans stored in this workspace.

**`counts.posts` (integer)** — Posts stored in this workspace.

**`connect_gate.state` (unlocked | locked | globally_paused)** — The exact connection-availability state.

**`connect_gate.enabled` (boolean)** — Whether connect_account may be attempted now.

**`connect_gate.detail` (string)** — Human-readable handoff detail preserved from the API.

Stop conditions

## Agent handoff

`unlocked`

### Inspect accounts

Call list_accounts. Use connect_account only when the requested destination is missing.

`locked`

### Ask the human

Return connect_gate.detail exactly. The agent cannot unlock its own workspace.

`globally_paused`

### Stop setup

Connection creation is globally paused. Do not retry around the gate.

 VERIFIED · 26 AUGUST 2026  **GET /v1/workspace/status · get_workspace_status MCP registration**

Examples are synthetic. Human workspace-key creation and revocation remain in Postdom under Connected apps → For developers.