postfast-mcp 0.1.0 → 0.1.2

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.2",
+  "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

@@ -1,16 +1,62 @@
 # PostFast MCP Server
 
-MCP server for the [PostFast](https://postfa.st) API — schedule and manage social media posts via AI tools like Claude.
+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.
 
-## Setup
+## Quick Start
 
 ### 1. Get your API key
 
-Go to **PostFast → Workspace Settings → API Key** and generate a key.
+Log in to [PostFast](https://app.postfa.st/dashboard), go to **API** in the sidebar, and generate a key.
 
-### 2. Configure in Claude Code
+### 2. Install
 
-Add to your `.mcp.json` (project) or `~/.claude.json` (global):
+Choose your preferred method:
+
+#### Claude Desktop (recommended)
+
+Download the extension from the [Claude Desktop extension directory](https://claude.ai/extensions) or install manually:
+
+1. Add to `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "postfast": {
+      "command": "npx",
+      "args": ["-y", "postfast-mcp"],
+      "env": {
+        "POSTFAST_API_KEY": "your-api-key-here"
+      }
+    }
+  }
+}
+```
+
+2. Restart Claude Desktop.
+
+#### Claude Code
+
+**Via plugin (pending marketplace approval):**
+
+```shell
+/plugin install postfast@claude-plugins-official
+```
+
+After installing, set your API key — pick one of these:
+
+```bash
+# 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):
 
 ```json
 {
@@ -18,7 +64,26 @@ 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"
+      }
+    }
+  }
+}
+```
+
+#### Cursor / VS Code / Windsurf / Other MCP clients
+
+Add to your MCP config (`.mcp.json`, `mcp.json`, or the tool's settings UI):
+
+```json
+{
+  "mcpServers": {
+    "postfast": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "postfast-mcp"],
       "env": {
         "POSTFAST_API_KEY": "your-api-key-here"
       }
@@ -29,31 +94,46 @@ Add to your `.mcp.json` (project) or `~/.claude.json` (global):
 
 ### 3. Use it
 
-Ask Claude things like:
+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"
 
 ## 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:
@@ -74,6 +154,14 @@ You can also use `get_upload_urls` directly if you need more control over the up
 | `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:
+
+```bash
+POSTFAST_API_KEY=your-key npx @modelcontextprotocol/inspector npx postfast-mcp
+```
+
 ## API Docs
 
 Full REST API documentation: [postfa.st/docs](https://postfa.st/docs)

package/dist/index.js

@@ -7,7 +7,7 @@ import { registerAccountTools } from './tools/accounts.js';
 import { registerFileTools } from './tools/files.js';
 const server = new McpServer({
     name: 'postfast',
-    version: '0.1.0',
+    version: '0.1.1',
 });
 const client = new PostFastClient();
 registerPostTools(server, client);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "postfast-mcp",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "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": {