Postbolt

io.github.WhitemarmotPublished by GitHub account Whitemarmotv1.0.2Updated Oct 24, 2026

Publish to 13+ social media platforms from any AI agent via MCP.

Overview

AI-generated overview

Lets an assistant publish, schedule, and manage social media posts across 13+ platforms through the PostBolt API.

What you can do
Provides tools to publish a post immediately to one or more platforms, schedule a post for a future time, list and inspect posts with per-platform results, update or cancel scheduled posts, and upload an image to attach. It also exposes resources for the account profile (plan, quota, allowed platforms) and connected social accounts.
When to use it
Useful when you want an assistant to draft and push content to multiple social networks from one place, queue posts for later, or check how a post performed per platform without opening each network's own dashboard.
Requirements
Runs locally over stdio, typically launched with npx, so Node.js is needed. Requires a PostBolt account and an API key supplied as the POSTBOLT_API_KEY environment variable. Network access to the PostBolt API is required. Desktop MCP clients only.
Before you install
The API key (POSTBOLT_API_KEY) is a secret that grants access to your PostBolt account and connected social accounts; keep it out of shared configs. Publishing and scheduling write publicly visible content, and cancel_post changes state. Posting consumes plan quota, and platform availability depends on your plan.

Installation

In SourceWeft

  1. Open Postbolt in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

postbolt-mcp

MCP server for PostBolt - publish to social media from any AI agent.

This package lets MCP-compatible clients (Claude Desktop, Claude Code, Cursor, Windsurf) schedule and publish posts to 13+ social platforms through PostBolt's API with zero code.

Setup

  1. Get your API key at postbolt.dev

  2. Add to your MCP client config:

json
{
  "mcpServers": {
    "postbolt": {
      "command": "npx",
      "args": ["-y", "postbolt-mcp"],
      "env": {
        "POSTBOLT_API_KEY": "sk_..."
      }
    }
  }
}

Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

Claude Code: ~/.claude/settings.json under mcpServers

Tools

publish_post

Publish a post immediately to one or more platforms.

ParameterTypeRequiredDescription
contentstringyesThe text content
platformsstring[]yesPlatforms to publish to
media_idnumbernoID from upload_media
custom_contentobjectnoPlatform-specific overrides

schedule_post

Schedule a post for future publication.

ParameterTypeRequiredDescription
contentstringyesThe text content
platformsstring[]yesPlatforms to publish to
scheduled_forstringyesISO 8601 datetime
media_idnumbernoID from upload_media
custom_contentobjectnoPlatform-specific overrides

list_posts

List your posts with optional filtering.

ParameterTypeRequiredDescription
pagenumbernoPage number
statusstringnoFilter: pending, scheduled, published, partial, failed

get_post

Get detailed info about a post including per-platform results.

ParameterTypeRequiredDescription
post_idnumberyesThe post ID

update_post

Update a scheduled post's content or time.

ParameterTypeRequiredDescription
post_idnumberyesThe post ID
contentstringnoNew text content
custom_contentobjectnoNew platform overrides
scheduled_forstringnoNew ISO 8601 datetime

cancel_post

Cancel a scheduled post (refunds your post quota).

ParameterTypeRequiredDescription
post_idnumberyesThe post ID

upload_media

Upload an image to attach to posts (JPEG, PNG, GIF, WebP, max 10MB).

ParameterTypeRequiredDescription
file_pathstringyesAbsolute path to the image

Resources

ResourceURIDescription
Profilepostbolt://profileYour plan, quota, and allowed platforms
Accountspostbolt://accountsConnected social media accounts

Supported Platforms

twitter, linkedin, facebook, instagram, threads, tiktok, pinterest, bluesky, telegram, youtube, reddit, google_business, snapchat

Platform availability depends on your PostBolt plan.

Examples

Publish to Twitter and LinkedIn:

"Post 'Just shipped v2.0!' to Twitter and LinkedIn"

Schedule with platform-specific content:

"Schedule a post for tomorrow at 9am: 'Big news coming' on Twitter, 'We are excited to announce our latest update' on LinkedIn"

Upload an image and post:

"Upload /tmp/screenshot.png and post it to Instagram with caption 'Check this out'"

License

MIT


[Protected by Copyright01]
Protected by Copyright01 - Ref: CR-2026-91956 - Certified 2026-03-03

Source: README.md at commit 10d20a3

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts