Broadside
Publishes posts to a connected Bluesky account, with validation against Bluesky limits and support for scheduling, drafts, and retries.
Sends posts to Discord through a connected account, with pre-send validation, scheduling, and per-target delivery status.
Publishes to connected Facebook Pages, checking network limits before sending and supporting scheduling and retries.
Publishes to Instagram accounts, including media attachments where a public URL is available, with validation and scheduling.
Posts to Lemmy through a connected account, with rule checks, scheduling, and delivery tracking.
Receives Broadside posts through the generic webhook destination, allowing posts to trigger Make automations.
Publishes to a Mastodon account, validating against network limits and supporting scheduling and retries.
Receives Broadside posts through a webhook destination to trigger n8n workflows.
Publishes pins to Pinterest with validation and scheduling; trial-access pins may be visible only to the account owner.
Posts to Reddit through a connected account, with validation, scheduling, and delivery tracking.
Sends posts to Slack through a connected account, with validation and scheduled delivery.
Publishes to Telegram through a connected account, with validation and scheduled delivery.
Publishes to Threads, including media fetched from public URLs, with token refresh on posting and per-target status.
Publishes to TikTok as private or inbox drafts until the app is approved, with validation and scheduling.
Publishes to YouTube through a connected account, with validation and scheduled delivery.
Receives Broadside posts through the generic webhook destination, enabling Zapier-triggered workflows.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
One post. Every network. Broadside is a free, open-source app that publishes one post to many social networks at once, from your browser or from an AI agent over MCP. It runs on your machine, with your own keys.
A broadside is a single printed sheet posted in public, and a ship firing every gun at once. Both fit.
What it does
Posts to 18 destinations at once: X, Bluesky, Threads, Mastodon, LinkedIn, Instagram, Facebook Pages, TikTok, YouTube, Pinterest, Reddit, Telegram, Discord, Slack, Nostr, Lemmy, DEV and any webhook (Zapier, n8n, Make, your own server). A sandbox destination lets you rehearse without posting anywhere.
Refuses instead of trimming. Every account is checked against its network's rules before anything is sent. If one copy would be cut or rejected, nothing goes out and you are told which network and by how much. Give that account its own version and send again.
Schedules, drafts and retries. One failing network never holds up the others, each target has its own status and public link, and a single failed target can be retried alone.
Is an MCP server. Claude, Cursor, Codex or any MCP client can list accounts, check a post, publish, schedule and confirm delivery. Credentials are never passed through chat.
Is one process and one file. Node and a SQLite file. No queue, no database server, no account with anyone.
Related MCP server: @chirpie/mcp
Run it
Needs Node 22.5 or newer.
git clone https://github.com/Balackburn/broadside.git
cd broadside
npm install
npm run build
npm startOpen http://localhost:3000, go to Accounts, and connect a network (or add the sandbox). Then write a post in Compose.
For development: npm run dev. To prove the whole thing works end to end: npm run verify.
Connect an agent
Create a key under Connect in the app, then:
claude mcp add --transport http broadside http://localhost:3000/mcp --header "Authorization: Bearer bs_your_key"Any Streamable HTTP client works with the same URL and header. A local stdio server is also included; it needs no key and can read media from your disk:
{ "mcpServers": { "broadside": { "command": "npx", "args": ["tsx", "/path/to/broadside/bin/broadside-mcp.ts"] } } }Tools: list_platforms, list_accounts, connect_account, disconnect_account, upload_media, list_media, check_post, create_post, get_post, list_posts, update_post, publish_post, cancel_post, retry_target, delete_post.
REST API
The same engine over HTTP, under /api/v1, with the key as a Bearer token.
curl http://localhost:3000/api/v1/posts \
-H "Authorization: Bearer bs_your_key" -H "Content-Type: application/json" \
-d '{"content": "Hello", "targets": [{"account_id": "acc_…"}], "publish_at": "2026-12-01T09:00:00+01:00"}'Method and path | Does |
| Networks, limits and credential fields |
| Connected accounts |
| Upload (multipart |
| Dry run against each account's rules |
| Create (send an |
| Act on a post |
| API keys |
Responses are { "data": … } or { "error": { "code", "message", "details" } }.
Networks and what you bring
You connect each account with credentials you create yourself; the app shows the steps for each network. They are encrypted at rest (AES-256-GCM) and never returned by the API.
Simple (a token, password or URL) | Needs your own developer app |
Bluesky, Mastodon, Telegram, Discord, Slack, Nostr, Lemmy, DEV, Reddit, Webhook | X, Threads, LinkedIn, Instagram, Facebook Pages, TikTok, YouTube, Pinterest |
Things worth knowing before you rely on a network:
These connectors are tested against each network's documented API shapes, not against the live networks.
npm run verifyexercises Mastodon, Bluesky, Discord, Telegram, Slack and the webhook against local stand-ins; the rest are covered by request-shape tests. Try a new account with one post before scheduling many.Instagram, Threads, Slack, DEV, Nostr and TikTok photos fetch media from a public URL. Set
BROADSIDE_PUBLIC_URLto where this app is reachable from the internet, or attach media by URL.TikTok and Pinterest restrict unapproved apps: TikTok posts are private or inbox drafts until the app is audited; Pinterest trial-access pins are visible only to you.
LinkedIn tokens last 60 days and are pasted by hand, so that account needs reconnecting every two months. Threads tokens are refreshed each time Broadside posts.
Not supported yet: video on X, LinkedIn and Facebook; threads and reply chains; first comments; stories; analytics; editing or deleting a post after it is published.
Configuration
Variable | Purpose |
| Require a password for the web app. Set it before exposing Broadside to a network; without it, anyone who can reach the app can post. |
| The public address of this app, used for media that networks fetch and for links handed to agents. |
| Where the database, uploads and encryption key live. Default |
| Key material for encrypting credentials. Default: a key file created in the data folder. |
| A fixed API key for headless installs. |
| How often the scheduler looks for due posts. Default 5000. |
| Largest accepted upload. Default 512. |
How it is built
src/lib/platforms/holds one connector per network: its credential fields, limits and the HTTP calls that publish. Connectors never touch the database, so each is tested with a fakefetch.src/lib/posts.tsis the engine: validate, fan out, record a status per target, retry transient failures. A target is claimed with a compare-and-set before it is sent, so two clocks can never post it twice, and a target interrupted mid-send is failed rather than resent.src/lib/mcp.tsdefines the tools once;/mcp(HTTP) andbin/broadside-mcp.ts(stdio) both serve them.src/lib/scheduler.tsis an in-process clock started with the server.
Adding a network is one object that implements Connector in src/lib/platforms/types.ts, plus a line in the registry and a request-shape test.
Licence
MIT. Free, with no plans, seats or quotas, and no service in the middle.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Connect any AI agent to 11+ social platforms: schedule, publish & track posts via hosted MCP.
Agent-first social media publishing, scheduling, analytics, and unified inbox API + 16-tool MCP server across 18 social platforms (X, LinkedIn, Instagram, YouTube, TikTok, Threads, Bluesky, Reddit, Telegram, Discord, Mastodon, Facebook, Pinterest).
Draft and schedule social media posts on your connected channels from Claude or any MCP client.
Schedule and publish social posts across 9 platforms (Instagram, LinkedIn, X, TikTok, Facebook, Threads, Pinterest, Bluesky, Mastodon) straight from Claude, ChatGPT, Cursor, or any MCP client. Create, edit, and reschedule posts, upload media, and pull account and post analytics, follower demographics, and best-time windows. 20 tools, free on every plan.
Related MCP Servers
AlicenseAqualityBmaintenanceEnables managing social media posts, accounts, and AI-powered content features from any MCP client, including scheduling, publishing, analysis, and AI caption generation.1430 npmMIT- AlicenseNot gradedqualityBmaintenanceEnables AI agents to post, schedule, thread, delete, and analyze social media posts across platforms like X, Bluesky, LinkedIn, and Instagram through a single MCP interface.107 npmMIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents and MCP clients to connect their own social accounts via OAuth and publish or schedule posts through a small provider-agnostic interface using official platform APIs.MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to write social posts in a brand's voice for up to four platforms, schedule or cancel them, list brands and channels, and read results, all with human approval before anything is published. Connects via OAuth or API key so posts can be planned and managed from Claude, ChatGPT, Cursor, and other MCP clients.MIT