Skip to main content
Glama
postbuzz-mcp

postbuzz-mcp

by navneet35371

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-mcp

Cursor

~/.cursor/mcp.json:

{
  "mcpServers": {
    "postbuzz": {
      "command": "npx",
      "args": ["-y", "postbuzz-mcp"],
      "env": { "POSTBUZZ_API_KEY": "sx_live_..." }
    }
  }
}

Configuration

Env var

Flag

Required

Purpose

POSTBUZZ_API_KEY

--api-key

yes

API key

POSTBUZZ_API_URL

--api-url

no

API base URL (default https://post.buzz/api)

Test interactively with the MCP Inspector:

npx @modelcontextprotocol/inspector node dist/index.js

Related 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 tools
add_team_accountAdd team accountC

Assign an account to a team.

Inputs: teamId (required), accountId (required).

check_setupCheck setupA
Read-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 commentC
Destructive

Delete a pending comment.

Inputs: commentId (required).

delete_mediaDelete mediaC
Destructive

Delete one media item.

Inputs: mediaId (required).

delete_media_manyDelete media manyB
Destructive

Delete several media items; reports per-id outcomes.

Inputs: mediaIds (required).

delete_postDelete postA
Destructive

Delete a draft/scheduled post (published posts are kept).

Inputs: postId (required).

delete_teamDelete teamB
Destructive

Delete a team that no longer owns accounts.

Inputs: teamId (required).

describe_platformDescribe platformA
Read-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 accountA
Destructive

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 accountB
Read-only

One connected account: profile, follower count, token health (disconnectedAt / tokenExpiresAt).

Inputs: accountId (required).

get_account_analyticsGet account analyticsC
Read-only

An account's engagement summary over a window.

Inputs: accountId (required), windowDays.

get_analytics_summaryGet analytics summaryC
Read-only

Latest analytics row per accessible account in the window.

Inputs: windowDays.

get_best_timesGet best timesA
Read-only

Recommended posting times from engagement history (optionally per account).

Inputs: accountId.

get_bulk_post_analyticsGet bulk post analyticsA
Read-only

Analytics for up to 60 posts; per-post errors included.

Inputs: postIds (required).

get_clipGet clipB
Read-only

One clipping job: stage, picks, and per-clip results (mediaId, postIds).

Inputs: clipId (required).

get_clip_usageGet clip usageB
Read-only

Clipping minutes used vs. the plan limit.

Inputs: no named parameters.

get_commentGet commentC
Read-only

Fetch one scheduled comment.

Inputs: commentId (required).

get_mediaGet mediaC
Read-only

Fetch one media item.

Inputs: mediaId (required).

get_organizationGet organizationB
Read-only

Plan, limits, and connected-account summary.

Inputs: no named parameters.

get_postGet postB
Read-only

Fetch one post with its accounts (permalinks, overrides) and media.

Inputs: postId (required).

get_post_analyticsGet post analyticsC
Read-only

One post's metrics (likes, comments, reach, …).

Inputs: postId (required).

get_post_csv_importGet post CSV importC
Read-only

One import job's summary.

Inputs: jobId (required).

get_post_csv_import_rowsGet post CSV import rowsC
Read-only

Per-row SUCCESS/FAILED results for an import job.

Inputs: jobId (required), limit, offset, status.

get_teamGet teamD
Read-only

One team with its member accounts.

Inputs: teamId (required).

get_usageGet usageA
Read-only

Monthly post usage, plan limit, and credit balance.

Inputs: no named parameters.

list_accountsList accountsB
Read-only

Connected social accounts (id, platform, username).

Inputs: platform.

list_account_toolsList account toolsC
Read-only

Per-account live lookups available for the account's platform (e.g. Reddit flairs, Pinterest boards).

Inputs: accountId (required).

list_clipsList clipsC
Read-only

Recent clipping jobs with their stage and results.

Inputs: limit.

list_commentsList commentsC
Read-only

Scheduled comments for a post.

Inputs: postId (required), status.

list_inboxList inboxC
Read-only

Incoming comments, mentions, and DMs across accessible accounts.

Inputs: limit, offset, status, platform, +2 more.

list_mediaList mediaC
Read-only

List uploaded media.

Inputs: type, limit, offset.

list_post_csv_importsList post CSV importsC
Read-only

The caller's CSV import jobs with counts.

Inputs: limit, offset.

list_postsList postsC
Read-only

List posts with optional filters and pagination.

Inputs: q, limit, offset, status.

list_teamsList teamsB
Read-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 accountA
Destructive

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 toolA
Read-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

    C2.9/5.0

    Scored across 55 tools

    Disambiguation3/5

    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.

    Naming Consistency5/5

    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.

    Tool Count2/5

    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.

    Completeness4/5

    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

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Schedule 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.
      11
      800 npm
      7
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Schedule 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/mcp
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables 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