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:
MCP server for the PostFast API — schedule and manage social media posts via AI tools
2026-11-14
स्टार
—
टूल
—
अपटाइम
—
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.
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):
"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)
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)
The upload_media tool handles the full flow in a single call:
Detects content type from file extension
Gets a signed upload URL from PostFast
Uploads the file
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.
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.
Releases: PRs add a .changeset/*.md; npm run version folds them into the
bump + changelog, and pushing the vX.Y.Z tag publishes npm + MCP Registry +
the MCPB release from CI (OIDC — no tokens anywhere).
अभी टूल सूची नहीं है। रिमोट सर्वर को पहले हेल्थ चेक के बाद सूची मिलती है।
FAQ
सवाल
Postfast कैसे इंस्टॉल करें?
इस पेज पर Cursor, Claude Desktop, Claude Code या VS Code के लिए stdio कॉन्फ़िग कॉपी करें। यह पब्लिशर का इंस्टॉल इस्तेमाल करता है, PlugMCP प्रॉक्सी नहीं।
क्या Postfast के लिए API key चाहिए?
इस रिकॉर्ड में कोई ज़रूरी एनवायरनमेंट वेरिएबल दर्ज नहीं है।
Postfast कौन सा ट्रांसपोर्ट इस्तेमाल करता है?
Postfast stdio पर लोकल चलता है।
Postfast की पिछली जाँच कब हुई थी?
पिछली जाँच 2026-11-14 को हुई। MCP server for the PostFast API — schedule and manage social media posts via AI tools