# PublishBuddy

> PublishBuddy is an MCP server for design and media. Social scheduling, analytics and AI media generation for PublishBuddy workspaces. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Platforms:** API, Web
- **Website:** https://docs.publishbuddy.com/mcp-server/introduction
- **MCP Registry name:** com.publishbuddy/publishbuddy
- **Categories:** [design and media](https://ai-powered.com/categories/design-and-media), [marketing and SEO](https://ai-powered.com/categories/marketing-and-seo)
- **Listing updated:** 2026-11-15

## About

This server lets an MCP client act inside a PublishBuddy workspace instead of a generic social API. Docs group what it can do into reading analytics, drafting and scheduling posts, generating media, and working out which content performs. A get_top_posts tool is named for the last of these.

Access follows the signed-in user. Each tool runs with that user's dashboard permissions, so a member who can only draft in the app can only draft over MCP, and sees only the profiles they see there. Requests run against one workspace; with an API token it is the last-used one unless an X-Workspace-Id header names another. The in-app AI agent is a client of this same server.

Media tools cost AI credits: generate_image is listed at 17 per call, and AI Studio quotes the video and carousel models inside each generation. A 402 means the plan lacks MCP access or credits ran out. 401 and 403 cover bad tokens and missing workspace context, and 429 carries a Retry-After.

## Features

- **Workspace-scoped access:** Tools use the signed-in user's permissions and profile visibility.
- **Analytics and top posts:** Read performance data and find the posts that work best.
- **Draft and schedule:** Create and queue social posts from an MCP client.
- **AI image and video:** Generate and edit images, animate them into video, or draft carousels.
- **Credit metering:** Media calls are charged in AI credits, with model quotes shown.
- **Token or sign-in auth:** Connect with an app sign-in or an API token with the mcp ability.

## Good for

- Ask an assistant which posts performed best this month
- Draft a week of posts and schedule them
- Generate an image for a post from a prompt
- Animate a still image into a short clip
- Switch between workspaces with a header

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http publishbuddy https://api.publishbuddy.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://api.publishbuddy.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "publishbuddy": {
      "url": "https://api.publishbuddy.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "publishbuddy": {
      "type": "http",
      "url": "https://api.publishbuddy.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "publishbuddy": {
      "serverUrl": "https://api.publishbuddy.com/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://api.publishbuddy.com/mcp
```

Enter a Name (for example "PublishBuddy"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "publishbuddy": {
      "type": "http",
      "url": "https://api.publishbuddy.com/mcp"
    }
  }
}
```

## Tools

- `generate_image`: Generate an image (17 credits per call).
- `edit_image`: Edit an image.
- `generate_media`: Generate media through AI Studio at the model's quoted cost.
- `animate_image`: Animate an image into video, charged per second by AI Studio.
- `get_top_posts`: Return the top-performing posts.

## FAQ

### What happens if my plan lacks MCP?

The server answers 402, as it does when AI credits run out.

### Can I use another workspace?

Send X-Workspace-Id with the workspace UUID from GET /workspaces.

### How much does an image cost?

generate_image is listed at 17 credits per call.

### Where do I get a token?

In User Settings, Login & Security; it needs the mcp ability.

### How do I add PublishBuddy to Claude Code?

Run this command in your terminal: claude mcp add --transport http publishbuddy https://api.publishbuddy.com/mcp

### What are the best alternatives to PublishBuddy?

The closest alternatives to PublishBuddy are PublishQ, Posty, Postbase, Sync Socials and MisarPost MCP Server.

## Where this comes from

- Description: written from the project's website.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [PublishQ](https://ai-powered.com/mcp/publishq): PublishQ is a freemium MCP server for marketing and seo.
- [Posty](https://ai-powered.com/mcp/posty): Posty is an MCP server for marketing and seo.
- [Postbase](https://ai-powered.com/mcp/postbase): Postbase is a freemium MCP server for design and media.
- [Sync Socials](https://ai-powered.com/mcp/sync-socials): Sync Socials is an MCP server for marketing and seo.
- [MisarPost MCP Server](https://ai-powered.com/mcp/misarpost-mcp-server): MisarPost MCP Server is an MCP server for marketing and seo.
- [PostBaton](https://ai-powered.com/mcp/postbaton): PostBaton is a freemium MCP server for marketing and seo.
- [Social MCP by PostingCat](https://ai-powered.com/mcp/social-mcp-by-postingcat): Social MCP by PostingCat is a freemium MCP server for marketing and seo.
- [PostNitro](https://ai-powered.com/mcp/postnitro): PostNitro is a paid MCP server for marketing and seo.

---
Source: https://ai-powered.com/mcp/publishbuddy
