upload-post-mcp

An MCP (Model Context Protocol) server that lets Claude — or any MCP client — 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.

Unlike scheduler-specific connectors (e.g. Buffer's), this publishes directly to your connected accounts — no Buffer subscription, and it covers platforms most connectors don't (TikTok video, YouTube, Reddit, Google Business), plus scheduling, queues, analytics, and Instagram comment/DM replies.

🚀 Try it in 2 minutes (no install)

A hosted instance is live — connect it straight from your Claude settings:

1. claude.ai (web) / Claude Desktop / mobile: Settings → Connectors → Add custom connector

   • Name: Upload-Post

   • URL: https://upload-post-mcp.sgr-flutter.workers.dev/mcp

   • Leave the OAuth fields empty → Add

2. Claude opens a consent page — paste your upload-post API key once (free account: 10 posts/month, no card)

3. In a chat, try: "verify my upload-post account", then "post 'hello from Claude' to my X"

Claude Code: claude mcp add --transport http upload-post https://upload-post-mcp.sgr-flutter.workers.dev/mcp

Ships in two flavors from this repo:

Related MCP server: Video MCP

Quick start

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. Add to Claude Code:

   claude mcp add upload-post --scope user \
     --env UPLOAD_POST_API_KEY=YOUR_KEY_HERE \
     -- npx -y upload-post-mcp

   Claude Desktop (claude_desktop_config.json):

   {
     "mcpServers": {
       "upload-post": {
         "command": "npx",
         "args": ["-y", "upload-post-mcp"],
         "env": { "UPLOAD_POST_API_KEY": "YOUR_KEY_HERE" }
       }
     }
   }

3. Test: ask Claude to "verify my upload-post account". It should return your account email and plan. Then try "post 'hello world' to my X account".

From source

git clone https://github.com/MrSagarShah/upload-post-mcp.git
cd upload-post-mcp && npm install && npm run build
claude mcp add upload-post --scope user \
  --env UPLOAD_POST_API_KEY=YOUR_KEY_HERE \
  -- node "$(pwd)/dist/index.js"

Tools (17)

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 (X polls, YouTube tags/privacy, Instagram REELS/STORIES, TikTok privacy, and more).

Scheduling runs on upload-post's servers — schedule posts and close your laptop; they publish on time.

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

Example prompts

• "Post 'We're hiring!' to my LinkedIn and X"

• "Schedule this for Friday 9am New York time on LinkedIn"

• "Post these three photos as an Instagram carousel with caption ..."

• "Upload ~/Videos/demo.mp4 to YouTube as unlisted and TikTok"

• "How did my last week's posts perform on X?"

• "Reply to the latest comments on my Instagram reel"

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 (hosted connector: URLs only).

Troubleshooting

Roadmap

• Local stdio connector (17 tools)

• Hosted remote connector — OAuth 2.1 + Streamable HTTP on Cloudflare Workers

• npm package (npx -y upload-post-mcp)

• Anthropic connector directory listing

• LinkedIn document posts, auto-DM monitors, queue-settings tools

• Managed tier: connect socials directly, no upload-post account needed

Contributing & support

Issues and PRs welcome — open an issue for bugs or tool requests. For anything else: saumil@tempbutton.com.

If this saved you time, a ⭐ helps others find it.

Disclaimer: community project, not affiliated with or endorsed by Upload-Post. Your API key is yours; the hosted instance stores it encrypted and only forwards your own requests (privacy).

License

MIT