Skip to main content
Glama
deenesjakoruzh
peturgeorgievv-factory

postfast-mcp

by peturgeorgievv-factory
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Local

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.

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:

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

  1. Restart Claude Desktop.

Claude Code

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

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

list_posts

List posts with filters (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

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)

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), instagramPostToGrid, instagramCollaborators

Facebook

facebookContentType (POST/REEL/STORY), facebookAllowComments, facebookPrivacy, facebookReelsCollaborators

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

Media Upload

The upload_media tool handles the full flow in a single call:

  1. Detects content type from file extension

  2. Gets a signed upload URL from PostFast

  3. Uploads the file

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

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/index.js

Badges

peturgeorgievv-factory/postfast-mcp MCP server

License

MIT

Install Server
A
license - permissive license
A
quality
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
1Releases (12mo)

Resources

Tools

View all tools

Appeared in Searches

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/peturgeorgievv-factory/postfast-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server