bulkpublish-social-scheduling

1# Social Publishing via BulkPublish
2 
3Cross-platform scheduling and publishing through one API. Unlike per-platform skills, this
4targets many networks in a single call, with each platform's rules enforced up front.
5 
6## Setup
7 
8**MCP (recommended)** — hosted server, no install:
9 
10```bash
11claude mcp add --transport http bulkpublish https://mcp.bulkpublish.com/mcp
12```
13 
14Add it as a custom connector and OAuth 2.1 walks you through consent — no key in the URL.
15 
16**Or the npm server (stdio):**
17 
18```bash
19claude mcp add bulkpublish --env BULKPUBLISH_API_KEY=bp_your_key -- npx -y @bulkpublish/mcp-server
20```
21 
22**Or plain REST:** `https://app.bulkpublish.com/api`, spec at
23`https://app.bulkpublish.com/openapi.json`, docs at `https://app.bulkpublish.com/docs`.
24 
25Get an API key at [app.bulkpublish.com/developer](https://app.bulkpublish.com/developer) and
26send it as `Authorization: Bearer <key>`. API and MCP access are on every plan, free included.
27 
28## Workflow
29 
301. `list_channels` — get connected accounts with their `channelId` and `platform`. Do this
31   first; never guess a channel id.
322. Check the platform rules below (or `get_channel_options`) before composing.
333. Upload media if needed — `upload_media` takes a public `url` or a local `filePath`, and
34   returns the id you pass in `mediaFileIds`.
354. `create_post` with `content`, `channels`, and `status: "scheduled"` plus `scheduledAt`
36   (or leave it a draft, then `publish_post` when the user confirms).
37…