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.
Agent onboarding
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.
- CREATE
Workspace keyOwners and admins create or revoke keys in the authenticated Accounts screen.
- PASTE
npx -y @postdom/mcp@0.3.0Run it with Node.js 22 or newer. Use the generated API URL and key; keep the full configuration out of chat and source control.
- CHECK
get_workspace_statusThe agent reads setup progress and the exact connection gate before taking action.
- AUTHORIZE
connect_accountThe agent returns a platform URL. A human completes OAuth and keeps social credentials out of the agent.
- READ
get_briefThe agent reads the current Workspace Brief before planning or writing.
- UPLOAD
upload_mediaFinished 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.
- 01
Schedule
The agent reads account policy, then publishes directly or proposes a bounded plan when review is required.
- 02
Human boundary
Humans approve plans, set trust and policy, pause activity, and resolve exceptions.
- 03
Destination outcomes
Postdom preserves the exact post state and each destination's queued, sent, published, or failed result.
- 04
Measurement
Every modeled field has an availability state. Never and unverified values return null with an explicit reason.
Callable schema
Configured tools
13 tools define the current MCP surface. Workspace owners create agent keys in Accounts, then paste the generated configuration into their agent.
get_workspace_statusStart here to read setup progress, connection availability, accounts, policy, brief, and activity counts.list_accountsRead the destination account IDs and connection state available inside this workspace.connect_accountCreate a platform authorization URL for a human to complete when the workspace connection gate is unlocked.get_briefRead the current workspace-owned brand guidance before planning or writing content.get_digestRead the latest completed workspace week as descriptive evidence.upload_mediaCreate a short-lived direct-upload contract for finished video bytes.get_mediaVerify one uploaded media handle before publishing it.submit_planPropose a time-bounded publication plan for one human approval.get_planRead the current plan state and structured feedback from the human reviewer.publish_videoSubmit finished short-form video for immediate or UTC-scheduled execution.get_publishRead one post state, every destination outcome, and structured approval feedback.get_performanceRead normalized measurements for one post or one connected account.get_best_postsRank one account's posts by one evidence-backed metric over a requested window.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.
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 postsChoose 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 requirementsEvery dimension fact with its classification and source.
- TikTok caption limitThe documented API caption length, and what it does not cover.
- TikTok metrics availabilityWhich performance fields Postdom can return, and which stay null.
- TikTok caption checkerCount your caption, tags and emoji, then see what to shorten.
Instagram Reels
- How to schedule Instagram ReelsCompare 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 limitsThe documented caption length for the publishing API.
- Instagram Reels metrics availabilityWhich insights fields Postdom can return, and which stay null.
- Instagram Reels size and dimensionsEvery dimension fact with its classification and source.
- Instagram caption checkerCheck your Reel caption length and decide what to trim.
YouTube Shorts
- How to schedule YouTube ShortsChoose 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 requirementsWhat qualifies as a Short, with each fact's classification.
- YouTube Shorts metrics availabilityWhich analytics fields Postdom can return, and which stay null.
- YouTube title and description limitsThe documented title and description lengths for the upload API.
- YouTube title checkerCheck your title length and find ways to shorten it.
- How to schedule LinkedIn postsUse 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 specificationsWhich published numbers apply to organic posting, and which are advertising specs.
- LinkedIn video requirementsOrganic, Pages, and ad video requirements kept as three documents, not one spec.
- LinkedIn metrics availabilityNine fields, every one unverified, each with its reason.
Facebook Reels
- Facebook Reels video requirementsThe Reels 3-to-90-second bound, kept on Reels, with what Postdom checks.
Threads
- Threads character limitWhich figure governs a post's text and which governs a long-form attachment, and what Postdom enforces.
Bluesky
- Bluesky character limitBoth 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 in Accounts; finished video uploads directly through the short-lived workspace-scoped contract.
See every current limitation