Skip to content
MCP server

Postbase

Draft and schedule posts and threads to X, LinkedIn, Bluesky and Mastodon from your AI

Install
Pricing
Freemium
Platforms
Web, API, self-hosted
Runs
Locally or Remotely
Version
0.3.0
Listing updated
2 days ago

About Postbase

Postbase is a freemium MCP server for design and media. It can run locally on your machine or as a hosted remote server.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://mcp.postbase.so/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "postbase": {
      "url": "https://mcp.postbase.so/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • POSTBASE_API_KEYAPI key from Postbase → DevelopersRequired
  • POSTBASE_API_URLAPI base URL, for self-hosted instances (default https://www.postbase.so/api/v1)

Tools this server provides (11)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Freemium, from $29 a month

7-day trial, then Creator $29/month, Team $39, Pro $59, Agency $99; self-host free

Prices change. Check postbase.so before you buy.

Postbase 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 to Postbase

  1. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  2. ffmpeg-skill

    MCP server

    Local FFmpeg video and audio editing tools for coding agents over MCP

    Runs locally
    • Open source
    • 6.9K GitHub stars
    • Design and media
  3. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  4. Calven

    MCP server

    Product marketing context from Calven delivered into Claude, ChatGPT and other AI tools

    Not checked yet
    • Remote
    • Free trial
    • 3 GitHub stars
    • Marketing and SEO
  5. MCP

    MCP server

    MCP server for planning, scheduling and measuring social and ad campaigns with approvals

    • Remote
    • Freemium
    • Marketing and SEO