Skip to content
MCP connector

Set up the PostSpread MCP server

Steps for Claude, ChatGPT, Grok, Claude Code, code editors and your own agents, then every tool and each platform's media rules. Most clients take about a minute.

Introduction

The MCP server lets an AI assistant work in your PostSpread account: Claude, ChatGPT, Cursor or a bot you build. It can list your connected accounts, upload media, read analytics, and publish or schedule posts to any of your platforms.

Most clients take about a minute to set up.

Quick setup

Choose your AI platform below and follow the setup instructions:

Claude (Desktop & Web)

The quick way: PostSpread is in Claude's connector directory

Open the official listing, click Connect, and sign in to PostSpread when Claude asks. No URL to paste.

Open PostSpread in the Claude directory

Prefer to add it by hand, or on a plan without the directory? The steps below do the same thing.

Requirements

Setup steps

  1. 1 In Claude, click the Settings icon (⚙️)
  2. 2 Go to Connectors → Custom connectors
  3. 3 Click Add custom connector
  4. 4 Enter the connector URL:
https://mcp.postspread.com/mcp
  1. 5 Click Connect. A browser window opens for you to sign in to PostSpread
  2. 6 Log in to your PostSpread account and click Allow to authorize

Pro tip:

Once connected, just ask Claude naturally:

Schedule a post about our new product for tomorrow at 3pm across Instagram and Facebook

Or:

Show me last week's engagement metrics for all my posts

ChatGPT

The quick way: PostSpread is an official ChatGPT app

Open the official listing, add it, and sign in to PostSpread when ChatGPT asks. No Developer Mode and nothing to paste.

Open PostSpread in ChatGPT

The steps below add the same connector by hand through Developer Mode.

Requirements

Step 1: Turn on developer mode

  1. 1 Open ChatGPT
  2. 2 Click Settings (gear icon)
  3. 3 Go to Developer tab
  4. 4 Turn Developer Mode on

Step 2: Connect PostSpread

  1. 1 Go to ChatGPT Plugins
  2. 2 Click the + (New Plugin) button
  3. 3 Fill in the plugin details:
  • Name: PostSpread
  • Description: Manage and schedule social media posts across all platforms
  • Connection: Select "Server URL"
  • Server URL: https://mcp.postspread.com/mcp
  • Authentication: Select "OAuth"
  1. 4 Check "I understand and want to continue"
  2. 5 Click Create
  3. 6 You'll be redirected to log in to your PostSpread account
  4. 7 Click Allow to authorize ChatGPT to access your PostSpread account

Step 3: Start using it

Once connected, start a new chat and type:

@PostSpread  Show my connected social accounts.

Or ask naturally:

Schedule a post about our new product for tomorrow at 3pm on Instagram and Facebook

Grok

Requirements

Setup steps

  1. 1 Go to grok.com/connectors
  2. 2 Click New Connector and select "Custom"
  3. 3 Give it a preferred name: PostSpread
  4. 4 Enter the connector URL:
https://mcp.postspread.com/mcp
  1. 5 Click Connect. A browser window opens for you to sign in to PostSpread
  2. 6 Log in to your PostSpread account and click Allow to grant permissions

Tip: Grok only requests the permissions it needs. You can manage or revoke access anytime from your Grok settings.

Claude Code (CLI)

Requirements

Setup steps

  1. 1 Open your terminal and navigate to your Claude Code project directory
  2. 2 Add the PostSpread server with one command. The hosted server signs you in through your browser, so no token is needed:
claude mcp add --transport http postspread https://mcp.postspread.com/mcp

Prefer a local server with an API token? Run this instead (the token comes from Settings → API & connected apps):

claude mcp add postspread -e POSTSPREAD_API_TOKEN=your-postspread-api-token -- npx -y postspread-mcp
  1. 3 Run claude mcp list to confirm PostSpread is connected, then start a session: the tools are available straight away.

Example Usage:

Create a post announcing our new feature release and schedule it for tomorrow at 2pm on Twitter and LinkedIn

Note: Find your API token in PostSpread → Settings → API & connected apps.

Connecting AI code editors

Modern AI code editors like Cursor, Windsurf, and Zed natively support local MCP servers via stdio.

Setup steps

  1. 1 Open your editor's Settings (e.g. Cursor Settings → Features → MCP)
  2. 2 Click + Add New MCP Server
  3. 3 Set the type to command
  4. 4 Name it postspread and set the command to:
npx -y postspread-mcp
  1. 5 You will be prompted to enter your environment variables. Add your POSTSPREAD_API_TOKEN

Connecting custom web agents

If you are building your own custom AI agent (using LangChain, OpenClaw, Vercel AI, etc.) and want it to post to social media automatically, you can run this package as a hosted Streamable HTTP MCP server!

Setup steps

  1. 1 Clone this repository and deploy it to a Node.js server (e.g. Heroku, Vercel, Railway)
  2. 2 Start the server using node server.js (Defaults to Port 2407)
  3. 3 Point your @modelcontextprotocol/sdk client to http://your-server.com/mcp
  4. 4 Pass your user's PostSpread API Token in the HTTP Authorization headers on every request

Available AI tools

Once connected, your AI agent can use these 15 tools. Read-only tools run without asking; tools that publish, change or delete something ask you to confirm in Claude.

Posts and publishing

create_draft

Save a post as a draft. Nothing is published or scheduled. Pass the social account IDs from list_social_accounts. Asks no confirmation in Claude.

schedule_post

Schedule a post for a future date and time on the chosen accounts. It can still be edited or deleted before it goes out.

publish_post

Publish a post right away. This is public and cannot be undone, so Claude always asks you to confirm first.

list_posts

List your posts with optional filters by platform or status.

get_post

Get full details of a single post by ID.

update_post

Update a scheduled or draft post's caption, schedule, accounts, or media. Pass the social account IDs from list_social_accounts — the correct workspace is resolved automatically.

delete_post

Delete a scheduled or draft post. Published posts cannot be deleted.

Accounts and analytics

list_social_accounts

List all connected social media accounts with IDs, platforms, and usernames.

list_channels

List the channels of a connected Discord server or Slack workspace. Posts to those two platforms need a channel id.

get_analytics

Follower and post counts for every connected account, or per-post insights (views, likes, comments, shares) for one platform.

refresh_analytics

Pull fresh follower and post counts from the networks for your accounts.

list_post_results

How each platform answered a post: published, with its link, or turned away, with the reason.

Media management

upload_media

Upload media and get back a reusable media_id. Pass a public URL or raw base64 data.

list_media

List uploaded media files with IDs, URLs, and types.

delete_media

Delete an uploaded media file (only if not used by any post).

Platform media rules

The MCP Server strictly enforces platform media rules to ensure successful posting:

Platform Media requirements
YouTube 1 video required
TikTok 1 video, or 1+ images required
Instagram 1–10 images/videos required
Pinterest 1 image or video required
Twitter / X Up to 4 images, or 1 video (optional)
Telegram Text, up to 10 images/videos per message
Mastodon Up to 4 images or 1 video (optional)
Discord Up to 10 images/videos (optional); needs a channel
Slack Images only, up to 10 (optional); needs a channel
Threads Up to 4 images, or 1 video (optional)
Bluesky Up to 4 images, or 1 video (optional)
LinkedIn Up to 20 images, 1 video, or 1 PDF (optional)
Facebook 1 video, or 1+ images (optional)

Several workspaces

If you have several workspaces, pass the social account ids from list_social_accounts and PostSpread works out which workspace they belong to.

You never need a workspace_id.

npm package

The PostSpread MCP server is available as an npm package:

npm i postspread-mcp

View on npm →