upload-post-mcp

A local MCP (Model Context Protocol) server that lets Claude post to social media via upload-post.com — text, photos, and videos across 13 platforms: TikTok, Instagram, LinkedIn, YouTube, Facebook, X, Threads, Pinterest, Bluesky, Reddit, Discord, Telegram, and Google Business Profile.

Setup

1. Get an API key: create an account at app.upload-post.com, create a profile, connect your social accounts to it, and generate an API key (Settings → API Keys). Free tier: 10 uploads/month.

2. Build (already done if you're reading this locally):

   npm install && npm run build

3. Register with Claude Code (user scope — available in every project):

   claude mcp add upload-post --scope user \
     --env UPLOAD_POST_API_KEY=YOUR_KEY_HERE \
     -- node /Users/sagar/Desktop/projects/upload-post-mcp/dist/index.js

   To change the key later, edit the upload-post entry in ~/.claude.json or re-run the command above.

4. Test: in a new Claude Code session, ask Claude to run verify_account. It should return your account email and plan.

Related MCP server: Video MCP

Tools

All publish tools support scheduled_date + timezone, add_to_queue, async_upload, first_comment, and an extra_params passthrough for any platform-specific field in the upload-post API docs (e.g. X polls, YouTube tags, Instagram REELS/STORIES, TikTok privacy).

Publish calls send an Idempotency-Key automatically, so a retried request won't double-post.

Notes

• The user argument on posting tools is your upload-post profile name (see list_profiles), not your account email.

• Facebook needs facebook_page_id, Pinterest needs pinterest_board_id, Reddit needs subreddit — use list_page_targets to find IDs.

• Media parameters accept either a local file path or a public http(s):// URL.