MCP server for the Postoria Public API.
Postoria MCP server demonstrates solid tool design with consistent naming (verb_noun pattern), comprehensive parameter descriptions, and proper schema definitions. All 14 tools have clear descriptions (avg ~120 chars) and typed input schemas. However, output schemas are not documented in the source code, and several tools lack enum constraints for constrained inputs. Error handling guidance is minimal. Tool composition is clean with proper chaining IDs (workspace_id, media_id, post_id, queue_id, account_ids). Destructive operations (delete_post) are properly flagged but lack confirmation/dry-run patterns.
Create a Postoria post and add it to a publishing queue.
Complete a media upload after the raw file bytes have been uploaded to the signed upload URL.
Create a media upload slot and signed upload URL. This tool does not upload file bytes; upload raw bytes to the returned URL with PUT, then call complete_media_upload.
Delete/cancel a Postoria post. This is destructive and should only be called after user confirmation.
Get the processing status and details for a Postoria media item.
Get status and publishing results for a Postoria post.
Output schemas not documented. Tools return data but LLMs cannot see expected response structure (fields, types, pagination). Forces LLMs to guess what data is available for downstream chaining.
Constrained parameters lack enum definitions. 'status' in list_posts, 'content_type' in publish_post_now/schedule_post/add_post_to_queue, and 'networks' accept free-form strings instead of enums. LLMs will hallucinate invalid values.
Destructive operation (delete_post) lacks confirmation/dry-run pattern. No mechanism to prevent accidental deletion. Tool description says 'should only be called after user confirmation' but this is not enforced by the tool interface.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 68 | <=2025-11-25 | v2 |
Import media into Postoria from a public URL.
List posts in a Postoria workspace, optionally filtered by accounts, queue, status, networks, UTC date range, and cursor pagination.
List publishing queues in a Postoria workspace. Returns queue IDs that should be used with add_post_to_queue.
List social accounts in a Postoria workspace. Returns account IDs that should be used when publishing, scheduling, or queueing posts.
List Postoria workspaces available to the API key. Returns workspace IDs that should be used in follow-up Postoria tools.
Create and publish a Postoria post immediately.
Create a Postoria post scheduled for a specific UTC date-time.
Upload a local file from the machine running this MCP server. Local stdio mode only.
Complex nested objects (repost, youtube, tiktok) in publish_post_now/schedule_post/add_post_to_queue lack internal schema documentation. LLMs cannot determine required vs optional fields or valid structure.
Error handling guidance absent. No recovery hints in tool descriptions (e.g., 'If media processing fails, check get_media status' or 'If workspace not found, call list_workspaces first'). LLMs cannot self-correct on failures.