About postbolt
postbolt is an MCP server for publishing and scheduling social posts through the PostBolt API. It lets AI clients manage posts across 13 named platforms, with media uploads and platform-specific content options.
Key features
- 01Publish posts immediately
- 02Schedule posts for later
- 03List, inspect, update, or cancel posts
- 04Upload images for posts
- 05Set platform-specific content
Use cases
- 01Publish one post to multiple platforms
- 02Schedule posts with different copy per platform
- 03Attach an image to an Instagram post
MCP support
Exposes PostBolt publishing, scheduling, post management, and media upload tools, plus profile and connected-account resources, to MCP clients.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
npx -y postbolt-mcpPOSTBOLT_API_KEYSecretYour PostBolt API key (starts with sk_)Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.
Tools
7Saved tool list · updated 2w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| content | string | Yes | The text content of the post |
| media_id | number | No | ID of a previously uploaded media file |
| platforms | array | Yes | Platforms to publish to |
| custom_content | object | No | Platform-specific content overrides, e.g. { twitter: 'short version' } |
Details
From the project READMEpostbolt-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:
{
"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.
| 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
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.