Postfast MCP

What peturgeorgievv-factory/postfast-mcp MCP server does

The peturgeorgievv-factory/postfast-mcp MCP server connects AI clients to the PostFast API for social media operations. It supports account discovery, post creation and scheduling, post listing and deletion, media uploads, platform-specific lookup data, performance reporting, follower history, and comment moderation.

Supported destinations include Facebook, Instagram, X, TikTok, LinkedIn, YouTube, Threads, Pinterest, Bluesky, Telegram, and Google Business Profile. The available capabilities depend on the connected account and the platform. For example, Pinterest posts require a board, Google Business Profile posts require a location, and some analytics are limited to particular account types such as LinkedIn company pages or Pinterest Business accounts.

How it works

The server presents PostFast operations as MCP tools that an assistant can call. Agents can first inspect connected accounts, then create batches of up to 15 posts, attach uploaded media, and apply platform-specific controls. Media can be uploaded from a local file through one tool, which detects the file type, obtains a signed URL, transfers the file, and returns a key for use when creating a post. Supported media formats are JPEG, PNG, GIF, WebP, MP4, WebM, and MOV.

The social inbox covers comments rather than direct messages. Agents can find conversations, inspect replies, check unread totals, respond publicly, send one Instagram private reply per comment within seven days, change comment visibility or deletion state, mark conversations read, update triage status, and assign conversations to workspace members. Reply availability is returned by the server for each conversation.

Setup and configuration

The peturgeorgievv-factory/postfast-mcp MCP server can be installed for local stdio use with:

npx -y postfast-mcp

Local use requires a PostFast workspace API key in POSTFAST_API_KEY. POSTFAST_API_URL can override the default API base URL, which is https://api.postfa.st. The README provides configuration examples for Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, and other MCP clients.

A hosted streamable-HTTP endpoint is also available at https://mcp.postfa.st/mcp. Clients that support OAuth can authenticate there by signing in to PostFast and authorizing access, without managing a local API key.

Tools and capabilities

Key operations include:

• Listing accounts, posts, Pinterest boards, YouTube playlists, Google Business Profile locations, TikTok commercial sounds, and places for tagging.
• Creating scheduled posts in batches, deleting PostFast posts, and generating account-connection links.
• Retrieving published-post analytics and daily follower-count changes.
• Managing comment conversations with filtering, replies, private Instagram replies, moderation actions, status changes, read state, and assignment.
• Applying controls for formats such as Instagram Stories and Reels, Facebook Reels and Stories, YouTube Shorts, TikTok settings, Pinterest links, LinkedIn attachments, and Google Business Profile offers or events.

Limitations and notes

Deleting a post from PostFast does not remove content that has already been published on a social platform. Inbox data starts from the time an account is connected and does not backfill older comments. Inbox coverage is limited to comments on TikTok, Instagram, Facebook Pages, and Threads, and the account's inboxCapable value indicates current availability.

Platform restrictions still apply. Instagram private replies are limited to one per comment and must be sent within seven days. Comment deletion cannot be undone. Some controls are creation-time only, including Instagram's AI-information label and YouTube's synthetic-media disclosure. The README does not state the project's software license or PostFast subscription pricing.