PostFast

PostFast MCP Server

MCP server for the PostFast API — schedule and manage social media posts via AI tools like Claude, Cursor, VS Code, and more.

Hosted connector (no install)

Prefer not to run anything locally? Connect to the hosted endpoint and authenticate with OAuth — no npx, no API key to manage:

https://mcp.postfa.st/mcp

Add it as a remote/streamable-HTTP MCP server in any client that supports OAuth (e.g. ChatGPT, Claude). You'll be prompted to sign in to PostFast and authorize access on first use.

Want to run the server yourself instead? Use the npx + API-key setup in Quick Start below.

Quick Start

1. Get your API key

Log in to PostFast, go to API in the sidebar, and generate a key.

2. Install

Choose your preferred method:

Claude Desktop (recommended)

Download the extension from the Claude Desktop extension directory or install manually:

1. Add to claude_desktop_config.json:

{

"mcpServers": { "postfast": { "command": "npx", "args": ["-y", "postfast-mcp"], "env": { "POSTFAST_API_KEY": "your-api-key-here" } } } }

1. Restart Claude Desktop.

Claude Code

Via plugin:

If you already added PostFast by hand, remove that entry before installing the plugin, or Claude Code shows two sets of PostFast tools.

/plugin marketplace add peturgeorgievv-factory/postfast-mcp

/plugin install postfast@postfast-mcp

After installing, set your API key — pick one of these:

# Option A: Add to your shell profile (~/.zshrc or ~/.bashrc)

export POSTFAST_API_KEY="your-api-key-here"

Option B: Add to ~/.claude/settings.json

{ "env": { "POSTFAST_API_KEY": "your-api-key-here" } }

Then restart Claude Code.

Via manual config:

Add to your project's .mcp.json:

{

"mcpServers": { "postfast": { "type": "stdio", "command": "npx", "args": ["-y", "postfast-mcp"], "env": { "POSTFAST_API_KEY": "your-api-key-here" } } } }

Or add it for every project:

claude mcp add --scope user postfast --env POSTFAST_API_KEY=your-api-key-here -- npx -y postfast-mcp

Cursor

This repository is also a Cursor plugin: the PostFast MCP server together with its two skills, for scheduling posts and for the comments inbox.

To install it, open Customize in Cursor, search the marketplace for PostFast, select Install, and paste your API key when Cursor asks for it. Cursor starts the server with that key, so there is nothing else to configure. If PostFast doesn't show up in the marketplace yet, add the server by hand with the config below.

Cursor / VS Code / Windsurf / Other MCP clients

Add to your MCP config (.mcp.json, mcp.json, or the tool's settings UI):

{

"mcpServers": { "postfast": { "type": "stdio", "command": "npx", "args": ["-y", "postfast-mcp"], "env": { "POSTFAST_API_KEY": "your-api-key-here" } } } }

3. Use it

Ask your AI assistant things like:

• "List my connected social accounts"
• "Schedule a post to Instagram for tomorrow at 9am"
• "Show me all scheduled posts for this week"
• "Upload this image and create a LinkedIn post with it"
• "Create a Facebook reel with this video"
• "Show me analytics for my Instagram posts this month"

Available Tools

Social Inbox (comments)

Comments on your posts — TikTok, Instagram, Facebook Pages, and Threads — in one inbox (an account's inboxCapable flag says what is live today). Comments only (no direct messages), from connect onward (no history backfill). Reply capability is always server-computed per conversation (canReply, maxReplyLength, windowState, disabledReason) — render from those fields, never platform assumptions.

Webhooks

PostFast can send a signed JSON event to your own HTTPS endpoint when a post publishes or fails for good, or when an account connects, reconnects or disconnects. Deliveries follow the Standard Webhooks spec (webhook-id, webhook-timestamp and webhook-signature headers), so any Standard Webhooks library verifies them. On the hosted connector, only workspace admins can use these tools.

Store the secret in your receiver as soon as the endpoint is created. An endpoint receives every event of its types from the whole workspace; to follow one account, filter on data.post.socialMediaId or data.account.id. A workspace can have 5 active endpoints.

Supported Platforms

Facebook, Instagram, X (Twitter), TikTok, LinkedIn, YouTube, BlueSky, Threads, Pinterest, Telegram, Google Business Profile

Platform-Specific Controls

When creating posts, you can pass platform-specific settings via the controls parameter:

Media Upload

The upload_media tool handles the full flow in a single call:

1. Detects content type from file extension
2. Gets a signed upload URL from PostFast
3. Uploads the file
4. Returns a key and type ready to use in create_posts

Supported formats: JPEG, PNG, GIF, WebP, MP4, WebM, MOV, plus SRT and VTT caption files for YouTube and PDF, DOC, DOCX, PPT and