Postbolt README
The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Postbolt listing page.
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
-
Get your API key at postbolt.dev
-
Add to your MCP client config:
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.
| Parameter | Type | Required | Description |
|---|---|---|---|
| content | string | yes | The text content |
| platforms | string[] | yes | Platforms to publish to |
| media_id | number | no | ID from upload_media |
| custom_content | object | no | Platform-specific overrides |
schedule_post
Schedule a post for future publication.
| Parameter | Type | Required | Description |
|---|---|---|---|
| content | string | yes | The text content |
| platforms | string[] | yes | Platforms to publish to |
| scheduled_for | string | yes | ISO 8601 datetime |
| media_id | number | no | ID from upload_media |
| custom_content | object | no | Platform-specific overrides |
list_posts
List your posts with optional filtering.
| Parameter | Type | Required | Description |
|---|---|---|---|
| page | number | no | Page number |
| status | string | no | Filter: pending, scheduled, published, partial, failed |
get_post
Get detailed info about a post including per-platform results.
| Parameter | Type | Required | Description |
|---|---|---|---|
| post_id | number | yes | The post ID |
update_post
Update a scheduled post's content or time.
| Parameter | Type | Required | Description |
|---|---|---|---|
| post_id | number | yes | The post ID |
| content | string | no | New text content |
| custom_content | object | no | New platform overrides |
| scheduled_for | string | no | New ISO 8601 datetime |
cancel_post
Cancel a scheduled post (refunds your post quota).
| Parameter | Type | Required | Description |
|---|---|---|---|
| post_id | number | yes | The post ID |
upload_media
Upload an image to attach to posts (JPEG, PNG, GIF, WebP, max 10MB).
| Parameter | Type | Required | Description |
|---|---|---|---|
| file_path | string | yes | Absolute path to the image |
Resources
| Resource | URI | Description |
|---|---|---|
| Profile | postbolt://profile | Your plan, quota, and allowed platforms |
| Accounts | postbolt://accounts | Connected 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 - Ref: CR-2026-91956 - Certified 2026-03-03