# Postdom > Postdom is scheduling and measurement infrastructure for AI agents operating short-form video workflows. Publishing is an execution step inside the durable schedule. Humans set authority and handle exceptions. ## Start here - Homepage: https://postdom.com/ - Developer docs: https://postdom.com/docs.md - Current agent contract: https://postdom.com/agent-contract.md - Pricing: https://postdom.com/pricing.md - Create a workspace: https://app.postdom.com/signup - Human sign in: https://app.postdom.com/login - Public MCP package: npx -y @postdom/mcp@0.3.0 (requires Node.js 22 or newer) ## Supported destinations - TikTok - Instagram Reels - YouTube Shorts - LinkedIn - Facebook Reels - X - Snapchat Spotlight - Threads - Bluesky Measurement is available for TikTok, Instagram Reels, YouTube Shorts, Facebook Reels, and X. The other destinations publish and return per-destination outcomes, but every metric resolves to null with a stated reason rather than a number. ## Current configured-tool contract - get_workspace_status: start here to read setup progress, connection availability, accounts, policy, brief, and activity counts. - list_accounts: read connected destination IDs and current connection state inside the workspace. - connect_account: create a platform authorization URL for the human to complete when connections are 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, including populations, cadence endings, and coverage gaps. - upload_media: create a short-lived, workspace-scoped direct PUT contract for finished video bytes. - get_media: verify an uploaded media handle before publishing it. - submit_plan: propose bounded authority when the workspace uses plan-level review. - get_plan: read approval status and structured human feedback. - publish_video: submit finished media using the fields exposed by the connected schema, including an optional RFC 3339 UTC publish_at value ending in Z for exact-time scheduling. - get_publish: read publication and destination state. - get_performance: read normalized performance without converting unavailable values to zero. - get_best_posts: rank one account's posts by one evidence-backed metric while retaining explicit exclusion reasons for null values. ## Authority boundary - Humans create workspaces, approve plans, set trust, pause activity, and handle exceptions. - Humans can connect destination accounts from the authenticated workspace UI when connection is enabled for that workspace. - Humans create and revoke workspace-scoped agent keys in Accounts. Social authorization remains a human handoff. - Accounts shows the exact pinned MCP configuration when a human creates a workspace key. - Local video bytes upload directly to Postdom-owned storage through the short-lived URL returned by upload_media; bytes never transit MCP or the API process. - Agents may act only inside the connected credential and approved policy. - Agents must not approve themselves, expand trust, expose credentials, or invent tool arguments. ## Important limitations - The public MCP package is @postdom/mcp@0.3.0 and requires Node.js 22 or newer. Use the exact pinned configuration shown in Accounts; never type a workspace key into chat. - The generated configuration starts a local MCP server. ChatGPT project instructions do not connect it; live ChatGPT tools require a supported remote MCP connection. - Workspace-scoped keys, setup status, destination-ID discovery, authorization handoff, and direct media upload are available. - Agents must inspect the connected tool schemas. The configured publish_video contract accepts optional publish_at in RFC 3339 UTC ending in Z, but does not accept platform-settings fields. - Agents must never guess a timezone or claim an exact schedule when publish_at was omitted. - Platform measurement coverage varies. Every field retains an availability state. Never and unverified nulls retain a reason; other nulls may not. ## Canonical product loop 1. A human creates the workspace and one-time agent key, then pastes the exact MCP configuration shown in Accounts. 2. The agent calls get_workspace_status first and returns any locked connection gate to the human. 3. When unlocked, the agent may call connect_account for a human authorization handoff, then list_accounts to discover exact destination IDs. 4. The agent reads the Workspace Brief before planning or writing content. 5. Before planning, the agent reads the latest digest and the prior plan outcome when one exists. It treats both as descriptions of what happened, not recommendations. 6. The agent reads account policy. When plan-level review is required, it proposes a bounded plan and passes the returned brief version to submit_plan. 7. Any required human approval or structured feedback returns through plan state. 8. The agent calls upload_media when it needs Postdom-owned media storage, PUTs the exact bytes directly, and waits for get_media to return stored. 9. Finished media is executed inside account policy or the approved plan using exactly one video_url or media_handle. 10. The agent reads the exact post and destination states and hands recoverable or failed states to a human. 11. Measurements and availability states return to the agent. 12. When comparison is requested, the agent ranks only available account metrics and preserves every excluded post reason. ## Workflow concepts - Scheduling product overview: https://postdom.com/product/schedule.md - Runs and outcomes product overview: https://postdom.com/product/runs.md - Performance product overview: https://postdom.com/product/performance.md - Human authority product overview: https://postdom.com/product/policy.md - Canonical Postdom glossary: https://postdom.com/glossary.md - Human-supervisor solution: https://postdom.com/solutions/human-supervisors.md - Agency short-form operations: https://postdom.com/for/agencies - Social media API for SaaS platforms: https://postdom.com/for/saas-platforms - Instagram Reels destination overview: https://postdom.com/platforms/instagram-reels.md - About Postdom: https://postdom.com/about.md - Schedules and plans: https://postdom.com/docs/schedules-and-plans.md - Human authority: https://postdom.com/docs/human-authority.md - Runs and outcomes: https://postdom.com/docs/runs-and-outcomes.md - Measurement evidence: https://postdom.com/docs/measurement.md ## Configured tool reference - Tool overview: https://postdom.com/docs/tools.md - get_workspace_status: https://postdom.com/docs/tools/get-workspace-status.md - list_accounts: https://postdom.com/docs/tools/list-accounts.md - connect_account: https://postdom.com/docs/tools/connect-account.md - get_brief: https://postdom.com/docs/tools/get-brief.md - get_digest: https://postdom.com/docs/tools/get-digest.md - upload_media: https://postdom.com/docs/tools/upload-media.md - get_media: https://postdom.com/docs/tools/get-media.md - submit_plan: https://postdom.com/docs/tools/submit-plan.md - get_plan: https://postdom.com/docs/tools/get-plan.md - publish_video: https://postdom.com/docs/tools/publish-video.md - get_publish: https://postdom.com/docs/tools/get-publish.md - get_performance: https://postdom.com/docs/tools/get-performance.md - get_best_posts: https://postdom.com/docs/tools/get-best-posts.md ## State and limit reference - Errors: https://postdom.com/docs/reference/errors.md - Field limits: https://postdom.com/docs/reference/field-limits.md - Plan states: https://postdom.com/docs/reference/plan-states.md - Run states: https://postdom.com/docs/reference/run-states.md - Availability states: https://postdom.com/docs/reference/availability-states.md ## Configured-agent guidance - Operating brief: https://postdom.com/docs/agents/operating-brief.md - This guidance begins after a human creates a workspace key and pastes the generated MCP configuration. - Polling intervals are recommendations, not enforced tool behavior. ## Destination reference - How to schedule TikTok posts: https://postdom.com/guides/how-to-schedule-tiktok-posts - Does TikTok have an API?: https://postdom.com/platforms/tiktok/api-explained - TikTok aspect ratio and video requirements: https://postdom.com/platforms/tiktok/aspect-ratio-and-video-requirements - TikTok caption limit: https://postdom.com/platforms/tiktok/caption-limit - TikTok metrics availability: https://postdom.com/platforms/tiktok/metrics-api-availability - How to schedule Instagram Reels: https://postdom.com/guides/how-to-schedule-instagram-reels - Does Instagram have an API?: https://postdom.com/platforms/instagram-reels/api-explained - Instagram Reels caption limits: https://postdom.com/platforms/instagram-reels/caption-character-limits - Instagram Reels metrics availability: https://postdom.com/platforms/instagram-reels/metrics-api-availability - Instagram Reels size and dimensions: https://postdom.com/platforms/instagram-reels/reel-size-and-dimensions - How to schedule YouTube Shorts: https://postdom.com/guides/how-to-schedule-youtube-shorts - Does YouTube have an API?: https://postdom.com/platforms/youtube-shorts/api-explained - YouTube Shorts length and requirements: https://postdom.com/platforms/youtube-shorts/length-and-requirements - YouTube Shorts metrics availability: https://postdom.com/platforms/youtube-shorts/metrics-api-availability - YouTube title and description limits: https://postdom.com/platforms/youtube-shorts/title-and-description-limits - How to schedule LinkedIn posts: https://postdom.com/guides/how-to-schedule-linkedin-posts - Does LinkedIn have an API?: https://postdom.com/platforms/linkedin/api-explained - LinkedIn video specifications: https://postdom.com/platforms/linkedin/video-specifications - LinkedIn video requirements: https://postdom.com/platforms/linkedin/video-requirements - LinkedIn metrics availability: https://postdom.com/platforms/linkedin/metrics-api-availability - Facebook Reels video requirements: https://postdom.com/platforms/facebook-reels/video-requirements - Threads character limit: https://postdom.com/platforms/threads/character-limit - Bluesky character limit: https://postdom.com/platforms/bluesky/character-limit - TikTok: https://postdom.com/docs/destinations/tiktok.md - Instagram Reels: https://postdom.com/docs/destinations/instagram-reels.md - YouTube Shorts: https://postdom.com/docs/destinations/youtube-shorts.md - Metric availability: https://postdom.com/docs/destinations/metric-availability.md - Changelog: https://postdom.com/docs/reference/changelog.md This file is the canonical machine-readable product map. Confirm callable fields against the connected tool schemas before taking action.