README.md

<p align="center">
  <img src="assets/logo.svg" alt="SocialBu" width="236">
</p>

# 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 with 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
```

The Claude plugin connects to `https://socialbu.com/mcp`.

### GitHub Copilot CLI

```bash
copilot plugin marketplace add socialbu/socialbu-agent
copilot plugin install socialbu@socialbu-agent
```

### Qwen Code

```bash
qwen extensions install socialbu/socialbu-agent
```

### Other clients

See [client setup instructions](docs/clients.md) 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

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

## Existing SocialBu CLI

The separate [SocialBu CLI](https://github.com/socialbu/socialbu-cli) remains available for terminal scripts and environments that do not support MCP. This plugin does not bundle or duplicate it.

## Support

- [MCP setup page](https://socialbu.com/mcp-server)
- [SocialBu help center](https://help.socialbu.com/)
- [Report a packaging problem](https://github.com/socialbu/socialbu-agent/issues)
- [Security policy](SECURITY.md)