SocialDispatch MCP Server
Allows publishing and scheduling posts to connected Facebook Pages, including media attachments and custom video thumbnails.
Allows publishing and scheduling posts to connected Instagram accounts.
Allows publishing and scheduling content to connected TikTok accounts.
Allows uploading and publishing YouTube videos, including titles, descriptions, tags, custom thumbnails, and scheduling.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@SocialDispatch MCP Server Schedule a post about our spring sale for tomorrow at 9am on Instagram and X"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
SocialDispatch Model Context Protocol (MCP) Server
The official Model Context Protocol (MCP) server for SocialDispatch.
Connects AI coding assistants and autonomous agents (such as Claude Desktop, Google Antigravity, Cursor, Windsurf, and Cline) directly to your social media accounts. Let AI agents manage, generate, schedule, and publish content across Facebook Pages, YouTube, TikTok, Instagram, and X (Twitter).
⚡ Quickstart
Prerequisites
SocialDispatch Account: Sign up at socialdispatch.site and connect your social profiles.
API Key: Generate an API key from your workspace settings (starts with
sd_live_...).Node.js:
v18.0.0or higher.
Related MCP server: PostMCP MCP Server
🛠️ Client Configuration
1. Claude Desktop
Add the following to your configuration file:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"socialdispatch": {
"command": "npx",
"args": ["-y", "@socialdispatch/mcp-server"],
"env": {
"SOCIALDISPATCH_API_URL": "https://api.socialdispatch.site",
"SOCIALDISPATCH_API_KEY": "sd_live_YOUR_API_KEY_HERE"
}
}
}
}Tip: You can also run directly from GitHub without installing:
"args": ["-y", "github:MahbbRah/socialdispatch-mcp"]
2. Google Antigravity / Gemini CLI
Add to ~/.gemini/config/mcp_config.json:
{
"mcpServers": {
"socialdispatch": {
"command": "npx",
"args": ["-y", "@socialdispatch/mcp-server"],
"env": {
"SOCIALDISPATCH_API_URL": "https://api.socialdispatch.site",
"SOCIALDISPATCH_API_KEY": "sd_live_YOUR_API_KEY_HERE"
}
}
}
}3. Cursor & Windsurf
Add to .cursor/mcp.json or your MCP Settings pane:
{
"mcpServers": {
"socialdispatch": {
"command": "npx",
"args": ["-y", "@socialdispatch/mcp-server"],
"env": {
"SOCIALDISPATCH_API_URL": "https://api.socialdispatch.site",
"SOCIALDISPATCH_API_KEY": "sd_live_YOUR_API_KEY_HERE"
}
}
}
}🧠 Agent Skill: One-Shot Publishing (/socialdispatch-publish)
This repository includes a pre-built agent skill at skills/socialdispatch-publish/SKILL.md.
It provides AI assistants with step-by-step procedures to post or schedule to Facebook, YouTube, Instagram, and X without code inspection or token burn. It handles:
YouTube uploads: Titles, video descriptions, tags, and custom video thumbnail pairing.
YouTube Shorts auto-detection: Correct aspect ratio & duration handling (
#Shorts).Multi-channel dispatch: Posting across Facebook Pages, Instagram, and X in a single command.
How to Install the Skill:
For Google Antigravity / Gemini CLI:
Copy the skill into your Gemini skills directory:
mkdir -p ~/.gemini/skills/socialdispatch-publish
cp skills/socialdispatch-publish/SKILL.md ~/.gemini/skills/socialdispatch-publish/Once installed, your agent automatically activates the skill whenever you ask to publish, or you can trigger it via the /socialdispatch-publish slash command.
For Cursor / Windsurf / Claude:
Copy the content of skills/socialdispatch-publish/SKILL.md into your .cursorrules, project rules, or Claude Project Custom Instructions.
🧰 Available Tools (14 Tools)
🚀 Publishing & Scheduling
Tool | Parameters | Description |
| (none) | Returns connected accounts (Facebook Pages, YouTube, TikTok, Instagram, X) with channel IDs, account names, and connection status. |
|
| Uses the SocialDispatch copywriting engine to write platform-optimized copy with appropriate hashtags and character limits. |
|
| Uploads local images ( |
|
| Immediately publishes to one or more connected channels with media attachments and custom video thumbnails. |
|
| Schedules a post for a specific ISO-8601 UTC timestamp or the next optimal posting slot. |
|
| One-shot tool: drafts tailored copy for the target channels and automatically publishes or schedules. |
|
| Fetches live publishing status, platform post links, and platform-specific error messages. |
|
| Retrieves recent posts, scheduled queues, and execution history. |
|
| Edits copy or reschedules a pending queued post. |
|
| Cancels and permanently deletes a scheduled post. |
💡 Content Pipeline & Workflow
Tool | Parameters | Description |
|
| Adds brainstorming ideas into your team's content ideation backlog. |
|
| Queries items in the production pipeline across stages: |
|
| Transitions an item forward in the pipeline with updated assets or review notes. |
|
| Picks up the highest-priority item ready for the next creation step. |
💻 Local Development & Contributing
1. Clone & Install
git clone https://github.com/MahbbRah/socialdispatch-mcp.git
cd socialdispatch-mcp
npm install2. Build TypeScript
npm run build3. Run Dev Server with Live Reload
export SOCIALDISPATCH_API_URL="https://api.socialdispatch.site"
export SOCIALDISPATCH_API_KEY="sd_live_..."
npm run dev4. Test via MCP Inspector
You can inspect and debug the tools interactively using the official MCP inspector:
npx @modelcontextprotocol/inspector node dist/index.js📄 License
This project is licensed under the MIT License.
Available Tools
14 toolsadd_content_ideasA
Batch adds new content ideas/plans into the SocialDispatch pipeline queue in IDEA stage. Allows brainstorming and researching batches of content ideas (up to 50 at once).
Inputs: ideas (required), accountId, workspaceId.
delete_social_postA
Delete a post from SocialDispatch. Supports deleting locally only, or deleting both locally and from connected live platforms (Facebook, X/Twitter, YouTube).
Inputs: postId (required), deleteFromPlatform.
generate_and_publish_postC
End-to-end AI agent action: Generates platform-tailored copies (Facebook, Instagram, X) from a topic and immediately publishes (or schedules) across target connections. Supports remote media URLs or local file paths directly.
Inputs: topic (required), accountIds (required), tone, linkUrl, +4 more.
generate_social_contentA
Generate platform-tailored social media post drafts for Facebook, Instagram, and X (Twitter) from a topic, idea, or link using SocialDispatch AI copywriting engine.
Inputs: topic (required), tone, linkUrl.
get_next_pipeline_itemB
Retrieves the next oldest or prioritized ungenerated content item from the pipeline queue to resume work where left off across sessions.
Inputs: stage, accountId, workspaceId.
get_post_statusA
Check publication status, external live URLs, and execution logs for a specific post in SocialDispatch.
Inputs: postId (required).
list_content_pipelineB
Returns current queued items in the SocialDispatch content pipeline, showing counts and progress (e.g. 3 generated, 7 pending ideas).
Inputs: limit, stage, accountId, workspaceId.
list_recent_postsA
List recent posts in SocialDispatch to see publishing history, scheduled queue items, and statuses.
Inputs: limit, status.
list_social_connectionsA
List all connected social media accounts/pages (Facebook Pages, Instagram, X/Twitter, TikTok, YouTube) in SocialDispatch. Returns connection IDs, names, platforms, and connection status.
Inputs: platform.
publish_social_postB
Publish a social post immediately across one or more connected social accounts in SocialDispatch. Supports remote media URLs or local file paths directly.
Inputs: accountIds (required), tags, title, content, +11 more.
schedule_social_postB
Schedule a social post for a specific future date/time or into the next scheduled queue slot. Supports remote media URLs or local file paths directly.
Inputs: accountIds (required), tags, title, content, +13 more.
update_content_progressA
Updates progress of a content item after script generation or media rendering (transitions stage to SCRIPTED, GENERATING, or GENERATED, and attaches script or media).
Inputs: stage (required), itemId (required), script, mediaUrl, +2 more.
update_social_postB
Update or edit a post content or schedule in SocialDispatch. If the post is already published, you can optionally set updateOnPlatform=true to sync the update to supported live platforms (Facebook Page, YouTube).
Inputs: postId (required), tags, title, content, +8 more.
upload_mediaA
Upload a local image or video file directly to SocialDispatch and its enabled storage (Cloudflare R2 or local storage). Returns the public media URL, storage provider, and metadata to use for publishing.
Inputs: filePath (required), fileName.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 14 tools
Most tools map to a distinct resource+action (list connections, upload media, publish, schedule, update, delete, status, pipeline ops). The only real overlap is between generate_and_publish_post and the pair generate_social_content + publish_social_post, which do the same work in one call versus two; descriptions make the distinction clear but an agent could still hesitate. update_social_post vs update_content_progress target different objects (posts vs pipeline items) and are adequately separated by wording.
Every tool follows a consistent snake_case verb_noun pattern: list_*, get_*, generate_*, upload_*, publish_*, schedule_*, update_*, delete_*, add_*. The compound generate_and_publish_post is a slight deviation but still readable and follows the same convention.
14 tools sit comfortably in the well-scoped range and each covers a distinct stage of the workflow (connections, generation, media, publishing, scheduling, post CRUD, pipeline). Nothing appears redundant or padded beyond the single convenience wrapper.
Post lifecycle is fully covered (publish, schedule, list, status, update, delete) and the AI pipeline has ideas, listing, progress, and next-item retrieval. Gaps remain: connections are read-only (no connect/disconnect/refresh), media has upload but no list/delete, and there is no analytics/engagement retrieval for published posts, so agents cannot close the measurement loop.
Related MCP Connectors
Schedule and publish posts and short videos to every major social platform from any AI agent.
Schedule and publish social posts from your AI to Facebook, Instagram, TikTok and more.
Social media API for AI agents: publish, DMs, comments, Meta ads and leads.
Post and schedule to Instagram, Facebook, YouTube, TikTok, LinkedIn and X from your AI app.
Related MCP Servers
- AlicenseAqualityBmaintenanceOfficial MCP server for PostEverywhere (posteverywhere.ai/social-media-scheduler). Let Claude, ChatGPT, Cursor or any MCP client schedule and publish posts to 13 platforms: Instagram, TikTok, YouTube, LinkedIn, Facebook, X, Threads, Pinterest, Bluesky, Telegram, Discord, WordPress and Google Business Profile. 40 tools: best-time scheduling, threads, cross-posting, campaigns, analytics.33289 npm7MIT

PostMCP MCP Serverofficial
AlicenseAqualityBmaintenanceEnables AI assistants to manage social media publishing across platforms like LinkedIn, Twitter, Facebook, Instagram, Threads, and Bluesky.754 npmMIT- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to draft, schedule, and publish social media content, generate AI text and image variations, analyze performance, and automate social workflows.MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to upload and schedule videos, images, carousels, and text posts across 17 social platforms, read analytics, and reply to comments through a hosted OAuth connection.MIT