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

**Category:** 🌐 Social Media  
**Repository:** https://github.com/peturgeorgievv-factory/postfast-mcp  
**GitHub Stars:** 7  
**npm Downloads (last month):** 1628  
**Views:** 5  
**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, accounts, platform, status, date range); each post carries its key settings in `controls` (Threads topic, Instagram/Facebook format, TikTok draft flag, YouTube privacy)
- **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)
- **delete_posts** — Delete up to 100 posts from PostFast in one call; returns `deletedIds` and `notFoundIds` (does not remove already-published posts 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`, plus `accountIds` after a Facebook or LinkedIn page step)
- **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","postfast-mcp"],
    "env": {
      "POSTFAST_API_KEY": ""
    }
  }
}
```

**Requires environment variables:** `POSTFAST_API_KEY` — 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 does

PostFast exposes social publishing and account-management workflows as MCP tools. Agents can inspect connected accounts, create or remove scheduled posts, upload media, retrieve platform-specific destinations, and query publishing performance. Supported account types include Facebook, Instagram, X, TikTok, LinkedIn, YouTube, Threads, Pinterest, Bluesky, Telegram, and Google Business Profile.

The server also covers comment moderation for supported social accounts. Its inbox tools list conversations and items, report unread totals, post public replies, send eligible Instagram private replies, change comment visibility or deletion state, and assign or triage conversations.

## How it works

A local installation runs the `postfast-mcp` package with `npx` and authenticates requests using `POSTFAST_API_KEY`. The hosted option uses `https://mcp.postfa.st/mcp` as a remote, streamable-HTTP MCP server and authenticates through PostFast OAuth. In either mode, the assistant invokes MCP tools against the PostFast workspace and its connected accounts.

Post creation supports batches of up to 15 posts. Media can be uploaded through the complete local-file flow or through signed upload URLs. Posts accept platform-specific controls such as Instagram publication type, Facebook content type, TikTok music and draft settings, and YouTube privacy or playlist settings.

## Setup and configuration

For local use, generate an API key from the API section of the PostFast dashboard, then add the server to the MCP client's configuration:

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

Claude Desktop, Claude Code, Cursor, VS Code, and Windsurf are named setup targets. Claude Code also supports the PostFast plugin. The hosted endpoint avoids local installation and API-key configuration, but requires an MCP client with OAuth support.

## Tools and capabilities

- Inspect account connection status, follower counts, and inbox availability.
- Filter posts by IDs, account, platform, status, and date range.
- Create up to 15 posts in one call and delete up to 100 PostFast records.
- Upload media, retrieve signed upload URLs, and look up boards, playlists, locations, and taggable places.
- Generate account-connection links with platform scoping and redirect data.
- Retrieve post analytics and daily follower history for supported platforms.
- Find TikTok Commercial Music Library tracks for use in post controls.
- List, reply to, moderate, assign, and triage comment conversations.

## Limitations and notes

Deleting a post from PostFast does not remove content that has already been published on a social platform. Inbox coverage is limited to comments, not direct messages, and begins when an account is connected rather than backfilling older activity. Reply permissions are returned by the server for each conversation; Instagram private replies are limited to one per comment within seven days. Platform-specific controls and analytics depend on the account type and network involved.

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