English Français العربية

io.github.Whitemarmot/postbolt

Official registry Marketing and sales

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

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package postbolt-mcp
Claude Code 
claude mcp add postbolt -e 'POSTBOLT_API_KEY=<your postbolt_api_key>' -- npx -y postbolt-mcp@1.0.2
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "postbolt": {
            "command": "npx",
            "args": [
                "-y",
                "postbolt-mcp@1.0.2"
            ],
            "env": {
                "POSTBOLT_API_KEY": "<your postbolt_api_key>"
            }
        }
    }
}

Environment variables

  • POSTBOLT_API_KEY required secret Your PostBolt API key (starts with sk_)

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. postbolt-mcp
  2. Setup
  3. Tools
  4. Resources
  5. Supported Platforms
  6. Examples
  7. License

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.

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 - Ref: CR-2026-91956 - Certified 2026-03-03

Frequently asked questions

What is io.github.Whitemarmot/postbolt?

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

How do I install io.github.Whitemarmot/postbolt?

It runs on your machine. In Claude Code: claude mcp add postbolt -e 'POSTBOLT_API_KEY=<your postbolt_api_key>' -- npx -y postbolt-mcp@1.0.2. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.Whitemarmot/postbolt need an API key?

Yes. It expects POSTBOLT_API_KEY, which you set in its configuration.

Is io.github.Whitemarmot/postbolt open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.Whitemarmot/postbolt?

It is published by Whitemarmot. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.