About io.github.Whitemarmot/postbolt
io.github.Whitemarmot/postbolt is an MCP server in the Commerce category: publish to 13+ social media platforms from any AI agent via MCP.
Install
claude mcp add io-github-whitemarmot-postbolt -- npx -y postbolt-mcpnpx -y postbolt-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about io.github.Whitemarmot/postbolt
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
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
-
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
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.