SocialBu logo
Advertising & Social
Live

SocialBu MCP server

Plan, draft and publish across every social network, answer the inbox, and read the analytics -- with nothing posted until you say so.

Tools
74
Read-only
44
Write
30
Off by default
Destructive
6
Flagged distinctly
What it does

SocialBu through an assistant

SocialBu runs a brand's social media: scheduling to Instagram, Facebook, LinkedIn, X, TikTok, Pinterest and Threads, a shared inbox, social listening and analytics. This connector covers all of SocialBu's API -- more than SocialBu's own MCP server, which leaves out the inbox, listening, queues, tags and media. The difference that matters is control: a post is always created as a draft, and publishing, scheduling, queueing, approving and every inbox reply each need an explicit confirmation, because once a network has shown a post or delivered a reply there is no taking it back.

  • Scheduled, draft, published and awaiting-approval posts, read in full
  • Analytics: top posts, best posting day, follower growth, engagement and post metrics
  • The social inbox and social listening, read in full
  • Draft posts with media and network options (opt-in; never publishes)
  • Schedule, publish, queue and approve posts (opt-in, each needs confirmation)
  • Reply, message and react in the inbox as the brand (opt-in, each needs confirmation)
Ask your assistant

What people actually ask

Real questions, answered from live SocialBu data.

“What's scheduled for next week, and which days have nothing going out?”

socialbu_list_postssocialbu_get_post_counts

“Which of our posts did best this month, and what day should we be posting on?”

socialbu_get_top_postssocialbu_get_best_posting_day

“Draft an Instagram and LinkedIn post announcing the new product, but don't publish it yet.”

socialbu_list_accountssocialbu_create_draft_post
Tool catalogue

74 SocialBu tools

Grouped by what they touch. Every tool is individually toggleable — you expose only what you want.

Insights

14 tools14 read-only · 0 write

Showing 10 of 10 tools

  • socialbu_get_account_metrics
    Read-only

    Account-level metric series per day (followers, followers by country and similar), plus the latest snapshot, which may fall outside the range.

  • socialbu_get_automation_logs
    Read-only

    Recent runs of your SocialBu automations (auto-posting, RSS, auto-replies), newest first.

  • socialbu_get_best_posting_day
    Read-only

    The weekday whose published posts had the highest average engagement rate in a date range, with how much evidence backs it.

  • socialbu_get_engagement_rate
    Read-only

    Overall engagement rate: total engagements / total followers x 100, across all accounts.

  • socialbu_get_engagement_trend
    Read-only

    Total engagements per day across all accounts in a date range.

  • socialbu_get_follower_counts
    Read-only

    Total followers across all accounts, and per account, for every network that reports an audience size.

  • socialbu_get_follower_growth
    Read-only

    Net followers gained or lost per day across all accounts. Range up to 90 days.

  • socialbu_get_open_conversations_count
    Read-only

    How many inbox conversations are open across all accounts.

  • socialbu_get_post_counts
    Read-only

    Posts per calendar day in a date range, optionally by post type, accounts or team. Good for spotting empty days in a plan.

  • socialbu_get_post_metrics
    Read-only

    Post metrics per day in a date range -- summed across accounts, or per account with group_by_account. Day-over-day deltas by default (calculate_growth).

+ 4 more insights tools — see the full catalogue

Listening

10 tools6 read-only · 4 write

Showing 10 of 10 tools

  • socialbu_archive_listening_items
    Write

    Archives several items in a stream, or every active one with all: true.

  • socialbu_create_listening_stream
    Write

    Creates a stream that watches the given platforms for the given keywords, optionally with an AI relevance filter. Counts against the plan's listening quota.

  • socialbu_delete_listening_items
    Write
    Destructive

    Deletes one or more items from a stream for good (archiving keeps them). Cannot be undone. Requires `confirm: true`; refused without it, before anything is sent.

  • socialbu_get_listening_activity
    Read-only

    How many items a stream found per day, by keyword or platform. Up to 90 days; defaults to the last 30.

  • socialbu_get_listening_item
    Read-only

    One item a stream found, in full.

  • socialbu_get_listening_stream
    Read-only

    One stream: its query, sources, counts, quota and its RSS and embed links.

  • socialbu_list_listening_items
    Read-only

    The posts a stream has found -- mentions of the brand, competitors or keywords -- filterable by platform, status, date and text.

  • socialbu_list_listening_sources
    Read-only

    The platforms social listening can watch.

  • socialbu_list_listening_streams
    Read-only

    Your listening streams -- saved keyword searches across platforms -- with team visibility and quota.

  • socialbu_set_listening_item_archived
    Write

    Archives or unarchives one item in a stream.

Posts

10 tools3 read-only · 7 write

Showing 10 of 10 tools

  • socialbu_bulk_delete_posts
    Write
    Destructive

    Deletes up to 100 posts by id. Published posts stay on their networks; only SocialBu's records go. Cannot be undone. Requires `confirm: true`; refused without it, before anything is sent.

  • socialbu_create_draft_post
    Write

    Creates a post as a DRAFT on one or more social accounts. It is never published by this tool, whatever the input: drafting is safe to do speculatively. Review it with socialbu_get_post, then go public with socialbu_schedule_post or socialbu_publish_post_now. `publish_at` is the intended time, stored on the draft; it defaults to 24 hours from now. Attach media by uploading first and passing the upload_token values.

  • socialbu_delete_post
    Write
    Destructive

    Deletes a draft, scheduled or published post from SocialBu. A published post stays on the social network -- this only removes SocialBu's record of it. Cannot be undone. Requires `confirm: true`; refused without it, before anything is sent.

  • socialbu_get_post
    Read-only

    One post in full: content, schedule, accounts, attachments, publish result, status, and who approved or rejected it.

  • socialbu_get_post_options
    Read-only

    The network-specific options each account accepts when posting -- types, labels, limits and choices (e.g. Pinterest boards, YouTube privacy, Instagram post type). Call before creating a post for a network with required options.

  • socialbu_list_posts
    Read-only

    Lists posts by state: scheduled, awaiting_approval, scheduled_or_awaiting_approval (default), draft or published. Filter by date range, accounts, team, author, tags, source or free text. Paginated, up to 100 per page.

  • socialbu_publish_post_now
    Write

    Publishes a draft or scheduled post immediately on its accounts. There is no unpublish: deleting a published post afterwards removes it from SocialBu only, not from the network. PUBLISHES PUBLICLY: this puts content on a social network as the brand. Requires `confirm: true`; refused without it, before anything is sent.

  • socialbu_review_post
    Write

    Approves or rejects a post awaiting team approval (needs the approvals permission in that team). Approving lets it publish at its scheduled time; rejecting sends `reject_reason` to its author. PUBLISHES PUBLICLY: this puts content on a social network as the brand. Requires `confirm: true`; refused without it, before anything is sent.

  • socialbu_schedule_post
    Write

    Turns a draft into a scheduled post that SocialBu publishes on its accounts at `publish_at` (at least two minutes ahead; to publish now use socialbu_publish_post_now). On a team that requires approval it goes to awaiting approval instead. PUBLISHES PUBLICLY: this puts content on a social network as the brand. Requires `confirm: true`; refused without it, before anything is sent.

  • socialbu_update_post
    Write

    Edits a draft or scheduled post: content, intended time, attachments, options, tags. Only the fields given change. It never publishes and never changes a post's draft state or approval -- those are socialbu_schedule_post, socialbu_publish_post_now and socialbu_review_post. Editing a SCHEDULED post changes what will publish at its scheduled time.

Inbox

8 tools5 read-only · 3 write

Showing 8 of 8 tools

  • socialbu_conversation_action
    Write

    Acts on a conversation as the brand: reply, message, comment, react or vote. The network delivers it to the person immediately; it cannot be recalled from Serve MCP. Read the conversation first with socialbu_list_conversation_items. CONTACTS A REAL PERSON: the network delivers this as the brand. Requires `confirm: true`; refused without it, before anything is sent.

  • socialbu_get_conversation
    Read-only

    One conversation's details: contact, network, status, assignee.

  • socialbu_item_action
    Write

    Acts on one message or comment in a conversation as the brand: reply, comment, react or vote. Delivered by the network immediately and cannot be recalled from Serve MCP. CONTACTS A REAL PERSON: the network delivers this as the brand. Requires `confirm: true`; refused without it, before anything is sent.

  • socialbu_list_conversation_items
    Read-only

    The messages or comments in a conversation, oldest first (reverse for newest first).

  • socialbu_list_conversations
    Read-only

    Conversations in one inbox -- comments, mentions, DMs, reviews -- filterable by status, assignment, date, unread, network and text.

  • socialbu_list_inboxes
    Read-only

    The account and team inboxes you can read, with the inbox ids the other inbox tools take.

  • socialbu_list_item_replies
    Read-only

    The replies under one message or comment in a conversation.

  • socialbu_update_conversation_status
    Write

    Sets conversations open, pending, closed or spam. Internal to SocialBu: nothing is sent to anyone.

Accounts

5 tools2 read-only · 3 write

Showing 5 of 5 tools

  • socialbu_delete_account
    Write
    Destructive

    Disconnects a social account from SocialBu permanently, and deletes every post scheduled on it. Reconnecting later does not bring those posts back. Requires the account's exact current name in `account_name` as well as confirm. Cannot be undone. Requires `confirm: true`; refused without it, before anything is sent.

  • socialbu_get_account
    Read-only

    One social account in full, including network extras such as Pinterest boards or YouTube categories.

  • socialbu_get_connect_url
    Write

    Returns a link the user opens in a browser to connect a new social account, or to reconnect one whose connection broke (pass account_id). Nothing is connected until the user completes it there.

  • socialbu_list_accounts
    Read-only

    The social accounts you can post to -- your own and those shared through teams -- with each one's id, network, name and connection status. Start here: posts, insights and inbox tools take these ids.

  • socialbu_update_account
    Write

    Renames a social account in SocialBu, or sets its AI context (brand voice, audience, products) used by SocialBu's AI tools. Changes nothing on the network.

Curation

5 tools5 read-only · 0 write

Showing 5 of 5 tools

  • socialbu_get_curation_embed_url
    Read-only

    A signed embed URL and iframe code for the curated items matching these filters, to show on a website or dashboard. Anyone with the link can view it.

  • socialbu_get_curation_item
    Read-only

    One curated item in full.

  • socialbu_get_curation_rss_url
    Read-only

    A signed RSS feed URL for the curated items matching these filters, for an RSS reader or another system. Anyone with the link can read the feed.

  • socialbu_list_curation_items
    Read-only

    Curated articles and posts to share, searchable by meaning, filterable by author, feed, source and time range.

  • socialbu_list_curation_topics
    Read-only

    Search suggestions for curated content, personalised from recent activity when available.

Queues

4 tools2 read-only · 2 write

Showing 4 of 4 tools

  • socialbu_add_to_queue
    Write

    Adds a post to a queue, which publishes it on the queue's own timetable without any further step. SocialBu validates it for the given accounts first. PUBLISHES PUBLICLY: this puts content on a social network as the brand. Requires `confirm: true`; refused without it, before anything is sent.

  • socialbu_list_queue_posts
    Read-only

    The posts waiting in one queue, in order.

  • socialbu_list_queues
    Read-only

    Publishing queues you can use, including team queues. A queue publishes its items on its own timetable.

  • socialbu_shuffle_queue
    Write

    Randomises the order of a queue's posts. The original order cannot be restored.

Tags

4 tools1 read-only · 3 write

Showing 4 of 4 tools

  • socialbu_create_tag
    Write

    Creates a post or inbox tag, personal or for a team.

  • socialbu_delete_tag
    Write
    Destructive

    Deletes a tag and removes it from every post or conversation it was on. Cannot be undone. Requires `confirm: true`; refused without it, before anything is sent.

  • socialbu_list_tags
    Read-only

    Your post or inbox tags, or a team's when team_id is given.

  • socialbu_update_tag
    Write

    Renames or recolours a tag.

Teams

4 tools1 read-only · 3 write

Showing 4 of 4 tools

  • socialbu_create_team
    Write

    Creates a team with the given accounts and members and their permissions, optionally requiring approval before anything publishes.

  • socialbu_delete_team
    Write
    Destructive

    Deletes a team and every member's access through it. The accounts stay connected to their owner. Cannot be undone. Requires `confirm: true`; refused without it, before anything is sent.

  • socialbu_list_teams
    Read-only

    Teams you created or joined, with their accounts and members.

  • socialbu_update_team
    Write

    Replaces a team's name, accounts, members and approval setting IN FULL -- SocialBu removes any account or member not listed. If the update would remove anyone or anything, the result names them and confirm is required.

Media

4 tools1 read-only · 3 write

Showing 4 of 4 tools

  • socialbu_create_upload_url
    Write

    For files over 75 MB (usually video): returns a signed `signed_url` the file must be PUT to directly, and a `key`. After the upload, socialbu_get_upload_status with that key returns the upload_token to attach. For anything smaller, socialbu_upload_media or socialbu_upload_media_from_url is one step.

  • socialbu_get_upload_status
    Read-only

    Whether a file sent by SocialBu's signed-URL flow has finished, and its upload_token once it has.

  • socialbu_upload_media
    Write

    Stores a file the user uploaded to Serve MCP (servemcp_request_upload gives a file_id) in SocialBu and returns an upload_token to attach to a post. Up to 75 MB. Uploading does not post anything.

  • socialbu_upload_media_from_url
    Write

    Stores an image, video or PDF in SocialBu from a public http(s) URL, which SocialBu downloads itself, and returns an upload_token to attach to a post. jpg, jpeg, png, gif, webp, mp4, mov, avi, webm, mkv, pdf. Uploading does not post anything.

Notifications

4 tools2 read-only · 2 write

Showing 4 of 4 tools

  • socialbu_get_notification
    Read-only

    One notification in full.

  • socialbu_list_notifications
    Read-only

    Your SocialBu notifications -- failed posts, approvals, account problems. unread_only for just the unread ones.

  • socialbu_mark_all_notifications_read
    Write

    Marks every notification read.

  • socialbu_mark_notification
    Write

    Marks one notification read or unread.

Ai

2 tools2 read-only · 0 write

Showing 2 of 2 tools

  • socialbu_list_ai_tools
    Read-only

    SocialBu's AI tools (captions, hashtags, post ideas, replies, scripts and more) with the fields each takes. Free to call.

  • socialbu_run_ai_tool
    Read-only

    Runs one of SocialBu's AI tools by slug with its fields (from socialbu_list_ai_tools) and returns the generated text. Generates content only -- nothing is posted. Spends the account's SocialBu AI credits.

Every tool name and description, machine-readable: /llms-full.txt

Access & safety

You decide what it can touch

The same model applies to every connector, and it defaults closed.

Your own credential

You supply your own SocialBu key, scoped however you like on their side. It is encrypted with AES-256-GCM and never returned by any API response or tool call.

Writes off by default

A new connection switches on a read-oriented default set only. Every write tool must be enabled deliberately before any client can call it.

Roles enforced server-side

READ, WRITE and ADMIN gate tool invocation on the server, not just in the UI. A READ member's token is refused any write tool.

Setup

Connect SocialBu in minutes

No infrastructure to run. Copy one URL and one token into your client.

  1. 1Create a free workspace and connect SocialBu.
  2. 2Choose which tools to expose — writes stay off until you enable them.
  3. 3Copy your MCP endpoint URL and bearer token.
  4. 4Paste them into Claude, Cursor, or any MCP client.
claude_desktop_config.json
{
  "mcpServers": {
    "serve-mcp": {
      "url": "https://servemcp.com/api/mcp/your-workspace",
      "transport": "http",
      "headers": {
        "Authorization": "Bearer smcp_..."
      }
    }
  }
}

On Claude you paste one URL and sign in — no token to copy. See the setup guide for each client.

Put SocialBu in front of your assistant

Free plan, no card required. Connect in minutes.