# Connect your AI agent to PostBoost

Add one MCP server to Claude, ChatGPT, Cursor or VS Code. Your agent can then draft, schedule and review posts on 15 channels and read the analytics. You approve the connection once with your PostBoost sign-in.

## Quick setup

Paste this into your AI client:

```text
Set up PostBoost (https://postboost.co) so you can help me with social media.
1. If I do not have a PostBoost account yet, send me to https://postboost.co/app/register and wait until I say I have signed up.
2. Add the PostBoost MCP server to this client: https://postboost.co/mcp
   It uses OAuth sign-in, so give me the login link and wait until I approve it.
   If you cannot add servers yourself, tell me exactly where to add it in this client.
3. Then list my connected social accounts in PostBoost.
   If none are connected, use the create-connect-link tool to give me a link for each network I want, and wait.
4. Write one short post for one of my accounts and save it as a draft. Do not schedule or publish anything until I say so.
Setup help for each client: https://postboost.co/agents.md
```

## Setup per client

### Claude.ai (web and desktop)

1. Open Settings, then Connectors, then Add custom connector.

2. Name: PostBoost. URL:

```text
https://postboost.co/mcp
```

3. Click Add, then Connect, and approve the connection on the PostBoost sign-in screen.

### ChatGPT

1. Open Plugins in ChatGPT, click +, then choose Add custom MCP server.

2. Name: PostBoost. Server URL:

```text
https://postboost.co/mcp
```

3. Authentication: OAuth, then confirm the risk warning (I understand and want to continue).

4. Select Create as a plugin, install it, and approve the connection on the PostBoost sign-in screen.

5. In a chat, type @ and pick PostBoost. ChatGPT asks you to confirm before write actions.

### Claude Code

- Run:

```bash
claude mcp add --transport http --scope user postboost https://postboost.co/mcp
```

- Then run `/mcp` in Claude Code and choose Authenticate next to postboost.

- Running headless, for example in CI? Add `--header "Authorization: Bearer YOUR_API_TOKEN"` and skip the sign-in. [Full guide](https://postboost.co/docs/clients/claude-code/)

### Cursor

- [Add PostBoost to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=postboost&config=eyJ1cmwiOiJodHRwczovL3Bvc3Rib29zdC5jby9tY3AifQ==)

- Or add this to `.cursor/mcp.json` in your project, or `~/.cursor/mcp.json` for every project:

```json
{
  "mcpServers": {
    "postboost": {
      "url": "https://postboost.co/mcp"
    }
  }
}
```

- Cursor opens the sign-in when you first turn the server on. [Full guide](https://postboost.co/docs/clients/cursor/)

### VS Code (GitHub Copilot)

- Add this to `.vscode/mcp.json`:

```json
{
  "servers": {
    "postboost": {
      "type": "http",
      "url": "https://postboost.co/mcp"
    }
  }
}
```

### Other MCP clients (Windsurf, Cline, Continue, Zed)

- Any client that supports remote MCP servers over Streamable HTTP with OAuth can use this URL:

```text
https://postboost.co/mcp
```

- If your client cannot run an OAuth sign-in, send an access token instead (next tab).

### API token (clients without OAuth, scripts, CI, Codex, Gemini CLI)

- Create a token in the dashboard: click your avatar in the top bar and choose Access Tokens. It is shown once.

- The connector accepts the token as a header:

```text
Authorization: Bearer YOUR_API_TOKEN
```

- Want one tool per API operation? Use the advanced server:

```text
https://postboost.co/mcp/postboost
```

- Codex:

```toml
[mcp_servers.postboost]
url = "https://postboost.co/mcp/postboost"
bearer_token_env_var = "POSTBOOST_API_TOKEN"
```

- Gemini CLI:

```bash
gemini mcp add --transport http --header "Authorization: Bearer YOUR_API_TOKEN" postboost https://postboost.co/mcp/postboost
```

- Never paste a real token into a shared file. Read it from an environment variable such as `POSTBOOST_API_TOKEN`.

- [All client guides](https://postboost.co/docs/clients/)

- [Authentication](https://postboost.co/docs/mcp/#authentication)

## Tools

### Reads

- `list-workspaces`: List the workspaces the authenticated user can access, most recently updated first.
- `get-workspace`: Get details about a single workspace: name, colour, the authenticated user's role and approval rights, and the number of connected accounts, posts and members.
- `list-accounts`: List the social media accounts connected to a workspace.
- `get-account`: Get full details for a single connected account by its numeric id: name, username, provider, authorization status, profile image, external profile URL and provider-specific data (e.g. follower metrics).
- `list-posts`: List posts in a workspace, most recent first.
- `get-post`: Get the details of a single post by its uuid: status, schedule/publish times, author, tags, the accounts it targets (with live post URLs and any publish errors) and every content version with the text and the media ids of each item.
- `list-tags`: List the tags defined in a workspace.
- `list-media`: List the media files (images, GIFs and videos) in a workspace's library, newest first.
- `get-media-upload-status`: Check the progress of a background media download started by upload-media-by-url for a large file.
- `get-analytics-summary`: Get the cross-platform analytics summary of a workspace for a period: total followers, follower growth and post count compared with the previous period of the same length, the best growing and the least growing account, a daily audience chart, a follower leaderboard, follower distribution and posting consistency.
- `get-account-analytics`: Get the analytics of one connected account for a period.
- `get-post-analytics`: Get the analytics of a published post by its uuid: totals of views, likes, comments and shares across every account it was published to, their trend over time, engagement rate, breakdown, reach-to-engagement funnel and peak day, plus the same figures per account (by numeric account id) with the provider's own metrics and how the post compares with that account's average.
- `get-best-posting-times`: Get the best times to post, learned from how past posts of the chosen accounts performed.
- `validate-post`: Checks a post exactly as create-post would, without creating anything: content rules per network, per-network requirements, duplicate guard, per-account daily caps, account authorization and the X monthly allowance (when enforced).
- `get-account-health`: Pre-flight check before publishing: for every connected account whether it is authorized, still holds a token, and how much of its daily posting cap is used today; plus the workspace's X (Twitter) posts this month against its monthly allowance.
- `get-ai-credits`: The workspace's AI credits: text credits used, limit and remaining in the current billing cycle, and image credits for the current calendar month (UTC).
- `get-brand-voice`: The workspace's brand voice: business name, mission, industry, personality, audience, preferred and avoided topics, tone sliders (formal, playful, technical: 1-5), emoji and hashtag style, words to avoid, preferred calls to action and example posts.
- `list-automations`: Everything that creates posts on its own in the workspace: recycling rules (evergreen recurring posts, with next run, runs done and the source post or tag) and RSS feed auto-posts (url, mode, accounts, last poll and last error).
- `get-repurpose-run`: Status of a repurpose-content run that was still going when the tool answered.
- `list-agents`: The background agents switched on for the workspace (for example the pre-publish checker), with type, schedule, settings, whether they are enabled and when they last ran.
- `list-agent-proposals`: Proposals made by the workspace's background agents, newest first; pending ones by default.
- `list-inbox-drafts`: Reply drafts waiting for a person in the social inbox (comments and messages on Bluesky, Mastodon, LinkedIn Page and Google Business), newest first, 25 per page, with the incoming message they answer.
- `count-characters`: Counts a post text the way each network counts it (X weighs links as 23 and emoji as 2, Bluesky counts graphemes, Mastodon drops mention servers) and returns each network's limit, remaining characters and whether the text is over.
- `check-post`: Checks a post text and its media (count, type, video length) against each network's publishing rules without an account: errors that would stop it from publishing (too long, too many hashtags, media missing where the network needs it, too many files, media type, video length) and warnings (see-more cut-off, link not clickable on Instagram).

### Changes

- `create-post`: Create a post in a workspace and optionally schedule or publish it to the connected social media accounts.
- `update-post`: Update an existing post: change its text content (simple "content" or per-account "versions"), the accounts it targets and/or its tags.
- `schedule-post`: Schedule an existing post for a specific date/time, or publish it immediately with post_now.
- `add-post-to-queue`: Add an existing post to the posting queue: it is scheduled at the next available slot of the workspace posting schedule.
- `unschedule-post`: Unschedule a post: clear its scheduled time and take it back to draft, so it stays put until it is scheduled again.
- `duplicate-post`: Duplicate an existing post.
- `attach-tags-to-post`: Attach one or more tags to a post, keeping any tags it already has.
- `create-tag`: Create a tag in a workspace.
- `upload-media-by-url`: Upload a media file (image, GIF or video) to a workspace's library by downloading it from a public URL.
- `delete-post`: Delete a post.
- `restore-post`: Restore a post from the trash.
- `create-connect-link`: Returns a single-use link (valid 15 minutes) that connects a new account on an OAuth network to the workspace.
- `retry-failed-post`: Publishes a post again to one account whose publishing failed, and returns the post status and publish progress.
- `update-brand-voice`: Creates or updates the workspace brand voice.
- `upload-media`: Adds an image, GIF or video you hold as base64 to the workspace media library and returns its numeric media id to reference in a post.
- `create-recycling-rule`: Re-publishes evergreen content on an interval.
- `add-rss-feed`: Watches an RSS 2.0 or Atom feed every 30 minutes and turns each item published after the feed was added into a post for the given accounts: a draft by default (`mode: draft`), straight into the posting queue (`mode: queue`), or into the queue awaiting approval (`mode: needs_approval`, nothing publishes until someone approves it).
- `create-report`: Generates a downloadable analytics report for a period: a CSV of posts or accounts, or a branded PDF with the workspace's report branding (agency logo, name, colour).
- `repurpose-content`: Turns an article URL, a YouTube video, a public PDF or pasted text into one draft post with a caption written for each target account, plus an image carousel on the networks that take several images.
- `approve-agent-proposal`: Applies a pending proposal at once: `hold_post` moves the post back to draft, `edit_caption` replaces the caption of that version, `retry_account` publishes that failed account again (with the shortened caption, if any), `reconnect_account` only records it (the user reconnects the account in PostBoost).
- `reject-agent-proposal`: Records that a pending proposal was rejected (with an optional note); nothing changes on the post.
- `create-inbox-draft`: Proposes a reply to a comment or message in the social inbox.

## Servers

|  | Connector (start here) | Advanced |
| --- | --- | --- |
| URL | `https://postboost.co/mcp` | `https://postboost.co/mcp/postboost` |
| Sign-in | OAuth sign-in in your client, or an access token | Access token (`Authorization: Bearer`) |
| Tools | Workflow tools with titles and safety hints | One tool per REST API operation |
| Best for | Claude.ai, ChatGPT, Claude Code, Cursor, VS Code, Windsurf | Scripts and agents that already use the REST API |

## Summary

PostBoost is a social media management tool your AI agent can use through MCP. Add https://postboost.co/mcp to your client and approve the connection with your PostBoost sign-in; no API key needed. Your agent can then draft, schedule and review posts on 15 channels, read analytics and fix failed posts, while your team works on the same posts in the dashboard. MCP and the REST API are on every plan, including Free with 3 social accounts and no credit card. Paid plans start at $29 a month with a 14-day free trial.

```text
product: PostBoost, social media management for AI agents, teams and developers
mcp_connector: https://postboost.co/mcp (OAuth 2.1 sign-in, or Authorization: Bearer <token>)
mcp_advanced: https://postboost.co/mcp/postboost (Bearer token, one tool per API operation)
first_tool: list-workspaces (every other tool needs the workspace uuid)
publishing: create-post saves a draft; schedule-post or add-post-to-queue publishes
channels: X, Facebook Pages, Instagram, Threads, LinkedIn, TikTok, YouTube, Pinterest, Google Business Profile, Bluesky, Mastodon, Pixelfed, Telegram, Discord, Slack
setup_per_client: https://postboost.co/agents.md
docs: https://postboost.co/docs/mcp/
plans: https://postboost.co/pricing.md
llms: https://postboost.co/llms.txt
signup: https://postboost.co/app/register
```

## FAQ

### What is MCP?

MCP (Model Context Protocol) is an open standard that lets AI clients like Claude, ChatGPT and Cursor use tools from other apps. PostBoost runs an MCP server, so your agent can work with your social posts directly.

### Do I need to write code?

No. In Claude.ai and ChatGPT you add a URL in the settings and sign in. Claude Code and Cursor take one command or one config file.

### Do I need an API key?

No for the connector at postboost.co/mcp: you approve the connection with your PostBoost sign-in. Use an access token only for clients without OAuth sign-in, for scripts and for the advanced server.

### Can my agent publish without asking me?

New posts are drafts unless your agent schedules them, and your client can ask you before any tool that changes something. Tell your agent to keep everything as drafts and your team can review them in the calendar.

### Which channels can my agent post to?

15: X, Facebook Pages, Instagram, Threads, LinkedIn, TikTok, YouTube, Pinterest, Google Business Profile, Bluesky, Mastodon, Pixelfed, Telegram, Discord and Slack.

### Is MCP included on the Free plan?

Yes. MCP, the REST API and webhooks are on every plan, including Free.

### Can my agent connect new social accounts?

Yes. Your agent can create a connect link for a network; you open it and sign in to that network yourself. Bluesky, Mastodon, Pixelfed, Telegram, Discord and Slack connect in the dashboard.

### What if my client does not support OAuth?

Create an access token (click your avatar in the top bar, then Access Tokens) and send it as Authorization: Bearer YOUR_API_TOKEN to https://postboost.co/mcp.

## Links

- MCP docs: https://postboost.co/docs/mcp/
- Client guides: https://postboost.co/docs/clients/
- Plans: https://postboost.co/pricing.md
- llms.txt: https://postboost.co/llms.txt
- Sign up: https://postboost.co/app/register