Postdom

official

Schedule and publish social content to 9 platforms from an AI agent, with human approval and performance read-back.

What can you do with Postdom MCP?

  • Check workspace readiness — Ask the agent to run get_workspace_status to verify setup progress, connection availability, and account policy before taking action.

  • Connect destination accounts — Have the agent generate a platform authorization URL via connect_account for a human to complete OAuth, keeping credentials out of the agent.

  • Read brand guidance — Use get_brief to pull the current workspace-owned brand guidance before planning or writing any content.

  • Upload and verify media — Ask the agent to create a direct-upload contract with upload_media, then confirm the handle with get_media before publishing.

  • Propose or execute publishing — Submit a time-bounded plan via submit_plan for human approval, or use publish_video for immediate or UTC-scheduled execution.

  • Review outcomes and performance — Retrieve post states and destination results with get_publish, or rank posts by evidence-backed metrics using get_best_posts.

Hosted MCP Server

npx add-mcp 'https://api.postdom.com/mcp'

Installs into Claude Code, Codex, Cursor and more

Documentation

Scheduling and measurement

Postdom coordinates AI-agent schedules, human authority, destination outcomes, and measurement evidence for short-form video.

The public MCP package connects an agent to one workspace and gives finished video a direct, workspace-scoped upload path.

Connect one workspace

Create a workspace key in Accounts. Postdom shows the exact pinned MCP configuration once. The public package requires Node.js 22 or newer.

  1. CREATE Workspace key Owners, admins and members create or revoke keys in the authenticated Accounts screen.
  2. PASTE npx -y @postdom/mcp@0.4.0 Run it with Node.js 22 or newer. Use the generated API URL and key; keep the full configuration out of chat and source control.
  3. CHECK get_workspace_status The agent reads setup progress and the exact connection gate before taking action.
  4. AUTHORIZE connect_account The agent returns a platform URL. A human completes OAuth and keeps social credentials out of the agent.
  5. READ get_brief The agent reads the current Workspace Brief before planning or writing.
  6. UPLOAD upload_media Finished bytes go directly to Postdom-owned storage, then get_media verifies the handle.

Operating loop

Scheduling is the system of record. Publishing is one execution step inside that schedule.

  1. 01

    Schedule

    The agent reads account policy, then publishes directly or proposes a bounded plan when review is required.
  2. 02

    Human boundary

    Humans approve plans, set trust and policy, pause activity, and resolve exceptions.
  3. 03

    Destination outcomes

    Postdom preserves the exact post state and each destination's queued, sent, published, or failed result.
  4. 04

    Measurement

    Every modeled field has an availability state. Never and unverified values return null with an explicit reason.

Configured tools

16 tools define the current MCP surface. Workspace owners create agent keys in Accounts, then paste the generated configuration into their agent.

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

list_accounts List destination account IDs and connection state, synchronizing provider state into Postdom for this workspace.

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

get_brief Read the current workspace-owned brand guidance before planning or writing content.

get_digest Read the latest completed workspace week as descriptive evidence.

get_learning Read shared account learning: source-linked observations and exploratory advice for one learning scope.

upload_media Create a short-lived direct-upload contract for finished video bytes.

get_media Verify one uploaded media handle before publishing it.

submit_plan Propose a time-bounded publication plan for one human approval.

get_plan Read the current plan state and structured feedback from the human reviewer.

publish_video Submit finished media for immediate or UTC-scheduled execution using the current-source publish_video contract.

get_publish Read one post state, every destination outcome, and structured approval feedback.

list_posts List this workspace's posts to answer what is scheduled without already holding a post ID.

get_performance Read normalized measurements for one post or one connected account.

get_best_posts Rank one account's posts by one evidence-backed metric over a requested window.

create_slideshow Render carousel slides on the workspace brand kit from words and images, and store each slide as image media.

Inspect fields and boundaries

Authority boundary

Agent credentials cannot exercise human approval routes. Humans connect destination accounts from the authenticated Accounts screen when connection is enabled for their workspace.

Human supervisor

Sets the boundary

Approves plans, sets trust and policy, pauses activity, and resolves exceptions.

AI agent

Works inside it

Proposes plans, submits supported work, reads exact states, and retrieves measurements.

Required handoff

Returns uncertainty

The agent preserves exact failed, missed, rejected, or revision states instead of inventing a successful outcome.

Reference for each destination

What each destination documents, what Postdom sends it, and which of its numbers are verified. Only pages that exist are listed.

TikTok

Instagram Reels

YouTube Shorts

LinkedIn

Facebook Reels

X

  • X character limit What each kind of character costs against the ceiling, and where Postdom's check is the more permissive of the two.

Threads

  • Threads character limit Which figure governs a post's text and which governs a long-form attachment, and what Postdom enforces.

Bluesky

Setup reality

Workspace creation uses an email link. Agent keys and the pinned MCP configuration live in Accounts; finished video uploads directly through the short-lived workspace-scoped contract.

See every current limitation