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

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.

🛠️ 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

💡 Content Pipeline & Workflow

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