Schedule and manage social media posts across 13 platforms (Bluesky, Threads, Instagram, LinkedIn, Mastodon, YouTube, Facebook, Pinterest, Telegram, Nostr, X/Twitter, Discord, Tumblr and more). OAuth 2.0 + PKCE, 10 tools, draft-first workflow for AI agents.
Score is being calculated.
Approve a draft post and schedule it for publishing at a specific time. This promotes a draft to the scheduled queue — it will publish at scheduled_time without further approval needed. Only works on posts with status 'draft'.
| Name | Required | Description | Default |
|---|---|---|---|
| post_id | Yes | Post ID of the draft to approve. | |
| scheduled_time | Yes | ISO 8601 datetime when to publish. Must be in the future. |
| Name | Required | Description |
|---|---|---|
| id | No | |
| _note | No | |
| status | No | |
| scheduledFor | No |
Create a draft post using a saved template as the base content. You can override the text and other fields before saving. Use list_templates to get template IDs.
| Name | Required | Description | Default |
|---|---|---|---|
| account_ids | Yes | Account IDs to post to. Use list_accounts to get IDs. | |
| template_id | Yes | Template ID from list_templates. | |
| scheduled_time | No | ISO 8601 publish time. Required when schedule_directly is true. | |
| content_override | No | Override the template text. Leave blank to use template text as-is. | |
| schedule_directly | No | When true, schedule immediately instead of saving as draft. Requires scheduled_time. | |
| first_comment_override | No | Override the template first comment. |
| Name | Required | Description |
|---|---|---|
| id | No | |
| _note | No | |
| draft | No | |
| status | No | |
| targets | No | |
| scheduledFor | No | |
| templateUsed | No |
Create a post in Posthive. BY DEFAULT posts are saved as DRAFTS and require manual approval in the Posthive review queue before anything is published. Nothing is published automatically unless schedule_directly is explicitly set to true with a future scheduled_time. Use list_accounts to get valid account IDs before calling this tool.
| Name | Required | Description | Default |
|---|---|---|---|
| content | Yes | The post text content. | |
| dry_run | No | Full pipeline test without real API calls. | |
| media_type | No | Instagram media type. 'post' = feed image/carousel, 'reel' = video reel, 'story' = story. Only relevant for Instagram accounts. | |
| media_urls | No | Array of already-uploaded media URLs (images or video). Upload via POST /api/v1/upload first to get URLs. | |
| account_ids | Yes | Array of account IDs. Use list_accounts to get IDs. | |
| per_account | No | Per-account content overrides. Keys are account IDs. | |
| youtube_type | No | YouTube video type. 'short' = YouTube Short (vertical, ≤60s), 'video' = standard upload. Only relevant for YouTube accounts. | |
| first_comment | No | Optional first comment to fire after the post goes live. | |
| scheduled_time | No | ISO 8601 datetime for publish time. Required when schedule_directly is true. | |
| schedule_directly | No | When true, post is scheduled directly and publishes at scheduled_time without manual approval. Requires scheduled_time. Defaults to false (saves as draft). |
| Name | Required | Description |
|---|---|---|
| id | No | |
| _note | No | |
| draft | No | |
| status | No | |
| targets | No | |
| scheduledFor | No |
Delete a pending or draft post from the queue.
| Name | Required | Description | Default |
|---|---|---|---|
| post_id | Yes | Post ID from list_scheduled_posts. |
| Name | Required | Description |
|---|---|---|
| ok | No | |
| deleted | No |
Clone an existing post as a new draft. Copies content, accounts, and per-account overrides.
| Name | Required | Description | Default |
|---|---|---|---|
| post_id | Yes | Post ID to duplicate. |
| Name | Required | Description |
|---|---|---|
| id | No | |
| _note | No | |
| draft | No | |
| status | No | |
| targets | No | |
| scheduledFor | No |
Get full details of a single post by ID, including per-platform publish status.
| Name | Required | Description | Default |
|---|---|---|---|
| post_id | Yes | Post ID from list_scheduled_posts or create_post. |
| Name | Required | Description |
|---|---|---|
| id | No | |
| draft | No | |
| status | No | |
| content | No | |
| targets | No | |
| createdAt | No | |
| perAccount | No | |
| firstComment | No | |
| scheduledFor | No |
List all connected social media accounts for this Posthive workspace. Returns account IDs, platforms, and display names. Use these IDs when creating posts.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
| Name | Required | Description |
|---|---|---|
| accounts | No |
List upcoming scheduled posts and drafts in the queue.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max results (default 20, max 100). | |
| status | No | Filter by status. Omit to return all. |
| Name | Required | Description |
|---|---|---|
| posts | No |
List all saved post templates in this Posthive workspace.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
| Name | Required | Description |
|---|---|---|
| templates | No |
Update content or scheduled time of a queued or draft post. Only pending/draft posts can be updated.
| Name | Required | Description | Default |
|---|---|---|---|
| content | No | ||
| post_id | Yes | Post ID from list_scheduled_posts. | |
| per_account | No | ||
| first_comment | No | ||
| scheduled_time | No | New scheduled time (ISO 8601). |
| Name | Required | Description |
|---|---|---|
| id | No | |
| status | No | |
| scheduledFor | No |
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
approve_draftcreate_from_templatecreate_postdelete_postduplicate_postget_postlist_accountslist_scheduled_postslist_templatesupdate_post
Add one secure layer between your agents and this server.