Social Broadcast MCP

MCP server open source (MIT) for publishing to social media (Facebook, Instagram, YouTube) using the official APIs of each platform, with your own OAuth credentials.

No central service. No plans. No artificial limits. No payment middlemen.

Why does it exist?

SaaS tools (SocialCannon, PostFast, Buffer...) charge a monthly subscription and impose limits (accounts, posts, media uploads). This project does the same thing —posting from an AI agent (Hermes, Claude, etc.)— but each user connects their own accounts with their own developer apps. Free forever.

⚠️ Key difference vs SaaS: they already have apps approved by Meta/Google with full review. Here you create your own app (for free) and use it for your own accounts. That is valid for personal/own business use, and it avoids Meta App Review, which is only required for public access to third-party accounts.

Related MCP server: @posteverywhere/mcp

Platforms

Installation

git clone https://github.com/tu-usuario/social-broadcast-mcp.git
cd social-broadcast-mcp
npm install
npm run build

Configuration in Hermes (or any MCP client)

# ~/.hermes/config.yaml (o config del perfil)
mcp_servers:
  social-broadcast:
    command: "node"
    args: ["/ruta/a/social-broadcast-mcp/dist/index.js"]

Or in any compatible MCP client:

{
  "mcpServers": {
    "social-broadcast": {
      "command": "node",
      "args": ["/ruta/a/social-broadcast-mcp/dist/index.js"]
    }
  }
}

Usage

1. Connect Facebook and Instagram

You need to create an app at developers.facebook.com (see docs/SETUP_META.md) and get:

• App ID (clientId)

• App Secret (clientSecret, only needed in development)

Then, from the agent:

connect_meta(clientId: "TU_APP_ID", clientSecret: "TU_APP_SECRET")

The browser opens → you authorize with your account → the accounts will be saved locally in the process.

2. Connect YouTube

Create a project in Google Cloud Console with the YouTube Data API v3 (see docs/SETUP_YOUTUBE.md):

connect_youtube(clientId: "TU_CLIENT_ID", clientSecret: "TU_CLIENT_SECRET")

3. See connected accounts

list_accounts()

4. Publish

publish_post(
  accountId: "fb:533433607139839",
  content: "🌀 CREA TU PROPIO GONG 🌀\nUn gong hecho por ti, para ti, como tú.",
  mediaUrls: ["https://tudominio.com/imagen.jpg"],
  platformOptions: { "mediaType": "REELS" }  // para Reels de IG
)

To schedule it instead of publishing right away, add scheduledAt: "2026-09-01T18:00:00+01:00".

Note about media: the API accepts public URLs. For local files, host them somewhere reachable (an S3/GCS bucket, your website, or an exposed local server) and use that URL. A direct-upload helper is on the roadmap.

Documentation

• docs/SETUP_META.md — create the Meta app step by step

• docs/SETUP_YOUTUBE.md — Google Cloud project + OAuth

• docs/TIKTOK.md — what the TikTok integration would look like (audit required)

• docs/SECURITY.md — local token management and best practices

Security

• Tokens are stored locally in ~/.social-broadcast-mcp/ with 0600 permissions.

• They are never sent to any external server.

• No reducing telemetry. No analytics. Nothing that calls home.

• Check src/auth/store.ts to see exactly what gets stored.

License

MIT — free to use, copy, modify, and redistribute. Made for the community, out of the real experience of posting the Templo del Gong calendar (Vilagarcía de Ars) news.

Disclaimer

This project is not affiliated with Meta, Google, TikTok, or X Corp. The names belong to their respective owners. Use of the APIs is subject to each platform's terms of service.