SocialBu

io.github.socialbuv1.0.0Updated Oct 3, 2026

Manage SocialBu posts, accounts, queues, analytics, automations, media, and listening.

Overview

AI-generated overview

Lets an assistant manage SocialBu social media accounts, posts, queues, analytics, automations, media, and listening data.

What it does
The official SocialBu remote MCP server exposes tools for inspecting connected accounts and teams, creating drafts, scheduling, updating, and publishing posts, and working with custom publishing queues and media uploads. It also reads account and post analytics, inspects and toggles automations, browses curated content, manages saved Listen items, and runs SocialBu AI content tools. Available operations depend on the user's plan, permissions, teams, and connected networks.
When to use it
Use it when an assistant should operate a SocialBu social media workspace: drafting and scheduling posts, checking analytics, managing queues and media, or reviewing automations and listening items. It fits clients that support Streamable HTTP and OAuth.
Requirements
A remote MCP endpoint at reached over Streamable HTTP with OAuth; the client opens SocialBu in a browser for sign-in and approval. No local runtime, API keys, or environment variables are needed. Optional agent skill installs use npx or client-specific plugin commands.
Before you install
Publishing, deletion, account removal, approvals, and automation changes are consequential and are marked in tool annotations. OAuth access is granted in the browser; do not paste a SocialBu password or API token into a prompt, and keep credentials out of prompts, logs, issues, and screenshots. MCP credentials are bound to the MCP endpoint and are separate from REST API credentials.

Installation

In SourceWeft

  1. Open SocialBu in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "socialbu": {
      "type": "http",
      "url": "https://socialbu.com/mcp"
    }
  }
}

README

[SocialBu]

SocialBu for AI agents

The official SocialBu plugin and remote MCP integration. It lets supported AI clients work with the SocialBu accounts, posts, queues, analytics, automations, curated content, media, and social listening data that you authorize.

The hosted MCP server is the source of truth. This repository contains portable agent instructions and client manifests, with no proxy server, duplicated business logic, API keys, or local runtime.

Connect

Use this remote MCP server in any client that supports Streamable HTTP and OAuth:

text
https://socialbu.com/mcp

Your client opens SocialBu in a browser. Sign in and approve the connection there. Do not paste a SocialBu password or API token into a prompt.

Install

Agent skill

Install the reusable SocialBu skill in clients supported by the Agent Skills installer:

bash
npx skills add socialbu/socialbu-agent

The skill improves tool selection and safety. Connect the MCP URL as well if the client does not install bundled MCP servers from mcp.json.

Gemini CLI

bash
gemini extensions install https://github.com/socialbu/socialbu-agent

Restart Gemini CLI after installation, then authorize SocialBu when prompted.

Claude Code

text
/plugin marketplace add socialbu/socialbu-agent/plugin install socialbu@socialbu-agent

GitHub Copilot CLI

bash
copilot plugin install socialbu/socialbu-agent

Qwen Code

bash
qwen extensions install socialbu/socialbu-agent

Other clients

See client setup instructions for ChatGPT, Codex, Cursor, GitHub Copilot, Windsurf, Cline, Zed, OpenCode, Grok Build, Qwen Code, and direct MCP configuration.

What agents can do

  • Inspect connected accounts and teams
  • Create drafts, schedule posts, update posts, and publish on request
  • Work with custom publishing queues and media uploads
  • Read account and post analytics
  • Inspect and enable or disable automations
  • Browse curated content
  • Read, archive, restore, and delete saved Listen items
  • Run SocialBu AI content tools

Available operations depend on the user's plan, permissions, teams, connected networks, and account types.

Safety model

  • Read operations are marked read-only.
  • Publishing, deletion, account removal, approvals, automation changes, and other consequential actions are marked accurately in MCP tool annotations.
  • OAuth access is granted by the SocialBu user in the browser.
  • MCP credentials are bound to https://socialbu.com/mcp and are separate from REST API credentials.
  • No credentials belong in this repository, prompts, logs, issues, or screenshots.

Repository contents

PathPurpose
plugin.jsonPortable Agent Plugins manifest
mcp.jsonPortable remote MCP definition
skills/socialbu/Reusable SocialBu operating guidance
.claude-plugin/Claude plugin and marketplace metadata
.codex-plugin/Codex compatibility manifest
.grok-plugin/Grok Build compatibility metadata
gemini-extension.jsonGemini CLI extension manifest
GEMINI.mdGemini CLI operating guidance
server.jsonOfficial MCP Registry metadata
LICENSEMIT license

Maintainers can use the release and directory checklist for versioning, validation, and submission requirements.

Existing SocialBu CLI

The separate SocialBu CLI remains available for terminal scripts and environments that do not support MCP. This plugin does not bundle or duplicate it.

Support

Source: README.md at commit 475c6f7

Tools

0
Tool metadata has not been indexed yet.

Version history

1
  1. v1.0.0LatestOct 3, 2026