Integration Guide Open Source

Social Media MCP Server Connect ChatGPT, Claude & any AI agent

Upload-Post is the open-source social media MCP server. Add one config block to your AI client and your assistant gains 40 tools to publish, schedule, analyze and manage social media — TikTok, Instagram, YouTube, LinkedIn, Facebook, X, Threads, Reddit, Bluesky, Pinterest, Google Business, Discord & Telegram.

Start free — no card View on GitHub
~/.claude/mcp.json 
{
  "mcpServers": {
    "upload-post": {
      "url": "https://mcp.upload-post.com/mcp",
      "headers": {
        "Authorization": "ApiKey YOUR_API_KEY"
      }
    }
  }
}

What is a social media MCP server?

The Model Context Protocol (MCP) is an open standard that lets AI assistants discover and call external tools through a single uniform interface. A social media MCP server applies it to social: instead of writing code, you give your assistant access to Upload-Post and it figures out which publishing, scheduling or analytics tool to use.

Zero code

Paste a JSON snippet, restart your client. No SDK, no plumbing.

Stateless & private

Your API key flows in each request and the server stores nothing. Self-host if you want full control.

40 documented tools

Every tool maps 1:1 to a public endpoint at docs.upload-post.com. No surprises.

Configure your client

Step-by-step for the most popular MCP clients. They all point at the same hosted endpoint — just drop in your API key.

ChatGPT

Plus, Pro, Business, Enterprise or Edu, on the web. ChatGPT connects to remote MCP servers from Developer mode.

  1. Open Settings → Apps → Advanced settings and enable Developer mode.
  2. In Apps, click Create app and paste the URL below.
  3. Set Authentication to OAuth in the dropdown and authorize.
Connection 
URL    https://mcp.upload-post.com/mcp
Auth   OAuth (choose in the dropdown)
Full ChatGPT guide

Claude

On claude.ai or Claude Desktop. Add it as a custom connector and sign in through the MCP's own OAuth flow — no API key to paste.

  1. Go to Settings → Connectors and click Add custom connector.
  2. Paste the URL below and confirm.
  3. Claude opens the MCP's OAuth flow — sign in and authorize. Done.
Connection 
URL    https://mcp.upload-post.com/mcp
Auth   OAuth (choose in the dropdown)
Full Claude guide

Claude Code

One CLI command. Add --scope user to make it available in every project.

  1. Run the command below in your terminal.
  2. Start Claude Code and run /mcp to confirm upload-post is connected.
terminal 
claude mcp add --transport http upload-post \
  https://mcp.upload-post.com/mcp \
  --header "Authorization: ApiKey YOUR_API_KEY"

OpenClaw

The CLI writes the entry to ~/.openclaw/openclaw.json under mcp.servers.

  1. Run the command below (or add the entry to the config file by hand).
  2. Verify the connection with openclaw mcp doctor --probe.
terminal 
openclaw mcp add upload-post \
  --url https://mcp.upload-post.com/mcp \
  --transport streamable-http \
  --header "Authorization: ApiKey YOUR_API_KEY"

Gemini

For the Gemini CLI. Add the block to ~/.gemini/settings.json (or run gemini mcp add).

  1. Add the snippet below under mcpServers in your settings file.
  2. Start the Gemini CLI and run /mcp to confirm upload-post is connected.
~/.gemini/settings.json 
{
  "mcpServers": {
    "upload-post": {
      "httpUrl": "https://mcp.upload-post.com/mcp",
      "headers": {
        "Authorization": "ApiKey YOUR_API_KEY"
      }
    }
  }
}
Full Gemini guide

Hermes Agent

NousResearch's agent ships a native MCP client. Declare the server in config.yaml under mcp_servers.

  1. Add the block below to your config.yaml.
  2. Start Hermes — it discovers the tools at startup. Filter them with include / exclude if needed.
config.yaml 
mcp_servers:
  upload-post:
    url: "https://mcp.upload-post.com/mcp"
    headers:
      Authorization: "ApiKey YOUR_API_KEY"
    enabled: true

Also works in Cursor, VS Code Copilot and OpenCode — each has its own 3-step guide.

Quick start

Two ways to plug it in. Both expose the same 40 tools.

Recommended

Hosted (HTTP)

Use our managed endpoint. Each request carries your own API key — multi-tenant and stateless on our side.

  1. Grab your API key at app.upload-post.com → API Keys.
  2. Paste the snippet below into your AI client config.
  3. Restart the client.
mcp.json 
{
  "mcpServers": {
    "upload-post": {
      "url": "https://mcp.upload-post.com/mcp",
      "headers": {
        "Authorization": "ApiKey YOUR_API_KEY"
      }
    }
  }
}
Local

Local (stdio via npx)

The server runs on your machine, spawned by the AI client. Lower latency, single user.

  1. Install Node.js 18+.
  2. Paste the snippet below — npx downloads the server on first run.
  3. Restart your AI client.
mcp.json 
{
  "mcpServers": {
    "upload-post": {
      "command": "npx",
      "args": ["-y", "@upload-post/mcp"],
      "env": {
        "UPLOAD_POST_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

What the agent can do

40 tools, organized by domain. The agent picks them automatically based on your request.

Group Tools
Upload upload_video, upload_photos, upload_text, upload_document
Status get_status, get_job_status, get_history, get_media
Schedule list_scheduled, cancel_scheduled, edit_scheduled
Analytics get_analytics, get_total_impressions, get_post_analytics, get_platform_metrics
Users get_account_info, list_users, create_user, delete_user, generate_jwt, validate_jwt
Pages / boards get_facebook_pages, get_linkedin_pages, get_pinterest_boards, get_google_business_locations, select_google_business_location, get_reddit_detailed_posts
Comments get_post_comments, reply_to_comment, public_reply_to_comment
DMs send_dm, list_dm_conversations, manage_autodms
FFmpeg submit_ffmpeg_job, get_ffmpeg_job, download_ffmpeg_result, get_ffmpeg_consumption
Queue get_queue_settings, update_queue_settings, preview_queue

Platform deep dives: TikTok · Instagram · YouTube · LinkedIn · Facebook · X · Threads · Reddit · Bluesky · Pinterest · Google Business · Discord · Telegram

Try these in your AI client

The agent picks the right tools on its own.

“List the users in my Upload-Post account.”
“Publish this video URL to TikTok and Instagram under profile "marketing", caption: "Spring launch".”
“Schedule a text post on LinkedIn for next Monday at 10:00 Madrid time.”
“Show me analytics for profile "marketing" over the last month.”
“Reply privately to the latest comment on my Instagram post.”
“Trim this video to the first 30 seconds and upload it as a TikTok.”

Social media MCP server vs. traditional automation

Why connecting an AI agent beats wiring up Zapier, Make or a custom API integration.

Upload-Post MCP server Zapier / Make / custom API
How it runs The AI agent picks the right tool in real time from your prompt Fixed, pre-built workflows you wire up in advance
Setup One config block or a single CLI command — no code Build and maintain each automation or API integration
Interface Natural language, inside ChatGPT / Claude / Gemini Visual builder or custom code
Coverage 40 tools across 13+ social networks Per-action steps, configured platform by platform
Analytics & replies Ask for analytics or reply to comments conversationally Separate flows for each task
Cost Free, open-source (MIT) Paid task / operation tiers

Frequently asked questions

Everything about the Upload-Post social media MCP server. Last updated June 2026.

What is a social media MCP server?

A social media MCP server is a Model Context Protocol server that exposes social media actions — publishing, scheduling, analytics, comments and DMs — as tools an AI agent can call. Point your AI client at the Upload-Post MCP server and it can post to TikTok, Instagram, YouTube, LinkedIn, X and more without any custom code.

Can ChatGPT or Claude post to social media?

Yes. Connect ChatGPT, Claude, Gemini, Claude Code, OpenClaw or Hermes Agent to the Upload-Post MCP server and the assistant gains 40 tools to publish, schedule and analyze posts across 13+ social networks from a single natural-language prompt.

Which social networks does the MCP server support?

TikTok, Instagram, YouTube, LinkedIn, Facebook, X (Twitter), Threads, Reddit, Bluesky, Pinterest, Google Business, Discord and Telegram — all through one MCP server.

Is the Upload-Post MCP server free?

The MCP server is free and open-source under the MIT license, and it works with any Upload-Post plan, including the free tier. You only need an Upload-Post API key.

Do I need to write code to use it?

No. You paste one configuration block — or run a single CLI command — in your AI client, and the agent discovers and calls the right tools automatically. No SDK and no glue code.

How is an MCP server different from Zapier or Make?

Zapier and Make run fixed, pre-built automations. A social media MCP server lets the AI agent decide which tool to call in real time based on your request, so you publish, schedule or pull analytics conversationally instead of wiring up a flow.

Ready to plug Upload-Post into your AI?

Free to use with any Upload-Post plan. Open-source under MIT — audit, fork or self-host.

Get Started Free Read the docs