# Postbase

> Postbase is a freemium MCP server for design and media. Draft and schedule posts and threads to X, LinkedIn, Bluesky and Mastodon from your AI. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $29 a month
- **Platforms:** Web, API, self-hosted
- **Website:** https://www.postbase.so/developers
- **Repository:** https://github.com/postbasehq/mcp
- **MCP Registry name:** io.github.postbasehq/postbase
- **Categories:** design and media, marketing and SEO, communication
- **Listing updated:** 2026-11-15

## About

Postbase is a social scheduler, and its MCP server lets an assistant use it. The hosted endpoint signs in with OAuth, so no key is pasted, while the npm package @postbasehq/mcp takes an API key and can point at a self-hosted instance. Posts the agent schedules appear on the same calendar as yours and can be reviewed or cancelled before going out. The site says agents cannot delete anything or change the account, and access can be revoked from an AI and API page.

The README lists tools to list channels, create or update posts and threads with per-channel text and an idempotency key, retry failures, read analytics, manage media from public links, list scheduled posts and cancel one. Networks include X threads up to 25 posts, LinkedIn up to 3,000 characters, Bluesky 300 and Mastodon 500. The README says TikTok posts can only be drafts and that video posts for TikTok and YouTube are scheduled in the app.

The code is AGPL-3.0-or-later and can be self-hosted free with your own platform keys. Hosted plans run $29 to $99 a month after a 7-day trial.

## Features

- **Per-channel wording:** Writes a different version of each post for each network.
- **Threads:** Schedules threads on X, Bluesky and Mastodon.
- **Retry-safe creation:** An idempotency key stops retries posting twice.
- **Analytics:** Reads impressions, likes, comments, shares and saves per post.
- **Media library:** Adds images and video from public https links.
- **Review before publish:** Agent posts sit on the calendar and can be edited or cancelled.

## Good for

- Schedule a thread for 9am on several networks
- Have an assistant plan a week of posts
- Check which posts failed and retry them
- Pull post analytics into a chat
- Run a client's social calendar from an agent

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http postbase https://mcp.postbase.so/mcp
```

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

```sh
https://mcp.postbase.so/mcp
```

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

```json
{
  "mcpServers": {
    "postbase": {
      "url": "https://mcp.postbase.so/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "postbase": {
      "type": "http",
      "url": "https://mcp.postbase.so/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "postbase": {
      "serverUrl": "https://mcp.postbase.so/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "postbase": {
      "type": "http",
      "url": "https://mcp.postbase.so/mcp"
    }
  }
}
```

## Tools

- `list_channels`: List the channels connected to your workspace.
- `create_post`: Create a draft, or schedule a post or thread.
- `get_post`: How a post went on each channel.
- `update_post`: Edit or reschedule a draft or scheduled post.
- `retry_post`: Send a post again to channels where it failed.
- `get_analytics`: Impressions, likes, comments, shares and saves per post and channel.
- `list_media`: List images and videos in the media library.
- `add_media`: Add an image or video from a public https link.
- `list_scheduled`: List scheduled posts, drafts, published or failed ones.
- `cancel_post`: Cancel a scheduled post.
- `schedule_thread`: Create a thread of posts in order.

## FAQ

### Is there a free plan?

Hosted plans start with a 7-day trial (card required) then $29/month; self-hosting is free.

### Do I need an API key?

Not for the hosted OAuth endpoint; the npm package needs one.

### Can the agent delete things?

The site says it cannot delete anything or change your account.

### What licence is the code under?

AGPL-3.0-or-later.

### Is Postbase free?

Postbase has a free plan, with paid plans for more usage or features. Paid plans start at $29 a month.

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

Run this command in your terminal: claude mcp add --transport http postbase https://mcp.postbase.so/mcp

### What are the best alternatives to Postbase?

The closest alternatives to Postbase are HyperFrames by HeyGen, ffmpeg-skill, Google Ads + Meta Ads + SEO/GEO MCP, Calven and MCP.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [MCP](https://ai-powered.com/mcp/mcp-mwhffe53): MCP is a freemium MCP server for marketing and seo.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.

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