Social Broadcast MCP
Allows publishing posts with images or videos to Facebook Pages or profiles via the Meta Graph API, using your own OAuth credentials and the pages_manage_posts permission.
Allows publishing images, videos, Reels, and Stories to Instagram Business or Creator accounts linked to a Facebook Page via the Meta Graph API.
Allows uploading videos to YouTube with configurable visibility (private, unlisted, or public) via the YouTube Data API v3.
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., "@Social Broadcast MCP Post this video to my YouTube channel and Instagram Reels"
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.
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: instagram-mcp
Platforms
Platform | Status | API | Media | Notes |
✅ | Meta Graph API | image, video | Page or profile with | |
✅ | Meta Graph API | image, video, Reels, Stories | Requires a Business/Creator account linked to a FB page | |
YouTube | ✅ | Meta Graha API | video | Uploads with |
TikTok | 🔜 | API de Contenido Público de TikTok | video | Requires TikTok audit (2–6 weeks); pattern documented in |
X/Twitter | ⚠️ | API v2 | image, video | X's free tier is very limited; documented in |
Installation
git clone https://github.com/tu-usuario/social-broadcast-mcp.git
cd social-broadcast-mcp
npm install
npm run buildConfiguration 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 stepdocs/SETUP_YOUTUBE.md— Google Cloud project + OAuthdocs/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/with0600permissions.They are never sent to any external server.
No reducing telemetry. No analytics. Nothing that calls home.
Check
src/auth/store.tsto 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.
Available Tools
6 toolsconnect_metaA
Inicia el flujo OAuth para conectar Facebook e Instagram. Requiere clientId (y clientSecret opcional) de tu app en developers.facebook.com. Abre el navegador para autorizar.
Inputs: clientId (required), scopes, clientSecret.
connect_youtubeB
Inicia el flujo OAuth para conectar YouTube. Requiere clientId y clientSecret de tu proyecto en Google Cloud Console.
Inputs: clientId (required), clientSecret (required), scopes.
list_accountsB
Lista las cuentas de redes sociales conectadas
Inputs: platform.
list_platformsA
Lista las plataformas soportadas y sus capacidades
Inputs: no named parameters.
publish_postB
Publica o programa un post en una cuenta conectada
Inputs: content (required), accountId (required), mediaUrls, scheduledAt, +1 more.
refresh_accountsB
Refresca la lista de cuentas de una plataforma ya conectada
Inputs: platform (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
The tool purposes are mostly distinct: platform listing, account listing, platform connection, refresh, and publishing are separate workflows. The only mild overlap is between list_accounts and refresh_accounts, but their descriptions make the difference understandable.
All tool names are in snake_case and follow a verb_noun pattern, which is consistent. Minor deviation is that connect_meta and connect_youtube use platform/brand fragments rather than the generic verb_noun style, but the overall pattern remains clear.
Six tools is well-scoped for a social broadcast server focused on connecting platforms and publishing posts. Every tool covers a meaningful action without unnecessary redundancy.
The core lifecycle is mostly covered: list platforms, connect accounts, list/refresh accounts, and publish or schedule posts. Missing disconnect functionality and scheduled-post management are noticeable gaps, but they do not block the primary broadcasting workflow.
Maintenance
Related MCP Connectors
Publish and analyze posts on Instagram, Facebook, TikTok, YouTube, X, and Bluesky.
Publish to your YouTube and Instagram accounts: schedule posts, read analytics and manage comments.
Schedule and publish posts to Facebook, Instagram, LinkedIn, Google Business, X, YouTube and TikTok.
Publish, schedule and analyze social posts on Instagram, Facebook, TikTok, YouTube and more.
Related MCP Servers
- FlicenseNot gradedqualityBmaintenanceEnables publishing and managing organic Facebook Page and Instagram content directly through Meta's Graph API without paid third-party services.-
- AlicenseBqualityBmaintenanceEnables reading, publishing, commenting on, and analyzing Instagram Business/Creator accounts through the official Graph API, with multi-account support and an optional self-hosted publishing panel.29MIT
- AlicenseAqualityCmaintenanceEnables direct management of Facebook Pages and linked Instagram Business/Creator accounts through the official Meta Graph API, including posting, scheduling, reading and responding to comments, and viewing insights.20MIT
- AlicenseAqualityCmaintenanceEnables AI assistants and autonomous agents to connect to social media accounts and manage, generate, schedule, upload media for, and publish content across Facebook Pages, YouTube, TikTok, Instagram, and X, plus maintain a content pipeline.14MIT