{
  "markdown": "# PostFast MCP Server\n\nMCP server for the [PostFast](https://postfa.st) API — schedule and manage social media posts via AI tools like Claude, Cursor, VS Code, and more.\n\n## Hosted connector (no install)\n\nPrefer not to run anything locally? Connect to the hosted endpoint and authenticate with OAuth — no npx, no API key to manage:\n\n```\nhttps://mcp.postfa.st/mcp\n```\n\nAdd 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.\n\nWant to run the server yourself instead? Use the npx + API-key setup in **Quick Start** below.\n\n## Quick Start\n\n### 1. Get your API key\n\nLog in to [PostFast](https://app.postfa.st/dashboard), go to **API** in the sidebar, and generate a key.\n\n### 2. Install\n\nChoose your preferred method:\n\n#### Claude Desktop (recommended)\n\nDownload the extension from the [Claude Desktop extension directory](https://claude.ai/extensions) or install manually:\n\n1. Add to `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"postfast\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"postfast-mcp\"],\n      \"env\": {\n        \"POSTFAST_API_KEY\": \"your-api-key-here\"\n      }\n    }\n  }\n}\n```\n\n2. Restart Claude Desktop.\n\n#### Claude Code\n\n**Via plugin (pending marketplace approval):**\n\n```shell\n/plugin install postfast@claude-plugins-official\n```\n\nAfter installing, set your API key — pick one of these:\n\n```bash\n# Option A: Add to your shell profile (~/.zshrc or ~/.bashrc)\nexport POSTFAST_API_KEY=\"your-api-key-here\"\n\n# Option B: Add to ~/.claude/settings.local.json\n# { \"env\": { \"POSTFAST_API_KEY\": \"your-api-key-here\" } }\n```\n\nThen restart Claude Code.\n\n**Via manual config:**\n\nAdd to your project's `.mcp.json` or `~/.claude/.mcp.json` (global):\n\n```json\n{\n  \"mcpServers\": {\n    \"postfast\": {\n      \"type\": \"stdio\",\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"postfast-mcp\"],\n      \"env\": {\n        \"POSTFAST_API_KEY\": \"your-api-key-here\"\n      }\n    }\n  }\n}\n```\n\n#### Cursor / VS Code / Windsurf / Other MCP clients\n\nAdd to your MCP config (`.mcp.json`, `mcp.json`, or the tool's settings UI):\n\n```json\n{\n  \"mcpServers\": {\n    \"postfast\": {\n      \"type\": \"stdio\",\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"postfast-mcp\"],\n      \"env\": {\n        \"POSTFAST_API_KEY\": \"your-api-key-here\"\n      }\n    }\n  }\n}\n```\n\n### 3. Use it\n\nAsk your AI assistant things like:\n\n- \"List my connected social accounts\"\n- \"Schedule a post to Instagram for tomorrow at 9am\"\n- \"Show me all scheduled posts for this week\"\n- \"Upload this image and create a LinkedIn post with it\"\n- \"Create a Facebook reel with this video\"\n- \"Show me analytics for my Instagram posts this month\"\n\n## Available Tools\n\n| Tool | Description |\n|------|-------------|\n| `list_accounts` | List connected social media accounts (each with `connectionStatus` — `CONNECTED`/`DISABLED` — `disabledReason`, `followerCount`/`followerCountUpdatedAt`, and `inboxCapable`) |\n| `list_posts` | List posts with filters (specific IDs, platform, status, date range) |\n| `create_posts` | Create and schedule posts (batch, up to 15) |\n| `delete_post` | Delete a post from PostFast by ID (does not remove an already-published post from the platform) |\n| `upload_media` | Upload a local file and get a media key (handles the full flow) |\n| `get_upload_urls` | Get signed URLs to upload media files |\n| `list_pinterest_boards` | Get Pinterest boards for an account |\n| `list_youtube_playlists` | Get YouTube playlists for an account |\n| `list_gbp_locations` | Get Google Business Profile locations for an account |\n| `search_places` | Find a place to tag posts (the `id` works for both `facebookPlaceId` and `instagramLocationId`) |\n| `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`) |\n| `get_post_analytics` | Fetch published posts with performance metrics — Instagram, Facebook, TikTok, Threads, YouTube, LinkedIn (company pages), Pinterest (Business accounts) |\n| `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), TikTok |\n| `list_tiktok_sounds` | Trending pre-cleared Commercial Music Library tracks for a TikTok account (attach via `controls.tiktokMusicSoundId`) |\n\n### Social Inbox (comments)\n\nComments 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.\n\n| Tool | Description |\n|------|-------------|\n| `list_inbox_conversations` | List comment conversations (filters: platforms, accounts, statuses, unread-only, assignee) |\n| `get_inbox_conversation` | Fetch one conversation with its reply-capability fields |\n| `list_inbox_items` | List a conversation's comments and replies (with `state` and, on Instagram, `canPrivateReply`) |\n| `get_inbox_unread_count` | Total unread comment count across the workspace |\n| `reply_to_inbox_item` | Reply publicly under a specific comment |\n| `send_inbox_private_reply` | Instagram only: one private reply per comment, within 7 days |\n| `set_inbox_item_state` | HIDE / UNHIDE / DELETE a comment on the platform (DELETE cannot be undone) |\n| `mark_inbox_conversation_read` | Zero a conversation's unread count |\n| `set_inbox_conversation_status` | Triage: OPEN / SNOOZED / CLOSED |\n| `assign_inbox_conversation` | Assign a conversation to a workspace member (or unassign) |\n\n## Supported Platforms\n\nFacebook, Instagram, X (Twitter), TikTok, LinkedIn, YouTube, BlueSky, Threads, Pinterest, Telegram, Google Business Profile\n\n## Platform-Specific Controls\n\nWhen creating posts, you can pass platform-specific settings via the `controls` parameter:\n\n| Platform | Controls |\n|----------|----------|\n| **X (Twitter)** | `xRetweetUrl` |\n| **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) |\n| **Facebook** | `facebookContentType` (POST/REEL/STORY), `facebookAllowComments`, `facebookPrivacy`, `facebookCarouselMainLink`, `facebookCarouselShowEndCard`, `facebookReelsCollaborators`, `facebookTargetCountries` (ISO alpha-2, max 25), `facebookPlaceId`/`facebookPlaceName` (geotag from `search_places`) |\n| **TikTok** | `tiktokTitle` (photo posts, max 90 chars), `tiktokMusicSoundId`/`tiktokMusicSoundName` (Commercial Music Library sound from `list_tiktok_sounds`; photo/carousel posts, exclusive with `tiktokAutoAddMusic`), `tiktokIsDraft`, `tiktokAllowComments`, `tiktokAllowDuet`, `tiktokAllowStitch`, `tiktokBrandOrganic`, `tiktokBrandContent`, `tiktokAutoAddMusic`, `tiktokIsAigc`, `tiktokPrivacy` (deprecated — account default applies) |\n| **YouTube** | `youtubeTitle`, `youtubePrivacy` (PUBLIC/PRIVATE/UNLISTED), `youtubeTags`, `youtubeCategoryId`, `youtubeIsShort`, `youtubeMadeForKids`, `youtubeContainsSyntheticMedia` (altered/synthetic content disclosure; set at creation only), `youtubePlaylistId`, `youtubeThumbnailKey` |\n| **Pinterest** | `pinterestBoardId` (required), `pinterestLink` |\n| **LinkedIn** | `linkedinAttachmentKey`, `linkedinAttachmentTitle` |\n| **Google Business Profile** | `gbpLocationId` (required), `gbpTopicType` (STANDARD/EVENT/OFFER), `gbpCallToActionType`, `gbpCallToActionUrl`, `gbpEventTitle`, `gbpEventStartDate`, `gbpEventEndDate`, `gbpOfferCouponCode`, `gbpOfferRedeemUrl`, `gbpOfferTerms` |\n\n## Media Upload\n\nThe `upload_media` tool handles the full flow in a single call:\n\n1. Detects content type from file extension\n2. Gets a signed upload URL from PostFast\n3. Uploads the file\n4. Returns a `key` and `type` ready to use in `create_posts`\n\nSupported formats: JPEG, PNG, GIF, WebP, MP4, WebM, MOV\n\nYou can also use `get_upload_urls` directly if you need more control over the upload process.\n\n## Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `POSTFAST_API_KEY` | Yes | Your workspace API key |\n| `POSTFAST_API_URL` | No | API base URL (default: `https://api.postfa.st`) |\n\n## Testing\n\nVerify everything works with the MCP Inspector:\n\n```bash\nPOSTFAST_API_KEY=your-key npx @modelcontextprotocol/inspector npx postfast-mcp\n```\n\n## API Docs\n\nFull REST API documentation: [postfa.st/docs](https://postfa.st/docs)\n\n## Development\n\n```bash\nnpm install\nnpm run build\nnode dist/stdio/index.js\n```\n\nTools are authored once in `src/core` (the catalog — schemas, descriptions,\nannotations, per-binding availability) and exposed to consumers as\n`postfast-mcp/core`; `src/stdio` binds the catalog to the public REST API.\nReleases: PRs add a `.changeset/*.md`; `npm run version` folds them into the\nbump + changelog, and pushing the `vX.Y.Z` tag publishes npm + MCP Registry +\nthe MCPB release from CI (OIDC — no tokens anywhere).\n\n## Badges\n\n[![peturgeorgievv-factory/postfast-mcp MCP server](https://glama.ai/mcp/servers/peturgeorgievv-factory/postfast-mcp/badges/score.svg)](https://glama.ai/mcp/servers/peturgeorgievv-factory/postfast-mcp)\n\n## License\n\nMIT\n",
  "bytes": 9690,
  "sha": "ba00132136a46d87ac07abbfdfe9b1c5440681f6da4318982962186931753549",
  "repo_slug": "peturgeorgievv-factory/postfast-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_peturgeorgievv_factory_postfas_e2699915/readme"
}