# PostFast MCP – schedule social posts to 11 platforms from Claude/Cursor/ChatGPT

> Source: <https://github.com/peturgeorgievv-factory/postfast-mcp>
> Published: 2026-06-18 13:16:48+00:00

MCP server for the [PostFast](https://postfa.st) API — schedule and manage social media posts via AI tools like Claude, Cursor, VS Code, and more.

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.

Log in to [PostFast](https://app.postfa.st/dashboard), go to **API** in the sidebar, and generate a key.

Choose your preferred method:

Download the extension from the [Claude Desktop extension directory](https://claude.ai/extensions) 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.

**Via plugin (pending marketplace approval):**

```
/plugin install postfast@claude-plugins-official
```

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.local.json
# { "env": { "POSTFAST_API_KEY": "your-api-key-here" } }
```

Then restart Claude Code.

**Via manual config:**

Add to your project's `.mcp.json`

or `~/.claude/.mcp.json`

(global):

```
{
  "mcpServers": {
    "postfast": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "postfast-mcp"],
      "env": {
        "POSTFAST_API_KEY": "your-api-key-here"
      }
    }
  }
}
```

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"
      }
    }
  }
}
```

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"

| Tool | Description |
|---|---|
`list_accounts` |
List connected social media accounts (each with `connectionStatus` — `CONNECTED` /`DISABLED` — and `disabledReason` ) |
`list_posts` |
List posts with filters (specific IDs, platform, status, date range) |
`create_posts` |
Create and schedule posts (batch, up to 15) |
`delete_post` |
Delete a post by ID |
`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 |
`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) |

Facebook, Instagram, X (Twitter), TikTok, LinkedIn, YouTube, BlueSky, Threads, Pinterest, Telegram, Google Business Profile

When creating posts, you can pass platform-specific settings via the `controls`

parameter:

| Platform | Controls |
|---|---|
X (Twitter) |
`xRetweetUrl` |
Instagram |
`instagramPublishType` (TIMELINE/STORY/REEL), `instagramPostToGrid` , `instagramCollaborators` , `instagramLocationId` /`instagramLocationName` (geotag from `search_places` ) |
Facebook |
`facebookContentType` (POST/REEL/STORY), `facebookAllowComments` , `facebookPrivacy` , `facebookReelsCollaborators` , `facebookTargetCountries` (ISO alpha-2, max 25), `facebookPlaceId` /`facebookPlaceName` (geotag from `search_places` ) |
TikTok |
`tiktokPrivacy` (PUBLIC/MUTUAL_FRIENDS/FOLLOWER_OF_CREATOR/ONLY_ME), `tiktokIsDraft` , `tiktokAllowComments` , `tiktokAllowDuet` , `tiktokAllowStitch` , `tiktokBrandOrganic` , `tiktokBrandContent` , `tiktokAutoAddMusic` , `tiktokIsAigc` |
YouTube |
`youtubeTitle` , `youtubePrivacy` (PUBLIC/PRIVATE/UNLISTED), `youtubeTags` , `youtubeCategoryId` , `youtubeIsShort` , `youtubeMadeForKids` , `youtubePlaylistId` , `youtubeThumbnailKey` |
Pinterest |
`pinterestBoardId` (required), `pinterestLink` |
LinkedIn |
`linkedinAttachmentKey` , `linkedinAttachmentTitle` |
Google Business Profile |
`gbpLocationId` (required), `gbpTopicType` (STANDARD/EVENT/OFFER), `gbpCallToActionType` , `gbpCallToActionUrl` , `gbpEventTitle` , `gbpEventStartDate` , `gbpEventEndDate` , `gbpOfferCouponCode` , `gbpOfferRedeemUrl` , `gbpOfferTerms` |

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

You can also use `get_upload_urls`

directly if you need more control over the upload process.

| Variable | Required | Description |
|---|---|---|
`POSTFAST_API_KEY` |
Yes | Your workspace API key |
`POSTFAST_API_URL` |
No | API base URL (default: `https://api.postfa.st` ) |

Verify everything works with the MCP Inspector:

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

Full REST API documentation: [postfa.st/docs](https://postfa.st/docs)

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

MIT