postfast-mcp
This MCP server lets an AI assistant manage a PostFast social media workspace: inspect connected accounts, create and schedule posts across 11 platforms, upload media, clean up posts, pull analytics, and invite clients to connect accounts.
List connected accounts (
list_accounts) to get the social account IDs used everywhere else.Browse posts (
list_posts) with filters for platform, status (draft/scheduled/published/failed), date range, and pagination.Create and schedule posts in batches (
create_posts) of up to 15 posts, each targeting a social account, with media attachments, first comment,scheduledAt, draft vs. scheduled status, and approval status.Set platform-specific controls on posts: X retweet URL; Instagram publish type (timeline/story/reel), grid posting, collaborators; Facebook content type (post/reel/story), privacy, comments, carousel options, reel collaborators/cover; TikTok draft, privacy, comments/duet/stitch, brand and AIGC flags, auto music; YouTube title, privacy, tags, category, Shorts, made-for-kids, playlist, thumbnail; Pinterest board/link; LinkedIn document attachment and title; Threads topic tag; Google Business Profile location, post type (standard/event/offer), CTA, and event/offer fields.
Delete a post (
delete_post) from PostFast by ID.Fetch performance analytics (
get_post_analytics) for published posts — impressions, reach, likes, comments, shares, plus Pinterest pin-click/save and video-metric extras — filtered by date range, platform, or account.Upload media either in one step (
upload_mediawith a local file path) or manually via signed URLs (get_upload_urls) for JPEG, PNG, GIF, WebP, MP4, WebM, and MOV files.Look up platform resources: Pinterest boards, YouTube playlists, and Google Business Profile locations for a given account.
Generate client connect links (
generate_connect_link) with optional email delivery and a 1–30 day expiry so external clients can link their own social accounts.
Provides tools for scheduling and managing posts on BlueSky, including account listing, media uploads, and batch post creation.
Provides tools for scheduling posts, reels, and stories with controls for content type, privacy settings, comments, and collaborators. Supports retrieval of post analytics and performance metrics.
Provides tools for scheduling posts, stories, and reels with options for publish type (timeline/story/reel), grid posting, and collaborator tagging. Supports retrieval of post analytics and performance metrics.
Provides tools for scheduling pins to specific boards with support for link attachments and required board selection.
Provides tools for scheduling and managing posts on Telegram with media upload capabilities.
Provides tools for scheduling and managing posts on Threads with support for retrieving post analytics and performance metrics.
Provides tools for scheduling videos with privacy controls, comment/duet/stitch permissions, music auto-add, brand content flags, and draft status. Supports retrieval of post analytics and performance metrics.
Provides tools for scheduling videos and Shorts with title, tags, category ID, privacy settings, playlist assignment, and thumbnail management. Supports retrieval of post analytics and performance metrics.
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/mcpAdd 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:
Claude Desktop (recommended)
Download the extension from the Claude Desktop extension directory or install manually:
Add to
claude_desktop_config.json:
{
"mcpServers": {
"postfast": {
"command": "npx",
"args": ["-y", "postfast-mcp"],
"env": {
"POSTFAST_API_KEY": "your-api-key-here"
}
}
}
}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-mcpAfter 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-mcpCursor
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 connected social media accounts (each with |
| List posts with filters (specific IDs, accounts, platform, status, date range); each post carries its key settings in |
| Create and schedule posts (batch, up to 15) |
| Delete a post from PostFast by ID (does not remove an already-published post from the platform) |
| Delete up to 100 posts from PostFast in one call; returns |
| Upload a local file and get a media key (handles the full flow) |
| Get signed URLs to upload media files |
| Get Pinterest boards for an account |
| Get YouTube playlists for an account |
| Get Google Business Profile locations for an account |
| Find a place to tag posts (the |
| Generate a link for clients to connect accounts — optionally scoped to specific platforms, with a |
| Fetch published posts with performance metrics — Instagram, Facebook, TikTok, Threads, YouTube, LinkedIn (company pages), Pinterest (Business accounts) |
| Daily follower-count history for an account (current count + |
| Trending pre-cleared Commercial Music Library tracks for a TikTok account (attach via |
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 comment conversations (filters: platforms, accounts, statuses, unread-only, assignee) |
| Fetch one conversation with its reply-capability fields |
| List a conversation's comments and replies (with |
| Total unread comment count across the workspace |
| Reply publicly under a specific comment |
| Instagram only: one private reply per comment, within 7 days |
| HIDE / UNHIDE / DELETE a comment on the platform (DELETE cannot be undone) |
| Zero a conversation's unread count |
| Triage: OPEN / SNOOZED / CLOSED |
| 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 the workspace's endpoints, turned-off ones included ( |
| Fetch one endpoint |
| Register an HTTPS URL for some or all of |
| Change an endpoint's URL, events or description, or turn it off and back on |
| Delete an endpoint together with its delivery log |
| Send a test event, or a sample of one event type, and see how your receiver answered |
| 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) |
|
| |
| |
TikTok |
|
YouTube |
|
| |
| |
Threads |
|
Google Business Profile |
|
Media Upload
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
keyandtypeready to use increate_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 |
| Yes | Your workspace API key |
| No | API base URL (default: |
Testing
Verify everything works with the MCP Inspector:
POSTFAST_API_KEY=your-key npx @modelcontextprotocol/inspector npx postfast-mcpOfficial packages
Where | Name |
npm |
|
MCP Registry |
|
Hosted MCP server |
|
API Docs
Full REST API documentation: postfa.st/docs
Development
npm install
npm run build
node dist/stdio/index.jsTools 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
License
MIT
Available Tools
11 toolscreate_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).
generate_connect_linkBInspect
Generate a shareable link for external clients to connect their social accounts to the workspace
Inputs: expiryDays, sendEmail, email.
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
Scored across 11 tools
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.
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.
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.
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
Related MCP Connectors
Schedule and publish social posts across 9 platforms (Instagram, LinkedIn, X, TikTok, Facebook, Threads, Pinterest, Bluesky, Mastodon) straight from Claude, ChatGPT, Cursor, or any MCP client. Create, edit, and reschedule posts, upload media, and pull account and post analytics, follower demographics, and best-time windows. 20 tools, free on every plan.
Agent-first social media publishing, scheduling, analytics, and unified inbox API + 16-tool MCP server across 18 social platforms (X, LinkedIn, Instagram, YouTube, TikTok, Threads, Bluesky, Reddit, Telegram, Discord, Mastodon, Facebook, Pinterest).
Social media MCP: publish, schedule & analyze posts on TikTok, Instagram, YouTube, LinkedIn & X
Connect any AI agent to 11+ social platforms: schedule, publish & track posts via hosted MCP.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceA 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
- AlicenseAqualityCmaintenanceSchedule, 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.1354 npmMIT

AdaptlyPostofficial
AlicenseAqualityBmaintenanceGives 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.82MIT- AlicenseNot gradedqualityBmaintenanceEnables 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