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 directoryPrefer to add it by hand, or on a plan without the directory? The steps below do the same thing.
Requirements
- Claude account (Desktop app or claude.ai)
- PostSpread account
Setup steps
- 1 In Claude, click the Settings icon (⚙️)
- 2 Go to Connectors → Custom connectors
- 3 Click Add custom connector
- 4 Enter the connector URL:
https://mcp.postspread.com/mcp
- 5 Click Connect. A browser window opens for you to sign in to PostSpread
- 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 ChatGPTThe steps below add the same connector by hand through Developer Mode.
Requirements
- ChatGPT account (ChatGPT free or paid)
- Developer Mode enabled
- PostSpread account
Step 1: Turn on developer mode
- 1 Open ChatGPT
- 2 Click Settings (gear icon)
- 3 Go to Developer tab
- 4 Turn Developer Mode on
Step 2: Connect PostSpread
- 1 Go to ChatGPT Plugins
- 2 Click the + (New Plugin) button
- 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"
- 4 Check "I understand and want to continue"
- 5 Click Create
- 6 You'll be redirected to log in to your PostSpread account
- 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
- Grok account (access at grok.com)
- PostSpread account
Setup steps
- 1 Go to grok.com/connectors
- 2 Click New Connector and select "Custom"
- 3 Give it a preferred name: PostSpread
- 4 Enter the connector URL:
https://mcp.postspread.com/mcp
- 5 Click Connect. A browser window opens for you to sign in to PostSpread
- 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
- Claude Code CLI installed
- PostSpread account
- Your PostSpread API Token
Setup steps
- 1 Open your terminal and navigate to your Claude Code project directory
- 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
-
3
Run
claude mcp listto 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 Open your editor's Settings (e.g. Cursor Settings → Features → MCP)
- 2 Click + Add New MCP Server
- 3 Set the type to command
- 4 Name it postspread and set the command to:
npx -y postspread-mcp
- 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 Clone this repository and deploy it to a Node.js server (e.g. Heroku, Vercel, Railway)
-
2
Start the server using
node server.js(Defaults to Port 2407) -
3
Point your @modelcontextprotocol/sdk client to
http://your-server.com/mcp - 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
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 a post for a future date and time on the chosen accounts. It can still be edited or deleted before it goes out.
Publish a post right away. This is public and cannot be undone, so Claude always asks you to confirm first.
List your posts with optional filters by platform or status.
Get full details of a single post by ID.
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 a scheduled or draft post. Published posts cannot be deleted.
Accounts and analytics
List all connected social media accounts with IDs, platforms, and usernames.
List the channels of a connected Discord server or Slack workspace. Posts to those two platforms need a channel id.
Follower and post counts for every connected account, or per-post insights (views, likes, comments, shares) for one platform.
Pull fresh follower and post counts from the networks for your accounts.
How each platform answered a post: published, with its link, or turned away, with the reason.
Media management
Upload media and get back a reusable media_id. Pass a public URL or raw base64 data.
List uploaded media files with IDs, URLs, and types.
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 |
| 1–10 images/videos required | |
| 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) |
| Up to 20 images, 1 video, or 1 PDF (optional) | |
| 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