Integration Guide Open Source

Upload-Post MCP Server Connect Claude, Cursor & any AI agent

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.

Get my API Key View on GitHub

~/.claude/mcp.json

{
  "mcpServers": {
    "upload-post": {
      "url": "https://mcp.upload-post.com/mcp",
      "headers": {
        "Authorization": "ApiKey YOUR_API_KEY"
      }
    }
  }
}

What is MCP?

The Model Context Protocol is an open standard that lets AI assistants discover and call external tools through a single uniform interface. Instead of writing code, you give the assistant access to a server and it figures out which tools 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.

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.

Grab your API key at app.upload-post.com → API Keys.
Paste the snippet below into your AI client config.
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.

Install Node.js 18+.
Paste the snippet below — npx downloads the server on first run.
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

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.”