How do I install Postfast?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Postfast need an API key?

The publisher lists these environment variables: POSTFAST_API_KEY.

What transport does Postfast use?

Postfast runs locally over stdio.

Postfast MCP server

Q: When was Postfast last checked?

Last checked 2026-11-10. MCP server for the PostFast API — schedule and manage social media posts via AI tools

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y [email protected]

Credentials from the publisher

POSTFAST_API_KEY — Your PostFast workspace API key. Get it from https://app.postfa.st/dashboard → API in the sidebar.

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1POSTFAST_API_KEY=<secret> claude mcp add io.github.peturgeorgievv-factory-postfast-mcp -- npx -y postfast-mcp@0.15.1

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.peturgeorgievv-factory-postfast-mcp": {4      "command": "npx",5      "args": [6        "-y",7        "[email protected]"8      ],9      "env": {10        "POSTFAST_API_KEY": "<secret>"11      }12    }13  }14}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 0.15.1
API key

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

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.

Quick Start

1. Get your API 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-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)

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 or ; sets the video language and the title and description language), (an uploaded / file, added as the video's caption track in , which it requires)

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

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. 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).

Badges

License

MIT

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Postfast?

Does Postfast need an API key?

What transport does Postfast use?

When was Postfast last checked?

Documentation

PostFast MCP Server

Hosted connector (no install)

Quick Start

1. Get your API key

2. Install

Claude Desktop (recommended)

Claude Code

Cursor

Cursor / VS Code / Windsurf / Other MCP clients

3. Use it

Available Tools

Social Inbox (comments)

Supported Platforms

Platform-Specific Controls

Media Upload

Environment Variables

Testing

API Docs

Development

Badges

License