Social media MCP: publish, schedule & analyze posts on TikTok, Instagram, YouTube, LinkedIn & X
com.upload-post/mcp (Social Media MCP)
This Model Context Protocol (MCP) server enables MCP-compatible AI agents to publish, schedule, and analyze social media posts across TikTok, Instagram, YouTube, LinkedIn, and X. It is the official MCP server for Upload-Post.
π οΈ Key Features
Publish posts
Schedule posts
Analyze posts
Supports TikTok, Instagram, YouTube, LinkedIn, and X
π Use Cases
Multi-platform social media publishing workflows
Automated scheduling of content to multiple networks
Post performance review and analysis for supported platforms
β‘ Developer Benefits
Integrates with MCP-compatible agents (e.g., Claude Desktop, Claude Code, Cursor)
Centralized access to social media operations via a single MCP server
Package available as @upload-post/mcp
β οΈ Limitations
Only described capabilities are publish, schedule, and analyze; no other features are specified
Supported platforms are limited to TikTok, Instagram, YouTube, LinkedIn, and X
Lets any MCP-compatible AI agent (ChatGPT, Claude Desktop, Claude Code, Cursor, β¦) publish, schedule, analyze and manage social media across TikTok, Instagram, YouTube, LinkedIn, Facebook, Pinterest, Threads, Reddit, Bluesky, X, Google Business, Discord, Telegram and more with a single API key.
Built on top of the official upload-post SDK and the public Upload-Post REST API.
Use it in ChatGPT (no setup)
Upload-Post is a plugin reviewed by OpenAI, listed in ChatGPT's Plugins (formerly Apps). Open Upload-Post in ChatGPT or search for Upload-Post in Plugins, click Install, then Connect, and sign in with OAuth. There is no MCP URL to paste, and you get the Upload Studio widget for publishing video files, photos and carousels straight from your computer. OpenAI dots use the same plugin: select it in your dot's Customize β Plugins and review its permissions.
Prefer to wire it up by hand? In ChatGPT on the web, open Plugins, click +, choose Add custom MCP server, point it at https://mcp.upload-post.com/mcp and set authentication to OAuth. Custom MCP servers get write actions on Business, Enterprise and Edu workspaces.
Use it in Claude (no setup)
Upload-Post is an official connector in Claude's connector directory. Add Upload-Post to Claude, or in claude.ai, Claude Desktop or Claude Cowork open Customize β Connectors, browse the directory and search for Upload-Post, then click Connect and sign in with OAuth. There is no MCP URL to paste. On Team and Enterprise an owner may need to allow it first in Organization settings.
Prefer to wire it up by hand? Open Customize β Connectors, click + Add, then Add custom connector, paste https://mcp.upload-post.com/mcp, click Continue and sign in with OAuth. Custom connectors work on every Claude plan (the Free plan allows one). In Claude Code: claude mcp add --transport http upload-post https://mcp.upload-post.com/mcp, or install the official Upload-Post plugin from the Claude directory.
Use it in Perplexity Computer
Open Plugins in the sidebar (or Customize β Connectors), then Add custom β Connector β Add MCP connector β Remote. Use https://mcp.upload-post.com/mcp with the Streamable HTTP transport and OAuth (or your Upload-Post API key), click Add, then click the Upload-Post card to sign in.
Use it in Gemini CLI
Install the extension and sign in with OAuth the first time Gemini calls a tool:
Get your API key at https://app.upload-post.com β API Keys. Restart the client β you should see 58 upload-post tools.
B) Hosted HTTP (multi-tenant) β share one server with many users
Run the server on any Docker-capable host (Fly, Railway, Cloud Run, your own boxβ¦) and let each user connect with their own Upload-Post API key. The server stores nothing per user.
retry_post, unpublish_post, edit_post, repost_post, post_action (not exposed in ChatGPT yet)
Best times
get_best_times: the hours each connected account gets the most engagement; update_queue_settings with slots: "auto" fills the queue with them (not exposed in ChatGPT yet)
Telegram
manage_telegram_chat (chat info, members, invite links, join requests, forum topics), manage_telegram_bot (bot profile and commands) (not exposed in ChatGPT yet)
send_dm (Instagram, Bluesky), list_dm_conversations, start_autodm (one post: Instagram DM or public auto-reply on TikTok, YouTube, Facebook, Threads, Bluesky), list_autodms, get_autodm_logs, pause_autodm, resume_autodm, stop_autodm, delete_autodm, manage_autodms
AutoDM rules
create_autodm_rule, list_autodm_rules, pause_autodm_rule, resume_autodm_rule, delete_autodm_rule: account-wide Instagram rules (every post, story replies, story mentions, DM keywords) that never expire (not exposed in ChatGPT yet)
Webhooks
list_webhook_deliveries, get_webhook_delivery, redeliver_webhook: 7-day log of the events sent to the user's webhook URLs, with attempts and manual redelivery (not exposed in ChatGPT yet)
One server covers every network; this is what each of the big five uses. Publishing always goes through the same upload tools with a platform list, so a single call can post one video to TikTok, Reels and Shorts at once.
Search terms people use for these: TikTok MCP server, YouTube MCP server / YouTube uploader MCP, Instagram MCP server, LinkedIn MCP server, Facebook MCP server.
One tool per question, not per network
The Upload-Post API has no endpoint per social network: it has an endpoint per question, and a platform parameter saying who is being asked. get_post_comments, get_post_analytics, get_audience, get_suggestions and comment_action all work that way, so an agent learns one shape and reuses it for every network. Only the four tiktok_* tools are network-specific, because what they return (the Commercial Music Library, TikTok places, TikTok's per-account publishing settings) exists only on TikTok.
get_audience β who follows the profile, where they are, when they are online, what they tap. Also benchmark_categories, and the niche averages to compare against when benchmarkCategory is set. The server clamps the window to at most 60 days ending before today, so a wider range is trimmed rather than rejected, and range in the response says which window was used.
get_suggestions β hashtags (with view_count) or related keyword searches, told apart by type, not by a different tool.
get_post_comments β top-level comments on a post, or, with commentId, the replies under one of them (TikTok, Threads, YouTube, Instagram, Facebook and LinkedIn Page posts; LinkedIn prefers the full comment_urn). Reads are cached for up to 60 seconds (up to 2 minutes on X); a comment created or deleted through Upload-Post by the same account shows up on the next read.
create_comment on X β links are removed unless the account is allowed links on X (reported in warnings); a message that was only links fails with 400 x_links_not_allowed. Replies, post edits and reposts on X share a daily limit per X account (20 on the free plan, 200 on paid plans, reset at 00:00 UTC); past it the API answers 429 x_daily_write_limit with retry_after and a Retry-After header.
hide_comment, like_comment, pin_comment, edit_comment, hold_comment, approve_comment, ignore_comment, set_post_comments β one tool per moderation operation. comment_action does the same through a single action argument and stays available everywhere except ChatGPT, which only gets the one-operation tools (the same goes for manage_autodms).
comment_action β moderate a comment on TikTok (hide / like / pin), Facebook (hide / like / edit), Instagram (hide, or enable / disable comments on a post), YouTube (hide / hold) and Threads (hide / approve / ignore). Each value carries its own inverse, so nothing is permanent.
get_post_analytics β per-post metrics, by requestId (posts published through Upload-Post, TikTok drafts once published publicly) or by platformPostId + platform + user (any post of the connected account). post_metrics is whatever the platform reports, so its shape varies: on TikTok it adds retention, impression_sources, audience_types, new_followers, reach and the watch times (average_time_watched, total_time_watched, full_video_watched_rate).
Errors are shared too: platform_not_supported (400, with the list of the networks that can answer), invalid_parameter (400), tiktok_reconnect_required (400), reauth_required (409) and 502 when the upstream network fails.
TikTok capabilities
get_post_comments, create_comment, delete_comment and comment_action accept platform: "tiktok", and firstComment works on TikTok like on every other network.
What a TikTok account can do depends on how it is connected. list_users returns a capabilities array on each TikTok account β music, location, cover_image, cover_timestamp, draft, video_privacy, photo_privacy, profile_analytics, comments, trend_search β and each tool's description names the one it needs. They are granted when the user connects TikTok, so an account connected before a capability existed has to reconnect before the matching tools answer; that is what a tiktok_reconnect_required error means.
list_dm_conversations (Instagram, WhatsApp, Messenger, Bluesky) is cursor-paginated the same way, through pagination.next_cursor / has_more. It also takes since (Unix timestamp or ISO 8601, activity after that moment), participant_id (one thread) and messages_limit (latest messages per conversation, 1-25, default 10). Pages hold at most 50 conversations (25 on Bluesky). Message media comes back in attachments with type and url. Bluesky also takes conversation_id + messages_cursor (one conversation's older messages), status (request / accepted) and read_state: "unread"; send_dm on Bluesky takes a handle or DID, a shared post, reply_to and sender actions (read, react, accept, mute, leave). Bluesky DMs need an app password created with access to direct messages.
get_media and get_cached_post_analytics are cursor-paginated: feed the response's next_cursor back as cursor until has_more is false. LinkedIn, Discord and Telegram do not support media cursors and accept limit only. Prefer get_cached_post_analytics over get_post_analytics when scanning many posts β it replays previously fetched results and so avoids the live analytics rate limit of 100 requests / 5 minutes. Only contains posts previously fetched through a live per-post endpoint; there is no background refresh, so captured_at is the last time that post was read live.
FFmpeg jobs accept one public URL through input_url or multiple URLs through files. They run on Upload-Post's encoding servers, each in its own working directory. full_command is a single ffmpeg invocation with {input} (or {input0}, {input1}β¦) and {output} placeholders, run without a shell: it must start with ffmpeg, every -i must be an {input}/{inputN} placeholder or a -f lavfi source, and {output} is the only output. Protocols or URLs inside the command (file:, concat:, subfile,β¦), the movie=/amovie=/sendcmd filters, absolute paths other than fonts under /usr/share/fonts, .., -safe 0 and shell metacharacters are rejected with a 400. Endless commands (-stream_loop -1, -loop 1, a lavfi source without a duration) need -t, -shortest or -frames, and -stream_loop goes from -1 to 100. Usage is charged at the longer of the input and output durations. Poll get_ffmpeg_job until completion, then call download_ffmpeg_result; it returns the result URL without streaming the processed binary through MCP. Nothing is posted until you pass that URL to an upload tool.
Telegram, Bluesky and Google Business
The resource tools (manage_telegram_chat, manage_telegram_bot, bluesky_read, manage_bluesky_account, google_business_read) take an action and a params object with the REST API's own field names, so one tool covers a whole resource without a tool per endpoint. Deletions and other changes that cannot be undone carry the API's own confirm: true, which the agent sets only after the user approves.
Publishing takes the new per-network options in platformOptions: sponsored content (paidPartnership, facebookSponsorId), Telegram (telegramPoll, telegramLocation, telegramVenue, telegramContact, telegramDice, telegramReplyMarkup buttons, telegramPin, telegramDisableNotification, telegramProtectContent, telegramMessageThreadId, telegramHasSpoiler, telegramCaptionOverflowβ¦), Bluesky (blueskyTags, blueskyThreadgate, blueskyPostgate, blueskyQuoteUri, blueskyThreadOverflow, blueskyCaptions, blueskyVideoPresentation, blueskyGifAsVideo) and Google Business (gbpScheduledTime, gbpRecurrence*, gbpMultiMedia, gbpUploadToGallery). unpublish_post deletes Telegram posts (delete_all_messages for the messages a long post was split into), get_analytics takes telegram, and list_dm_conversations takes Bluesky's view: "summary" and include: "unread_counts".
YouTube works the same way (youtube_read and five manage_youtube_* tools). Each account has a daily YouTube allowance for these calls (200 units on the free plan, 2,000 on paid plans, reset at midnight Pacific time; youtube_read with action: "quota" shows what is left): reads cost about 1 unit, most writes 50 and caption uploads 400 or more. Images and caption files are taken by public URL (image_url, file_url, thumbnail_url), never as a path. Uploads take youtubeLocalizations and youtubeBrandPartner, and edit_post edits YouTube videos (title, description, tags, privacy, translations, brand partnerβ¦).
These tools and parameters are not in ChatGPT's surface yet: they join it with the next app review. npm run check compares what ChatGPT sees with the reviewed snapshot in scripts/fixtures/chatgpt-tools.json.
Confirmation before acting
Tools that publish or reach other people as the user run in two steps. Called without confirmed: true, they return status: "confirmation_required" with a preview of exactly what would go out (text, media, platforms or recipients, buttons, keywords, timing) and do nothing; the model shows it to the user and repeats the call with confirmed: true once they approve. This covers upload_video, upload_photos, upload_text, upload_document, send_dm, reply_to_comment, public_reply_to_comment, create_comment, reply_to_google_business_review, edit_comment, unpublish_post, start_autodm and manage_autodms with action: "start", create_autodm_rule, redeliver_webhook, edit_post, repost_post, post_action (except private bookmarks), the YouTube comment and live chat writes and the YouTube deletions, plus comment_action / hide_comment when they edit a comment or ban its author. delete_user deletes only when confirm_username repeats the profile name. Uploads with a scheduledDate or addToQueue run straight away, because a scheduled or queued post can still be reviewed and cancelled before it publishes; this also lets scheduled, unattended runs post. ChatGPT, which asks the user before every write tool, keeps the single-step tools.
Reddit publishing is switched off while the Reddit app is unavailable: reddit is not offered as a platform and asking for it fails with reddit_unavailable. Self-hosters can set UPLOAD_POST_REDDIT_ENABLED=true once it is back.
ChatGPT video upload UI
open_upload_studio renders a ChatGPT Apps component for file-based publishing: one video, or one or more images (up to 10, for a carousel; pass mediaType: "photos"). For each file the widget creates a short-lived Upload-Post/R2 staging upload, PUTs the file directly to R2 and completes the upload, one file at a time, then calls upload_video or upload_photos with the returned temporary media URLs in order. For photos it can instead hand the staged URLs back to ChatGPT ("Send to ChatGPT"), which then calls upload_photos itself, e.g. with a different caption per platform. upload_video and upload_photos refuse /mnt/data and sandbox attachment paths and point the model at the Studio.
The widget speaks the ChatGPT Apps SDK bridge, so it is only advertised to ChatGPT (detected from clientInfo at initialize; override the match with UPLOAD_POST_STUDIO_CLIENTS=<regex>). Every other host (claude.ai, Claude Desktop, Claude Code, Cursor, β¦) does not see the tool or its ui:// resource; instead create_media_upload / complete_media_upload are exposed to the model with step-by-step guidance, and upload_video tells the assistant to ask for a public URL or send the user to the dashboard when the client cannot PUT the file itself.
The staging object is deleted after 24 hours whether it is used or not. Scheduled/queued posts remain safe because upload_video copies the temporary URL into the existing durable scheduler storage before execution.
Claude and other MCP clients can use the same flow without the ChatGPT UI: call create_media_upload, PUT the file to upload_url, call complete_media_upload, then pass media_url to upload_video.
Set UPLOAD_POST_R2_CONNECT_DOMAINS on the MCP host to the comma-separated origins used by the backend's R2 signed URLs when they differ from the defaults (for example https://<account>.r2.cloudflarestorage.com,https://<bucket>.<account>.r2.cloudflarestorage.com) so the ChatGPT component CSP allows the browser PUT.
The R2 bucket CORS policy must allow browser uploads. A restrictive policy can include your actual widget origin; for fastest validation, use:
Single user's Upload-Post API key. Ignored in --http mode β keys come per request.
UPLOAD_POST_BASE_URL
both
https://api.upload-post.com/api
Override for self-hosted / staging.
UPLOAD_POST_MCP_PORT
http
8080
Port for --http mode.
UPLOAD_POST_MCP_MAX_BODY_MB
http
10
Largest /mcp request body accepted; bigger ones get 413.
UPLOAD_POST_MCP_VALIDATE_API_KEYS
http
true
Check a pasted API key once against GET /uploadposts/me (cached) before opening a session for it; a rejected key gets 401.
UPLOAD_POST_MCP_KEY_CHECK_TTL_MS
http
600000
How long an accepted key is trusted before it is checked again.
UPLOAD_POST_MCP_MAX_SESSIONS
http
2000
Live sessions kept in memory; past it the longest-idle one is closed.
UPLOAD_POST_MCP_MAX_SESSIONS_PER_KEY
http
200
Live sessions per credential; past it that credential's own longest-idle session is closed.
UPLOAD_POST_MCP_SESSION_TTL_MS
http
1800000
Idle time after which a session is closed.
UPLOAD_POST_MCP_AUTH_FAIL_MAX
http
20
401s on /mcp one client IP may collect per window; past it that IP gets 429 + Retry-After (sessions and keys already verified still pass; one request per probe interval is checked normally). 0 turns it off.
UPLOAD_POST_MCP_AUTH_FAIL_WINDOW_S
http
300
Window for the count above; a held IP is released this long after its last failure.
UPLOAD_POST_MCP_AUTH_FAIL_PROBE_S
http
30
While held, one request per this many seconds goes through the normal auth path.
UPLOAD_POST_MCP_TRUST_PROXY
http
auto
Whether the client IP is the last X-Forwarded-For hop: auto (only when the peer is a private address, i.e. a local reverse proxy), true or false.
UPLOAD_POST_MCP_ALLOW_LOCAL_FILES
http
false
Let tools read media from file paths on the server's disk. Off for a shared host (only http(s) URLs are accepted); turn it on only when the HTTP server runs next to your own files. stdio always allows paths.
OPENAI_APPS_CHALLENGE_TOKEN
http
Current Upload-Post challenge token
Optional override for ChatGPT Apps domain verification at /.well-known/openai-apps-challenge.
CLI flags:
--http β start the streamable HTTP transport instead of stdio
--port <n> β port for HTTP mode
HTTP endpoints:
POST /mcp β JSON-RPC over MCP streamable HTTP. Requires Authorization: ApiKey <key> (or Bearer <key>) on every request. The key is the user's own Upload-Post API key; the server uses it only for that session and stores nothing.
GET /healthz β liveness probe, always open. Returns {"ok":true}.
Auth model in --http mode is the same pattern Resend, Tavily, Brave Search and other API-key-native services use for their hosted MCPs: the upstream key is the auth.
Deploy with Docker
The repo ships with a multi-stage Dockerfile and a .dockerignore. On any Docker-capable PaaS (Fly.io, Railway, Render, Cloud Run, fly machines, your own boxβ¦):
Point the PaaS at this repo and select Dockerfile as the build pack.
Port: 8080 (matches EXPOSE 8080).
Environment variables: none are required. Optionally set UPLOAD_POST_BASE_URL if you point at staging.
Health check path: /healthz (HTTP, port 8080).
Domain: attach a domain, e.g. mcp.your-domain.com, and provision TLS (most PaaS do this automatically via Let's Encrypt).
Deploy. The server is now ready for any number of users. Each user adds the endpoint to their MCP client config with their own Upload-Post API key:
Without an Authorization header the server returns 401. The header is the only credential β invalid Upload-Post keys will surface as upstream errors on the first tool call.
Prefer public URLs over local paths when uploading β local paths only work if the MCP server runs on the user's machine.
In ChatGPT Apps, prefer open_upload_studio for user-selected video and image files. It avoids local-path handoff issues by uploading to short-lived Upload-Post/R2 staging, then passing temporary media URLs to upload_video / upload_photos.
In any other client with a local file: if the client can run HTTP requests (Claude Code, Cursor, a script), stage it with create_media_upload β PUT the bytes to upload_url β complete_media_upload, then pass the returned media_url to upload_video. Hosted chats without that ability (claude.ai) need a public HTTPS URL or the dashboard at https://app.upload-post.com.
To send video bytes directly (a client that holds the file rather than a URL), pass videoBase64 to upload_video instead of videoPathOrUrl. The server writes it to a temp file, uploads, then deletes it. Inline bytes are capped at UPLOAD_POST_MAX_INLINE_MB (default 100 MB), and in --http mode the whole request at UPLOAD_POST_MCP_MAX_BODY_MB (default 10 MB, roughly 7 MB of video once base64-encoded) β for larger videos use a public URL.
Always create the profile first (create_user) and connect socials in the Upload-Post dashboard before publishing.
For scheduled posts, pass ISO 8601 dates with timezone, e.g. "2026-12-25T10:00:00Z" + "timezone": "Europe/Madrid".
Privacy & data handling
This server is a stateless proxy to the Upload-Post API. Per request, the only data it processes is the user's API key (or OAuth access token resolved to one) and the arguments of the tool call being executed. No user data is persisted by the MCP container itself.
What we receive per request: the Authorization header, the MCP tool name + arguments, and any media URLs/paths the agent passes.
What we forward: the tool arguments to the Upload-Post API on behalf of the authenticated user.
What we store: nothing per-user. OAuth tokens are stored upstream in the Upload-Post backend, hashed (SHA-256), so a breach of token storage cannot impersonate users.
What we log: HTTP method, path, status code, and an opaque request ID. No tool arguments, no API keys, no tokens.
To revoke a connector's access at any time, open Connected Apps in app.upload-post.com.
Security
All traffic is TLS-terminated at the edge (HTTPS only).
/mcp requires a valid Authorization header on every request; OAuth access tokens are short-lived (1 h access + 90 d refresh with rotation per RFC 6749 Β§10.4).
The server validates the Origin header against an allow-list (claude.ai, claude.com, chatgpt.com, chat.openai.com, app.upload-post.com, localhost) to mitigate DNS-rebinding attacks from browser-based clients. Extend with OAUTH_EXTRA_ALLOWED_ORIGINS (comma-separated) when self-hosting behind a custom dashboard.
OAuth metadata is served both at /.well-known/oauth-protected-resource and at the path-inserted form /.well-known/oauth-protected-resource/mcp (RFC 9728 Β§3.1), and likewise for oauth-authorization-server.
In --http mode the server writes one stderr line per failed request and per OAuth/well-known request (method, path, status, auth scheme, user agent β never query strings or credentials). Set UPLOAD_POST_MCP_ACCESS_LOG=all to log every request or off to disable it.
If ChatGPT shows redirect_uri not on allow-list during OAuth, add the exact redirect_uri from the failing authorize request to the Upload-Post backend OAuth redirect allow-list. For ChatGPT clients this is typically on https://chatgpt.com/.../oauth/callback or https://chat.openai.com/.../oauth/callback.
OAuth redirect callbacks are pre-allowed for: Claude (claude.ai/claude.com), ChatGPT, Cursor, VS Code (stable + Insiders), Smithery, Glama, Toolhouse, Perplexity (standard + Enterprise), Mistral Studio debugger and Postman β plus any http://localhost/loopback redirect (RFC 8252), which covers Claude Code, Windsurf, Cline, Continue, Goose, Gemini CLI and other mcp-remote-style clients. Platforms without a documented fixed callback (e.g. Grok, Le Chat production) are added on request.
All tools declare MCP readOnlyHint/destructiveHint annotations so clients can surface confirmation prompts for destructive operations, and the tools that publish or message people also require an explicit confirmed: true (see Confirmation before acting).
Report a security issue: info@upload-post.com (encrypted PGP available on request).