Skip to main content
Glama
SocialDispatch MCP Server

SocialDispatch MCP Server

by MahbbRah

SocialDispatch Model Context Protocol (MCP) Server

MCP License: MIT Node.js Version

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

  1. SocialDispatch Account: Sign up at socialdispatch.site and connect your social profiles.

  2. API Key: Generate an API key from your workspace settings (starts with sd_live_...).

  3. Node.js: v18.0.0 or 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.json

  • Windows: %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

list_social_connections

(none)

Returns connected accounts (Facebook Pages, YouTube, TikTok, Instagram, X) with channel IDs, account names, and connection status.

generate_social_content

topicPrompt, targetPlatforms, tone

Uses the SocialDispatch copywriting engine to write platform-optimized copy with appropriate hashtags and character limits.

upload_media

filePath

Uploads local images (png, jpg, webp) or videos (mp4, mov) to SocialDispatch storage. Returns the CDN URL.

publish_social_post

channelIds, content, mediaUrls, videoThumbnailUrl

Immediately publishes to one or more connected channels with media attachments and custom video thumbnails.

schedule_social_post

channelIds, content, scheduledFor, mediaUrls, videoThumbnailUrl

Schedules a post for a specific ISO-8601 UTC timestamp or the next optimal posting slot.

generate_and_publish_post

topicPrompt, channelIds, scheduleTime

One-shot tool: drafts tailored copy for the target channels and automatically publishes or schedules.

get_post_status

postId

Fetches live publishing status, platform post links, and platform-specific error messages.

list_recent_posts

limit, channelId

Retrieves recent posts, scheduled queues, and execution history.

update_social_post

postId, content, scheduledFor

Edits copy or reschedules a pending queued post.

delete_social_post

postId

Cancels and permanently deletes a scheduled post.


💡 Content Pipeline & Workflow

Tool

Parameters

Description

add_content_ideas

ideas (title, notes, platforms)

Adds brainstorming ideas into your team's content ideation backlog.

list_content_pipeline

stage, limit

Queries items in the production pipeline across stages: IDEA, SCRIPT, FOOTAGE, EDITING, REVIEW, SCHEDULED.

update_content_progress

itemId, stage, notes, mediaUrls

Transitions an item forward in the pipeline with updated assets or review notes.

get_next_pipeline_item

stage

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 install

2. Build TypeScript

npm run build

3. Run Dev Server with Live Reload

export SOCIALDISPATCH_API_URL="https://api.socialdispatch.site"
export SOCIALDISPATCH_API_KEY="sd_live_..."

npm run dev

4. 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 tools
add_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

    A3.7/5.0

    Scored across 14 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Official 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.
      33
      289 npm
      7
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI assistants to manage social media publishing across platforms like LinkedIn, Twitter, Facebook, Instagram, Threads, and Bluesky.
      7
      54 npm
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables 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