Skip to main content
Glama
postfast-mcp

postfast-mcp

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.

Related MCP server: kadenzo-mcp

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:

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

Tool

Description

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)

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.

Tool

Description

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)

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.

Tool

Description

list_webhook_endpoints

List the workspace's endpoints, turned-off ones included (active, disabledReason, last success and failure)

get_webhook_endpoint

Fetch one endpoint

create_webhook_endpoint

Register an HTTPS URL for some or all of post.published, post.failed, account.connected and account.disconnected; the answer carries the signing secret, which is never shown again

update_webhook_endpoint

Change an endpoint's URL, events or description, or turn it off and back on

delete_webhook_endpoint

Delete an endpoint together with its delivery log

test_webhook_endpoint

Send a test event, or a sample of one event type, and see how your receiver answered

list_webhook_deliveries

An endpoint's delivery log for the last 30 days: each attempt's status code, and the payload as sent

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:

Platform

Controls

X (Twitter)

xRetweetUrl

Instagram

instagramPublishType (TIMELINE/STORY/REEL), instagramTrialReelStrategy (MANUAL/SS_PERFORMANCE — trial reel shown to non-followers; Reels only, no collaborators), instagramPostToGrid, instagramCollaborators, instagramLocationId/instagramLocationName (geotag from search_places), instagramIsAiGenerated (adds the "AI info" label; set at creation only)

Facebook

facebookContentType (POST/REEL/STORY), facebookAllowComments, facebookPrivacy, facebookCarouselMainLink, facebookCarouselShowEndCard, facebookReelsCollaborators, facebookTargetCountries (ISO alpha-2, max 25), facebookPlaceId/facebookPlaceName (geotag from search_places)

TikTok

tiktokTitle (photo posts, max 90 chars), tiktokMusicSoundId/tiktokMusicSoundName (Commercial Music Library sound from list_tiktok_sounds; photo, carousel and video posts — on video it plays at 50% volume over the original audio at 50%; exclusive with tiktokAutoAddMusic), tiktokIsDraft, tiktokAllowComments, tiktokAllowDuet, tiktokAllowStitch, tiktokBrandOrganic, tiktokBrandContent, tiktokAutoAddMusic (photo/carousel posts), tiktokIsAigc, tiktokPrivacy (deprecated — account default applies)

YouTube

youtubeTitle, youtubePrivacy (PUBLIC/PRIVATE/UNLISTED), youtubeTags, youtubeCategoryId, youtubeIsShort, youtubeMadeForKids, youtubeContainsSyntheticMedia (altered/synthetic content disclosure; set at creation only), youtubePlaylistId, youtubeThumbnailKey, youtubeLanguage (BCP-47 code such as en-GB or pt-BR; sets the video language and the title and description language), youtubeCaptionKey (an uploaded .srt/.vtt file, added as the video's caption track in youtubeLanguage, which it requires)

Pinterest

pinterestBoardId (required), pinterestLink

LinkedIn

linkedinAttachmentKey (an uploaded PDF, Word or PowerPoint file, max 60MB, shown in the post as pages to swipe through; not with images or video on the same post), linkedinAttachmentTitle (the document's title; "Document" if omitted)

Threads

threadsTopicTag (the post's topic: one topic, not a list; 1-50 chars, no . or &; takes precedence over a #hashtag in the content, which then stays plain text. Like every control it applies to every post in the call, so use separate calls for different topics)

Google Business Profile

gbpLocationId (required), gbpTopicType (STANDARD/EVENT/OFFER), gbpCallToActionType, gbpCallToActionUrl, gbpEventTitle, gbpEventStartDate, gbpEventEndDate, gbpOfferCouponCode, gbpOfferRedeemUrl, gbpOfferTerms

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 PPTX documents for LinkedIn. A caption file comes back with type CAPTION: pass its key as controls.youtubeCaptionKey, never in mediaItems. A document comes back with type DOCUMENT: pass its key as controls.linkedinAttachmentKey, never in mediaItems.

You can also use get_upload_urls directly if you need more control over the upload process.

Environment Variables

Variable

Required

Description

POSTFAST_API_KEY

Yes

Your workspace API key

POSTFAST_API_URL

No

API base URL (default: https://api.postfa.st)

Testing

Verify everything works with the MCP Inspector:

POSTFAST_API_KEY=your-key npx @modelcontextprotocol/inspector npx postfast-mcp

Official packages

Where

Name

npm

postfast-mcp, and postfast, which runs the same server at the same version: npx -y postfast

MCP Registry

st.postfa/postfast (up to 0.15.3: io.github.peturgeorgievv-factory/postfast-mcp, now deprecated)

Hosted MCP server

https://mcp.postfa.st/mcp

API Docs

Full REST API documentation: postfa.st/docs

Development

npm install
npm run build
node dist/stdio/index.js

Tools are authored once in src/core (the catalog — schemas, descriptions, annotations, per-binding availability) and exposed to consumers as postfast-mcp/core; src/stdio binds the catalog to the public REST API. packages/postfast is the postfast package: a bin that starts this server, pinned to the same version. Releases: PRs add a .changeset/*.md; npm run version folds them into the bump + changelog, and pushing the vX.Y.Z tag publishes postfast-mcp and postfast to npm (OIDC trusted publishing, no npm token), the MCPB release, and the MCP Registry entry (signed in with the key in postfa.st's DNS).

Badges

peturgeorgievv-factory/postfast-mcp MCP server

License

MIT

Available Tools

11 tools
create_postsBInspect

Create and schedule social media posts. Supports batch creation (up to 15 posts). Each post targets a specific social account.

Inputs: posts (required), controls (required), status, approvalStatus.

delete_postBInspect

Delete a social media post by ID

Inputs: id (required).

get_post_analyticsAInspect

Fetch published posts with their latest performance metrics (impressions, reach, likes, comments, shares). Only returns published posts that have a platform post ID. LinkedIn personal accounts are excluded. Supported: Instagram, Facebook, TikTok, Threads, YouTube, LinkedIn (company pages), Pinterest (Business accounts). Pinterest extras include pin_clicks, outbound_clicks, saves_90d, save_rate_90d (saves are 90-day rolling because Pinterest API does not expose lifetime totals); video pins additionally surface mrc_views, views_10s, avg_watch_time, v50_watch_time, video_starts, quartile_95_views.

Inputs: startDate (required), endDate (required), platforms, socialMediaIds.

get_upload_urlsAInspect

Get signed upload URLs for media files. Upload your file to the returned URL via PUT, then use the key in create_posts mediaItems.

Inputs: contentType (required), count.

list_accountsAInspect

List all social media accounts connected to the workspace

Inputs: no named parameters.

list_gbp_locationsAInspect

List Google Business Profile locations for a connected GBP account

Inputs: socialMediaId (required).

list_pinterest_boardsAInspect

List Pinterest boards for a connected Pinterest account

Inputs: socialMediaId (required).

list_postsAInspect

List social media posts with optional filters for platform, status, and date range

Inputs: page, limit, platforms, statuses, +2 more.

list_youtube_playlistsBInspect

List YouTube playlists for a connected YouTube account

Inputs: socialMediaId (required).

upload_mediaAInspect

Upload a local file to PostFast and get back a media key for use in create_posts. Handles the full flow: detects content type, gets a signed URL, uploads the file, and returns the key and type.

Inputs: filePath (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 11 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: create, delete, list posts; upload media; get analytics; list accounts and platform-specific resources (GBP, Pinterest, YouTube). No overlapping functionality.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern in snake_case (e.g., create_posts, list_accounts, get_upload_urls), with no mixing of conventions.

    Tool Count5/5

    11 tools is well-scoped for a social media posting server, covering account listing, post management, media upload, analytics, and platform-specific queries without unnecessary bloat.

    Completeness2/5

    Missing essential operations: no update_post tool to modify existing posts, and no get_post by ID (only list). This creates a significant gap for agents needing to edit posts.

    Maintenance

    ActivityActive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      A full social media management MCP server enabling post, read, schedule, and analyze across Facebook, Instagram, LinkedIn, X/Twitter, Pinterest, and YouTube from any MCP-compatible AI client.
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Schedule, manage, generate, and analyze social posts across 11 networks (Instagram, TikTok, X, LinkedIn, YouTube, Facebook, Pinterest, Threads, Bluesky, Mastodon, Telegram) from any AI agent — 13 tools covering scheduling, media upload, AI caption generation, best-times, analytics, listening, and comments.
      13
      54 npm
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Gives AI agents the ability to schedule and publish social media posts to Instagram, TikTok, YouTube, X, LinkedIn, Facebook, Pinterest, Threads, and Bluesky. Create, schedule, and bulk-plan posts with per-platform captions, then check per-platform results and retry failures.
      82
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to post, schedule, thread, delete, and analyze social media posts across platforms like X, Bluesky, LinkedIn, and Instagram through a single MCP interface.
      MIT