postfast-mcp 0.1.0 → 0.1.1

package/.claude-plugin/marketplace.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
+  "name": "postfast-mcp",
+  "description": "PostFast social media scheduling and management tools for Claude Code",
+  "owner": {
+    "name": "PostFast",
+    "email": "me@peturgeorgievv.com"
+  },
+  "plugins": [
+    {
+      "name": "postfast",
+      "description": "Schedule and manage social media posts via PostFast. Supports Facebook, Instagram, X, TikTok, LinkedIn, YouTube, BlueSky, Threads, Pinterest, and Telegram.",
+      "category": "productivity",
+      "homepage": "https://postfa.st",
+      "source": {
+        "source": "npm",
+        "package": "postfast-mcp"
+      }
+    }
+  ]
+}

package/.claude-plugin/plugin.json

@@ -0,0 +1,22 @@
+{
+  "name": "postfast",
+  "description": "Schedule and manage social media posts via PostFast. Supports Facebook, Instagram, X, TikTok, LinkedIn, YouTube, BlueSky, Threads, Pinterest, and Telegram.",
+  "version": "0.1.0",
+  "author": {
+    "name": "PostFast",
+    "email": "me@peturgeorgievv.com"
+  },
+  "homepage": "https://postfa.st",
+  "repository": "https://github.com/peturgeorgievv-factory/postfast-mcp",
+  "license": "MIT",
+  "keywords": ["social-media", "scheduling", "mcp", "postfast"],
+  "mcpServers": {
+    "postfast": {
+      "command": "npx",
+      "args": ["-y", "postfast-mcp"],
+      "env": {
+        "POSTFAST_API_KEY": ""
+      }
+    }
+  }
+}

package/README.md

@@ -2,15 +2,30 @@
 
 MCP server for the [PostFast](https://postfa.st) API — schedule and manage social media posts via AI tools like Claude.
 
-## Setup
+## Quick Start
 
 ### 1. Get your API key
 
 Go to **PostFast → Workspace Settings → API Key** and generate a key.
 
-### 2. Configure in Claude Code
+### 2. Install
 
-Add to your `.mcp.json` (project) or `~/.claude.json` (global):
+**Option A — Claude Code Plugin (recommended):**
+
+```shell
+/plugin marketplace add peturgeorgievv-factory/postfast-mcp
+/plugin install postfast@postfast-mcp
+```
+
+Then set your API key as an environment variable:
+
+```bash
+export POSTFAST_API_KEY="your-api-key-here"
+```
+
+**Option B — Manual `.mcp.json` config:**
+
+Add to your project's `.mcp.json` or `~/.claude/.mcp.json` (global):
 
 ```json
 {
@@ -18,7 +33,7 @@ Add to your `.mcp.json` (project) or `~/.claude.json` (global):
     "postfast": {
       "type": "stdio",
       "command": "npx",
-      "args": ["postfast-mcp"],
+      "args": ["-y", "postfast-mcp"],
       "env": {
         "POSTFAST_API_KEY": "your-api-key-here"
       }
@@ -35,25 +50,40 @@ Ask Claude things like:
 - "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"
 
 ## 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 |
-| `list_accounts` | List connected social media accounts |
+| `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 |
 | `generate_connect_link` | Generate a link for clients to connect accounts |
-| `get_upload_urls` | Get signed URLs to upload media files |
-| `upload_media` | Upload a local file and get a media key (handles the full flow) |
 
 ## Supported Platforms
 
 Facebook, Instagram, X (Twitter), TikTok, LinkedIn, YouTube, BlueSky, Threads, Pinterest, Telegram
 
+## Platform-Specific Controls
+
+When creating posts, you can pass platform-specific settings via the `controls` parameter:
+
+| Platform | Controls |
+|----------|----------|
+| **X (Twitter)** | `xCommunityId`, `xQuoteTweetUrl`, `xRetweetUrl` |
+| **Instagram** | `instagramPublishType` (TIMELINE/STORY/REEL), `instagramPostToGrid`, `instagramCollaborators` |
+| **Facebook** | `facebookContentType` (POST/REEL/STORY), `facebookAllowComments`, `facebookPrivacy`, `facebookReelsCollaborators` |
+| **TikTok** | `tiktokPrivacy` (PUBLIC/MUTUAL_FRIENDS/ONLY_ME), `tiktokIsDraft`, `tiktokAllowComments`, `tiktokAllowDuet`, `tiktokAllowStitch`, `tiktokBrandOrganic`, `tiktokBrandContent`, `tiktokAutoAddMusic` |
+| **YouTube** | `youtubeTitle`, `youtubePrivacy` (PUBLIC/PRIVATE/UNLISTED), `youtubeTags`, `youtubeCategoryId`, `youtubeIsShort`, `youtubeMadeForKids`, `youtubePlaylistId` |
+| **Pinterest** | `pinterestBoardId` (required), `pinterestLink` |
+| **LinkedIn** | `linkedinAttachmentKey`, `linkedinAttachmentTitle` |
+
 ## Media Upload
 
 The `upload_media` tool handles the full flow in a single call:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "postfast-mcp",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "MCP server for the PostFast API — schedule and manage social media posts via AI tools",
   "type": "module",
   "bin": {
@@ -9,6 +9,7 @@
   "main": "./dist/index.js",
   "files": [
     "dist",
+    ".claude-plugin",
     "README.md"
   ],
   "scripts": {