The Posthive MCP server lets AI agents manage social media accounts, posts, drafts, scheduling, and templates within a Posthive workspace.
List connected social media accounts with IDs, platforms, and display names.
Create posts as drafts by default, or directly schedule them with future times, including media, per-account overrides, first comments, repeat intervals, Instagram/YouTube options, and dry-run mode.
Retrieve full details and per-platform status for a specific post.
List upcoming scheduled posts and drafts, optionally filtered by status.
Approve draft posts and schedule them for publishing.
Update queued or draft posts, including content, scheduled time, per-account overrides, and first comments.
Duplicate existing posts as new drafts.
Delete pending or draft posts from the queue.
List saved post templates and create draft posts from templates with optional content/first-comment overrides and direct scheduling.
Allows scheduling and publishing posts to Bluesky, including text, images, and first comment support.
Allows scheduling and publishing messages to Discord channels.
Allows scheduling and publishing posts to Facebook, including text and images.
Allows scheduling and publishing Instagram posts, reels, stories, and carousels (up to 10 items) with image alt text.
Allows scheduling and publishing posts to Mastodon instances.
Allows scheduling and publishing Pinterest Pins with dedicated Title and Description fields (image required).
Allows scheduling and publishing messages to Telegram channels or groups.
Allows scheduling and publishing posts to Threads, including text and images.
Allows scheduling and publishing posts to Tumblr.
Allows scheduling and publishing YouTube videos (short and long-form) with dedicated Title/Description fields.
Allows scheduling and publishing YouTube Shorts with dedicated Title/Description fields.
Multi-platform posting - write once, publish to 14+ platforms simultaneously
AI agent support - connect Claude, ChatGPT, Cursor, VS Code via MCP; OAuth 2.0 + PKCE, no API key to paste
AI caption assist - generate post copy directly in the composer
Content Library - upload a CSV once, drip-publish automatically over time with configurable posts/day and time slots
Repeat post scheduling - repeat a post daily, weekly, or monthly with an end date
Account Groups - named sets of accounts for quick selection in compose
Calendar view - FullCalendar month/week/day with drag-to-reschedule
Bulk CSV scheduling - upload a spreadsheet to schedule hundreds of posts at once
Post templates - save and reuse post drafts
First comment scheduling - auto-reply immediately after the post goes live
Per-platform overrides - custom text and first comment per account
Instagram Reels & Stories - full media type support including carousels
YouTube Shorts & videos - dedicated title/description fields, custom thumbnail upload
TikTok Direct Post - full Content Posting API UX compliance (privacy, interaction, disclosure controls)
Dry run mode - test the full pipeline without real API calls
Draft posts - save compose state, schedule later
Public REST API - full CRUD with Bearer auth (Pro/Team)
Self-hostable - Docker compose, one command, billing optional
Related MCP server: socialclaw
Layer | Technology |
Frontend | Next.js 16 (App Router), React 18, Tailwind CSS |
Backend | Fastify v5, TypeScript ESM, Node.js |
Database | Prisma 5 (SQLite for dev, Postgres for prod) |
Queue | BullMQ + Redis (Upstash / Railway) |
Storage | Local disk (dev) / Supabase Storage (prod) |
Resend | |
Billing | Dodo Payments (optional) |
Monitoring | Sentry |
git clone https://github.com/AstaBlackClove/posthive.git
cd posthive
cp apps/api/.env.example .env
# Fill in ENCRYPTION_KEY, JWT secrets, DATABASE_URL, REDIS_URL
docker compose up -d --buildOpen http://localhost:3000 and register. Billing is disabled by default all features unlocked.
Full setup guide → posthive.co/docs
pnpm install
cp apps/api/.env.example apps/api/.env
pnpm dev # starts API + Web + Postgres (Docker)Service | URL |
Web | |
API | |
Prisma Studio |
Environment variables & platform OAuth setup → posthive.co/docs
Connect any MCP-compatible AI agent to Posthive with a single URL no API key to generate or paste.
# Claude Code
claude mcp add --transport http posthive https://your-api/mcp
# Cursor / VS Code — add to mcp.json
{ "mcpServers": { "posthive": { "url": "https://your-api/mcp" } } }The first tool call opens your browser to sign in. Full setup per client → posthive.co/agent
10 tools available: list_accounts · create_post · get_post · list_scheduled_posts · approve_draft · update_post · duplicate_post · delete_post · list_templates · create_from_template
Questions, feature requests, bugs join the Discord:
AGPL-3.0 if you modify this project and run it as a network service, you must make your source available to users of that service.
Approve a draft post and schedule it for publishing at a specific time. Promotes a draft to the scheduled queue — it will publish at scheduled_time without further approval. Only works on posts with status 'draft'.
Inputs: post_id (required), scheduled_time (required).
Create a draft post using a saved template as the base content. You can override the text before saving. Use list_templates to get template IDs.
Inputs: account_ids (required), template_id (required), scheduled_time, content_override, +2 more.
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. Each platform has its own character limit for both the post text and the first_comment — the request is rejected with a 400 if either exceeds it for any selected account: Bluesky 300, Threads/Mastodon/Pinterest 500, Instagram/TikTok 2200, Discord 2000, LinkedIn 3000, Telegram/Tumblr 4096, YouTube 5000, Nostr/Lemmy 10000, Twitter/X 25000, Facebook 63206. Check the content and first_comment length against the shortest limit among the selected platforms before calling, and warn the user if a caption (especially a long hashtag block) would be rejected. TikTok accounts require a video in media_urls (.mp4/.mov) plus tiktok_privacy_level, or the request is rejected with a 400.
Inputs: content (required), account_ids (required), dry_run, media_type, +15 more.
Delete a pending or draft post from the queue.
Inputs: post_id (required).
Clone an existing post as a new draft. Copies content, accounts, and per-account overrides.
Inputs: post_id (required).
Get full details of a single post by ID, including per-platform publish status.
Inputs: post_id (required).
List all connected social media accounts for this Posthive workspace. Returns account IDs, platforms, and display names. Use these IDs when creating posts.
Inputs: no named parameters.
List upcoming scheduled posts and drafts in the queue.
Inputs: limit, status.
List all saved post templates in this Posthive workspace.
Inputs: no named parameters.
Update content or scheduled time of a queued or draft post. Only pending/draft posts can be updated.
Inputs: post_id (required), content, per_account, tiktok_title, +8 more.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 10 tools
Each tool targets a distinct verb+resource pair: create/get/update/delete/duplicate post, accounts and templates listing, draft approval. The only minor overlap is between update_post (changing scheduled_time) and approve_draft (scheduling a draft), but the descriptions clarify that approve_draft only works on drafts and promotes them to the queue.
All ten tools follow a strict snake_case verb_noun pattern (create_post, get_post, update_post, delete_post, duplicate_post, list_accounts, list_templates, approve_draft), with no mixed conventions.
Ten tools is well within the ideal 3-15 range and each one maps to a real operation in the post lifecycle (author, review, schedule, duplicate, delete, plus supporting account/template lookups).
Core post CRUD plus draft approval is covered, but template support is one-sided: there is list_templates and create_from_template with no create_template, update_template, or delete_template. There is also no way to list or inspect already-published posts beyond get_post by ID, which leaves reporting/history as a dead end.
Schedule and analyze posts on 12 networks, incl. Bluesky, Mastodon and Telegram, from any AI agent
Post and schedule to LinkedIn, X, Bluesky, Discord, Telegram and Mastodon from AI agents.
Schedule social posts, threads and video to X, LinkedIn, Bluesky, Mastodon and YouTube from your AI.
A free social media scheduler your AI tools can post through — LinkedIn, Bluesky, Mastodon, YouTube.