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:

{
  "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

---

... View full README on GitHub