QPost's MCP server lets an AI agent manage social media publishing to YouTube, TikTok, and Instagram — inspecting accounts and posts, and creating, scheduling, editing, retrying, or deleting posts.
list_connected_accounts — see which YouTube/TikTok/Instagram accounts are connected and their status (call before posting).
create_post — publish immediately or schedule (scheduledFor), with video or images supplied as a remote URL, local path, or multiple images for carousels; per-platform metadata (privacy, category, tags, etc.) is supported.
list_posts — list posts, filtered by status (DRAFT, SCHEDULED, POSTED, FAILED) or platform.
get_post — fetch one post by ID, including per-platform publish status.
update_post — change a post's caption, schedule, timezone, or status.
delete_post — permanently delete a post you own.
retry_post — re-attempt publishing a post that failed.
Note: the README also advertises get_post_stats (views/likes/comments/shares plus public URL), but that tool is absent from the provided schema.
Allows scheduling and publishing video/image posts to Instagram through QPost, including managing connected accounts and posts.
Allows scheduling and publishing video/image posts to TikTok through QPost, including managing connected accounts and posts.
Allows scheduling and publishing video/image posts to YouTube through QPost, including managing connected accounts and posts.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@QPost Schedule a video post to YouTube and TikTok for tomorrow at 10am"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP server for QPost — lets AI agents schedule and publish video/image posts to YouTube, TikTok, and Instagram through QPost's REST API.
Connect your destination accounts and generate an API key at QPost API Keys, then pick one of the two options below.
QPost runs the same server at https://qpost.dev/mcp over Streamable HTTP:
claude mcp add --transport http qpost https://qpost.dev/mcp \
--header "x-api-key: YOUR_API_KEY"Any MCP client that speaks Streamable HTTP can point at that URL with an
x-api-key (or Authorization: Bearer) header. The endpoint is stateless, so
there is no session to manage.
Use this to run the MCP bridge on your machine while QPost handles publishing:
claude mcp add qpost -e QPOST_API_KEY=your_key_here -- npx -y qpost-mcp{
"mcpServers": {
"qpost": {
"command": "npx",
"args": ["-y", "qpost-mcp"],
"env": {
"QPOST_API_KEY": "your_key_here"
}
}
}
}QPOST_BASE_URL defaults to https://qpost.dev. Running this MCP bridge locally still uses QPost’s hosted publishing service.
Related MCP server: Outpost
Tool | Description |
| List connected YouTube/TikTok/Instagram accounts and their status |
| Create and publish (or schedule) a post, with video or image media from a URL or local path |
| List posts, optionally filtered by status/platform |
| Get a single post by ID |
| Views, likes, comments and shares for a published post, plus its public URL |
| Update a post's caption/schedule/timezone/status |
| Delete a post |
| Retry a failed post |
The local stdio server can read files from your machine, so create_post
accepts mediaPath as well as mediaUrl. The hosted endpoint obviously
cannot reach your disk — it takes mediaUrl/imageUrls, or mediaBase64
with an optional mediaFilename to set the MIME type.
Full request/response shapes and per-platform metadata options (YouTube category/privacy, TikTok privacy level, Instagram media type, etc.) are documented at qpost.dev/docs — this server is a thin wrapper over that same REST API.
Both the stdio server and the hosted endpoint speak MCP 2026-07-28 and still accept clients on 2025-era protocol versions. The stdio server needs Node 20+.
Use the tested n8n video-to-draft workflow. It uses built-in HTTP Request nodes, works without a community package, and saves a draft before you publish. The page includes the downloadable JSON and the settings to change.
For TikTok app-review restrictions, see self-hosted publishing options.
npm install
npm run dev # runs src/index.ts directly via tsx
npm run build # compiles to dist/MIT
Create and publish (or schedule) a post to one or more connected social platforms (YouTube, TikTok, Instagram). Provide media as either a remote URL (mediaUrl fetched by the server) or a local file path (mediaPath read from disk) — exactly one media source per call. Omit scheduledFor to publish immediately.
Inputs: caption (required), mediaKind (required), platforms (required), title, +6 more.
Permanently delete a post you own.
Inputs: id (required).
Get a single post by ID, including its per-platform publish status.
Inputs: id (required).
List the social media accounts (YouTube, TikTok, Instagram) currently connected to this QPost account, including connection status. Call this before creating a post to know which platforms are actually available.
Inputs: no named parameters.
List posts on this QPost account, optionally filtered by status or platform.
Inputs: status, platform.
Retry publishing a post that previously failed.
Inputs: id (required).
Update a post's caption, schedule, timezone, or status. Only works on posts you own.
Inputs: id (required), status, caption, timezone, +1 more.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 7 tools
Each tool has a clearly distinct purpose: account listing, post CRUD, and retry. No two tools could be confused, as create/list/get/update/delete/retry operate on different actions and list_connected_accounts is separate.
All tool names follow the same snake_case verb_noun pattern (list_, create_, get_, update_, delete_, retry_). This is highly predictable and consistent.
Seven tools is well-scoped for a social media posting server. Each tool earns its place, covering the essential operations without unnecessary bloat.
The set covers the full lifecycle of posts: create, list, get, update, delete, plus retry for failures and account listing for platform awareness. No obvious gaps for the stated purpose.
Hosted MCP server for AI agents to post to LinkedIn profiles and X and upload to YouTube.
PostHero MCP server — schedule and publish social media posts from any MCP-compatible AI tool
Agent-first social media publishing, scheduling, analytics, and unified inbox API + 16-tool MCP server across 18 social platforms (X, LinkedIn, Instagram, YouTube, TikTok, Threads, Bluesky, Reddit, Telegram, Discord, Mastodon, Facebook, Pinterest).
Connect any AI agent to 11+ social platforms: schedule, publish & track posts via hosted MCP.
