peturgeorgievv-factory/postfast-mcp

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:
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.
2. Install
Choose your preferred method:
Claude Desktop (recommended)
Download the extension from the Claude Desktop extension directory or install manually:
1. Add to claude_desktop_config.json:
2. 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.
After installing, set your API key — pick one of these:
Then restart Claude Code.
**Via manual config:**
Add to your project's .mcp.json:
Or add it for every project:
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):
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) |