> Discover all available Postdom documentation from the machine-readable index: https://postdom.com/llms.txt Developer docs · configured surface # 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. [Start agent setup](#agent-onboarding) [Read the agent contract](https://postdom.com/agent-contract) [Review availability](https://postdom.com/docs/availability) Agent onboarding ## Connect one workspace Create a workspace key in Connected apps → For developers. The hosted server at https://api.postdom.com/mcp needs no install; a key or MCP OAuth connects it. 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 under Connected apps → For developers. 2. CONNECT https://api.postdom.com/mcp The hosted server, with every tool; install lines for each client are at https://postdom.com/.well-known/mcp.json. The local npx -y @postdom/mcp@0.4.0 package (Node.js 22 or newer) lacks list_posts, create_slideshow, account_music and the media array. Keep the key 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. Core model ## 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. Callable schema ## Configured tools 17 tools define the current MCP surface. Workspace owners, admins and members create agent keys under Connected apps → For developers, 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 or image 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. `account_music` Read or set who adds the music on each connected account, and read where each handed-off video stands. [Inspect fields and boundaries](https://postdom.com/agent-contract) Supervision ## 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. Per-destination specifics ## 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 - How to schedule TikTok posts Choose a scheduling path and work through timing and troubleshooting. - Does TikTok have an API? Which TikTok API does which job, and what access each one needs. - TikTok aspect ratio and video requirements Every dimension fact with its classification and source. - TikTok caption limit The documented API caption length, and what it does not cover. - TikTok metrics availability Which performance fields Postdom can return, and which stay null. - TikTok caption checker Count your caption, tags and emoji, then see what to shorten. ### Instagram Reels - How to schedule Instagram Reels Compare Instagram, Business Suite, queue and agent workflows. - Does Instagram have an API? The Reels publishing path, and what each access level allows. - Instagram Reels caption limits The documented caption length for the publishing API. - Instagram Reels metrics availability Which insights fields Postdom can return, and which stay null. - Instagram Reels size and dimensions Every dimension fact with its classification and source. - Instagram post size Every Instagram size in one table: posts, slideshows, Stories and Reels. - Instagram caption checker Check your Reel caption length and decide what to trim. ### YouTube Shorts - How to schedule YouTube Shorts Choose a release time and understand each workflow's visibility. - Does YouTube have an API? The Shorts upload path, and what each access level allows. - YouTube Shorts length and requirements What qualifies as a Short, with each fact's classification. - YouTube Shorts metrics availability Which analytics fields Postdom can return, and which stay null. - YouTube title and description limits The documented title and description lengths for the upload API. - YouTube title checker Check your title length and find ways to shorten it. ### LinkedIn - How to schedule LinkedIn posts Use LinkedIn’s composer, a dashboard queue, or an agent, and check the result. - Does LinkedIn have an API? The Videos API, 3-legged OAuth, and why so little of it can be enforced. - LinkedIn video specifications File size, length, format and export guidance for sharing, Pages, API uploads and ads. - LinkedIn metrics availability Nine fields, every one unverified, each with its reason. ### Facebook Reels - Facebook Reels video requirements The Reels 3-to-90-second bound, kept on Reels, with what Postdom checks. ### 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 - Bluesky character limit Both caps the post lexicon declares, which one binds, and why the unit matters. Current boundary ## Setup reality Workspace creation uses an email link. Agent keys and the pinned MCP configuration live under Connected apps → For developers; finished video uploads directly through the short-lived workspace-scoped contract. [See every current limitation](https://postdom.com/docs/availability)