# peturgeorgievv-factory/postfast-mcp [Health: Active]

**Category:** 🌐 Social Media  
**Repository:** https://github.com/peturgeorgievv-factory/postfast-mcp  
**GitHub Stars:** 5  
**npm Downloads (last month):** 1082816  
**Views:** 4  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/peturgeorgievv-factory-postfast-mcp

## Description
Schedule and manage social media posts across 10 platforms (Instagram, Facebook, TikTok, X, LinkedIn, YouTube, Threads, Pinterest, Bluesky, Telegram) from any MCP-compatible AI assistant.

## Tools
Capabilities this server exposes over MCP:

- **list_accounts** — List connected social media accounts (each with `connectionStatus` — `CONNECTED`/`DISABLED` — `disabledReason`, `followerCount`/`followerCountUpdatedAt`, and `inboxCapable`)
- **list_posts** — List posts with filters (specific IDs, platform, status, date range)
- **create_posts** — Create and schedule posts (batch, up to 15)
- **delete_post** — Delete a post from PostFast by ID (does not remove an already-published post from the platform)
- **upload_media** — Upload a local file and get a media key (handles the full flow)
- **get_upload_urls** — Get signed URLs to upload media files
- **list_pinterest_boards** — Get Pinterest boards for an account
- **list_youtube_playlists** — Get YouTube playlists for an account
- **list_gbp_locations** — Get Google Business Profile locations for an account
- **search_places** — Find a place to tag posts (the `id` works for both `facebookPlaceId` and `instagramLocationId`)
- **generate_connect_link** — Generate a link for clients to connect accounts — optionally scoped to specific platforms, with a `redirectUrl` the user returns to (carrying `status`, `platform`, `accountId` and your own `externalId`)
- **get_post_analytics** — Fetch published posts with performance metrics — Instagram, Facebook, TikTok, Threads, YouTube, LinkedIn (company pages), Pinterest (Business accounts)
- **get_follower_history** — Daily follower-count history for an account (current count + `delta` over a date range) — Facebook Pages, Instagram, YouTube, Pinterest, Threads, Bluesky, Telegram, LinkedIn (company pages), TikTok
- **list_tiktok_sounds** — Trending pre-cleared Commercial Music Library tracks for a TikTok account (attach via `controls.tiktokMusicSoundId`)
- **list_inbox_conversations** — List comment conversations (filters: platforms, accounts, statuses, unread-only, assignee)
- **get_inbox_conversation** — Fetch one conversation with its reply-capability fields
- **list_inbox_items** — List a conversation's comments and replies (with `state` and, on Instagram, `canPrivateReply`)
- **get_inbox_unread_count** — Total unread comment count across the workspace
- **reply_to_inbox_item** — Reply publicly under a specific comment
- **send_inbox_private_reply** — Instagram only: one private reply per comment, within 7 days
- **set_inbox_item_state** — HIDE / UNHIDE / DELETE a comment on the platform (DELETE cannot be undone)
- **mark_inbox_conversation_read** — Zero a conversation's unread count
- **set_inbox_conversation_status** — Triage: OPEN / SNOOZED / CLOSED
- **assign_inbox_conversation** — Assign a conversation to a workspace member (or unassign)

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "postfast-mcp": {
    "command": "npx",
    "args": ["-y","@modelcontextprotocol/inspector"],
    "env": {
      "POSTFAST_API_KEY": "",
      "POSTFAST_API_URL": ""
    }
  }
}
```

**Requires environment variables:** `POSTFAST_API_KEY`, `POSTFAST_API_URL` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## 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:

```bash
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.

_Full upstream README: https://allmcps.com/mcp/peturgeorgievv-factory-postfast-mcp/readme_