postbuzz-mcp
postbuzz-mcp exposes 51 MCP tools for managing post.buzz social publishing from an MCP client.
Diagnose setup, API key/connectivity, connected accounts, quota, and discover per-platform post schemas.
View organization plan/usage and manage connected social accounts: list/get, OAuth connect URL, disconnect, refresh tokens, and run account-specific lookups like Reddit flairs or Pinterest boards.
Create, schedule, list, inspect, update, delete, retry, and reschedule posts with captions, media, threads, first comments, polls, and per-account overrides.
Manage immediate/scheduled comments and replies, including edit, delete, and retry.
Work the inbox: list comments/mentions/DMs, reply, and edit replies where supported (currently Facebook).
Upload, list, inspect, and delete media from public URLs or local file paths where available; hosted mode accepts URLs only.
Get post/account/bulk analytics, refresh analytics, view summaries, and find best posting times.
Manage teams and assign/remove team accounts.
Bulk-create posts from CSV and inspect/retry import jobs and failed rows.
Enables posting, scheduling, and analyzing Pinterest content, including board selection through account tools and per-platform field overrides.
Enables posting, scheduling, and analyzing Reddit content, with Reddit-specific capabilities such as subreddit targeting and flair selection via account tools.
Enables posting, scheduling, and analyzing TikTok content, with TikTok-specific settings such as privacy controls via account overrides.
Enables posting, scheduling, and analyzing YouTube content, with YouTube-specific settings such as madeForKids configuration via account overrides.
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., "@postbuzz-mcp Schedule a tweet about our new blog post for tomorrow at 9 AM"
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.
postbuzz-mcp
MCP (Model Context Protocol) server for the post.buzz social media API — post, schedule, and analyze across 16+ platforms from Claude Desktop, Claude Code, Cursor, or any MCP client.
A thin, transport-agnostic wrapper over the official postbuzz SDK, mirroring postbuzz-cli. Requires Node.js 20+.
Setup
Create an API key at post.buzz → Settings → API Keys (sx_live_…), then configure your client:
Claude Desktop
~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"postbuzz": {
"command": "npx",
"args": ["-y", "postbuzz-mcp"],
"env": { "POSTBUZZ_API_KEY": "sx_live_..." }
}
}
}Claude Code
claude mcp add postbuzz -e POSTBUZZ_API_KEY=sx_live_... -- npx -y postbuzz-mcpCursor
~/.cursor/mcp.json:
{
"mcpServers": {
"postbuzz": {
"command": "npx",
"args": ["-y", "postbuzz-mcp"],
"env": { "POSTBUZZ_API_KEY": "sx_live_..." }
}
}
}Configuration
Env var | Flag | Required | Purpose |
|
| yes | API key |
|
| no | API base URL (default |
Test interactively with the MCP Inspector:
npx @modelcontextprotocol/inspector node dist/index.jsRelated MCP server: social-mic-mcp
Tools (51)
Diagnostics — check_setup (run it first), describe_platform (per-platform field schemas; call before create_post).
Organization — get_organization, get_usage.
Accounts — list_accounts, get_account, connect_account (OAuth URL), disconnect_account, refresh_account, list_account_tools, run_account_tool (Reddit flairs / Pinterest boards).
Posts — create_post, schedule_post, list_posts, get_post, update_post, delete_post, retry_post, reschedule_post.
Comments — create_comment (immediate or scheduled; parentCommentId chains replies), list_comments, get_comment, update_comment, delete_comment, retry_comment.
Inbox — list_inbox (comments/mentions/DMs), reply_to_inbox_item, edit_inbox_reply.
Media — upload_media (public URL or local image/video/PDF path — other file types are refused), list_media, get_media, delete_media, delete_media_many.
Analytics — get_post_analytics, get_account_analytics, get_bulk_post_analytics (≤ 60 posts), refresh_analytics, get_analytics_summary, get_best_times.
Teams — list_teams, get_team, create_team, update_team, delete_team, add_team_account, remove_team_account.
CSV import — create_post_csv_import, list_post_csv_imports, get_post_csv_import, get_post_csv_import_rows, retry_post_csv_import.
Clipping — create_clip (long video → short clips, async, idempotent), list_clips, get_clip, get_clip_usage.
Every tool carries MCP annotations: get_*/list_*/describe_* are readOnlyHint, delete_*/disconnect_*/remove_* are destructiveHint, so clients can auto-approve reads and confirm deletes.
Targeting & per-platform fields
Posts target accounts by id (list_accounts); per-platform required fields (Reddit sr-style lookups, Pinterest boards, TikTok privacy, YouTube madeForKids…) are discovered via describe_platform + run_account_tool and passed through accountOverrides[{ accountId, fields }].
Errors
Tool failures return { "error": { "code", "message", "details"? } } as text content with isError: true — the same envelope the REST API and CLI emit.
Hosted endpoint
post.buzz also serves these tools at https://post.buzz/api/mcp
(Streamable HTTP), so no local install is needed:
claude mcp add --transport http postbuzz https://post.buzz/api/mcp \
--header "Authorization: Bearer sx_live_…"The hosted server has no access to your files: upload_media takes URLs only.
Embedding
postbuzz-mcp/server exports createServer(options) and
handleMcpRequest(request, options) — the latter serves one stateless
Streamable HTTP request with Web-standard Request/Response, for hosting
the tools on Workers, Deno, Bun, or any fetch-style server.
Development
bun install
bun run build # tsup → dist/index.js
bun run test # vitest: MCP client over in-memory transport (manifest + flows)
node test/live-stdio.mjs # live integration over real stdio (needs POSTBUZZ_API_KEY)createServer({ apiKey, apiUrl? }) (exported from dist/index.js) builds the transport-agnostic McpServer.
License
MIT
Available Tools
55 toolsadd_team_accountAdd team accountC
Assign an account to a team.
Inputs: teamId (required), accountId (required).
check_setupCheck setupARead-only
Verify the API key, connectivity, connected accounts, and quota. Run this first before any other tool.
Inputs: no named parameters.
connect_accountConnect accountA
Build the OAuth authorize URL for a platform; the user opens it in a browser to connect.
Inputs: platform (required), client.
create_clipCreate clipsA
Cut a long video (YouTube or public URL) into short vertical clips, optionally auto-posting them to channelIds. Async — poll get_clip. Consumes clipping minutes (get_clip_usage).
Inputs: url (required), idempotencyKey (required), fit, maxClips, +1 more.
create_commentCreate commentA
Create a comment on a post by the given account. Omit scheduledAt to publish immediately; pass parentCommentId to reply to another scheduled comment.
Inputs: text (required), postId (required), accountId (required), scheduledAt, +1 more.
create_postCreate postA
Create a post (saved as a draft — no scheduledAt). Call describe_platform first for per-platform required fields.
Inputs: accountIds (required), caption, mediaIds, postType, +3 more.
create_post_csv_importCreate post CSV importA
Bulk-create posts from CSV text or a public CSV URL. Columns include caption and accountId.
Inputs: csv, url.
create_teamCreate teamC
Create a team (optionally assigning accounts).
Inputs: name (required), slug, avatarUrl, accountIds, +1 more.
delete_commentDelete commentCDestructive
Delete a pending comment.
Inputs: commentId (required).
delete_mediaDelete mediaCDestructive
Delete one media item.
Inputs: mediaId (required).
delete_media_manyDelete media manyBDestructive
Delete several media items; reports per-id outcomes.
Inputs: mediaIds (required).
delete_postDelete postADestructive
Delete a draft/scheduled post (published posts are kept).
Inputs: postId (required).
delete_teamDelete teamBDestructive
Delete a team that no longer owns accounts.
Inputs: teamId (required).
describe_platformDescribe platformARead-only
Per-platform publish field schemas and adapter capabilities. Call before create_post/create_comment to learn required fields. Offline — no API call.
Inputs: platform.
disconnect_accountDisconnect accountADestructive
Disconnect an account. Cascades pending schedules, comment automation, inbox, goals, and agents; published history is kept.
Inputs: accountId (required).
edit_inbox_replyEdit inbox replyB
Edit a reply already sent (currently Facebook only — others return a platform error).
Inputs: itemId (required), message (required), replyId (required).
get_accountGet accountBRead-only
One connected account: profile, follower count, token health (disconnectedAt / tokenExpiresAt).
Inputs: accountId (required).
get_account_analyticsGet account analyticsCRead-only
An account's engagement summary over a window.
Inputs: accountId (required), windowDays.
get_analytics_summaryGet analytics summaryCRead-only
Latest analytics row per accessible account in the window.
Inputs: windowDays.
get_best_timesGet best timesARead-only
Recommended posting times from engagement history (optionally per account).
Inputs: accountId.
get_bulk_post_analyticsGet bulk post analyticsARead-only
Analytics for up to 60 posts; per-post errors included.
Inputs: postIds (required).
get_clipGet clipBRead-only
One clipping job: stage, picks, and per-clip results (mediaId, postIds).
Inputs: clipId (required).
get_clip_usageGet clip usageBRead-only
Clipping minutes used vs. the plan limit.
Inputs: no named parameters.
get_commentGet commentCRead-only
Fetch one scheduled comment.
Inputs: commentId (required).
get_mediaGet mediaCRead-only
Fetch one media item.
Inputs: mediaId (required).
get_organizationGet organizationBRead-only
Plan, limits, and connected-account summary.
Inputs: no named parameters.
get_postGet postBRead-only
Fetch one post with its accounts (permalinks, overrides) and media.
Inputs: postId (required).
get_post_analyticsGet post analyticsCRead-only
One post's metrics (likes, comments, reach, …).
Inputs: postId (required).
get_post_csv_importGet post CSV importCRead-only
One import job's summary.
Inputs: jobId (required).
get_post_csv_import_rowsGet post CSV import rowsCRead-only
Per-row SUCCESS/FAILED results for an import job.
Inputs: jobId (required), limit, offset, status.
get_teamGet teamDRead-only
One team with its member accounts.
Inputs: teamId (required).
get_usageGet usageARead-only
Monthly post usage, plan limit, and credit balance.
Inputs: no named parameters.
list_accountsList accountsBRead-only
Connected social accounts (id, platform, username).
Inputs: platform.
list_account_toolsList account toolsCRead-only
Per-account live lookups available for the account's platform (e.g. Reddit flairs, Pinterest boards).
Inputs: accountId (required).
list_clipsList clipsCRead-only
Recent clipping jobs with their stage and results.
Inputs: limit.
list_commentsList commentsCRead-only
Scheduled comments for a post.
Inputs: postId (required), status.
list_inboxList inboxCRead-only
Incoming comments, mentions, and DMs across accessible accounts.
Inputs: limit, offset, status, platform, +2 more.
list_mediaList mediaCRead-only
List uploaded media.
Inputs: type, limit, offset.
list_post_csv_importsList post CSV importsCRead-only
The caller's CSV import jobs with counts.
Inputs: limit, offset.
list_postsList postsCRead-only
List posts with optional filters and pagination.
Inputs: q, limit, offset, status.
list_teamsList teamsBRead-only
Teams with their member accounts.
Inputs: no named parameters.
refresh_accountRefresh accountB
Refresh an account's OAuth access token server-side.
Inputs: accountId (required).
refresh_analyticsRefresh analyticsB
Enqueue an async analytics backfill for a post or account (job id returned).
Inputs: limit, postId, accountId, windowDays.
remove_team_accountRemove team accountADestructive
Remove an account from a team (reassigned to the default team).
Inputs: teamId (required), accountId (required).
reply_to_inbox_itemReply to inbox itemC
Reply to a comment/mention/DM.
Inputs: itemId (required), message (required).
reschedule_postReschedule postC
Move a post's target time (ISO 8601).
Inputs: postId (required), scheduledAt (required).
retry_commentRetry commentB
Publish a pending/failed comment now.
Inputs: commentId (required).
retry_postRetry postB
Re-queue a post's failed schedules for another attempt.
Inputs: postId (required).
retry_post_csv_importRetry post CSV importB
Re-run an import job's failed rows.
Inputs: jobId (required).
run_account_toolRun account toolARead-only
Run a per-account lookup: reddit-flairs (input { subreddit }) or pinterest-boards (input {}). Use before creating posts that need a flair or board id.
Inputs: tool (required), accountId (required), input.
schedule_postSchedule postC
Create a post scheduled for an ISO 8601 time (e.g. 2026-10-01T09:00:00Z).
Inputs: accountIds (required), scheduledAt (required), caption, mediaIds, +4 more.
update_commentUpdate commentA
Edit a pending comment's text and/or due time.
Inputs: commentId (required), text, scheduledAt.
update_postUpdate postB
Partially update a post: caption, media, schedule (scheduledAt; null clears it → draft), status, poll, thread.
Inputs: postId (required), poll, status, caption, +8 more.
update_teamUpdate teamC
Rename/re-describe a team or reassign its accounts.
Inputs: teamId (required), name, slug, avatarUrl, +2 more.
upload_mediaUpload mediaA
Upload media from a public URL or a local image/video/PDF file path. Returns the media row whose id posts reference via mediaIds.
Inputs: url, path, mediaType.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 55 tools
The set has many clearly named tools, but several pairs overlap meaningfully: create_post vs schedule_post, update_post vs reschedule_post, list_comments vs list_inbox, and the various analytics getters. Descriptions mostly resolve the ambiguity, but with 55 tools an agent can still misselect without reading carefully.
Tool names consistently follow a snake_case verb_noun pattern, such as list_posts, create_comment, delete_media, and update_team. Minor variations like get_post_csv_import and reply_to_inbox_item still fit the same convention.
At 55 tools, the surface is very heavy for one server, even for a broad social-media management domain. Many workflows are split across numerous narrow tools, making discovery and selection more burdensome than necessary.
Coverage is broad: accounts, posts, comments, media, analytics, teams, CSV imports, inbox, and clipping all have core lifecycle operations. There are some minor gaps, such as cancellation/deletion for clipping and CSV import jobs, but most primary workflows are covered.
Maintenance
Related MCP Connectors
Schedule and publish social media posts on 18 networks from Claude, Cursor and other MCP clients.
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.
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).
Publish and schedule videos to TikTok, YouTube Shorts, Instagram, Facebook, LinkedIn, Pinterest, Bluesky, Threads and X from Claude, Cursor or any MCP client. Upload once, post everywhere, track views in unified analytics, and retry failed posts. Official platform APIs only, free plan available. Docs: https://docs.multi-upload-tool.com/mcp
Related MCP Servers
- AlicenseAqualityBmaintenanceSchedule and manage social media posts across 10 platforms (Instagram, Facebook, TikTok, X, LinkedIn, YouTube, Threads, Pinterest, Bluesky, Telegram) from any MCP-compatible AI assistant. Supports batch posting, media uploads, analytics, and platform-specific features like Reels, Shorts, and carousels.11800 npm7MIT
- AlicenseNot gradedqualityDmaintenanceEnables generating, scheduling, and publishing social media posts via Claude or an agent through the MCP protocol.13 npmMIT
- AlicenseNot gradedqualityBmaintenanceSchedule and analyze social media posts from Claude, ChatGPT, or Cursor. Remote OAuth server, 17 tools across 9 platforms, free on every plan. Server URL: https://socialrobot.io/api/mcpMIT
- 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.MIT