postfast-mcp 0.1.0

package/README.md

@@ -0,0 +1,91 @@
+# PostFast MCP Server
+
+MCP server for the [PostFast](https://postfa.st) API — schedule and manage social media posts via AI tools like Claude.
+
+## Setup
+
+### 1. Get your API key
+
+Go to **PostFast → Workspace Settings → API Key** and generate a key.
+
+### 2. Configure in Claude Code
+
+Add to your `.mcp.json` (project) or `~/.claude.json` (global):
+
+```json
+{
+  "mcpServers": {
+    "postfast": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["postfast-mcp"],
+      "env": {
+        "POSTFAST_API_KEY": "your-api-key-here"
+      }
+    }
+  }
+}
+```
+
+### 3. Use it
+
+Ask Claude 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"
+
+## Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `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 |
+| `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
+
+## 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`) |
+
+## API Docs
+
+Full REST API documentation: [postfa.st/docs](https://postfa.st/docs)
+
+## Development
+
+```bash
+npm install
+npm run build
+node dist/index.js
+```
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,9 @@
+export declare class PostFastClient {
+    private baseUrl;
+    private apiKey;
+    constructor();
+    request<T>(method: string, path: string, body?: unknown, query?: Record<string, string | undefined>): Promise<T>;
+    get<T>(path: string, query?: Record<string, string | undefined>): Promise<T>;
+    post<T>(path: string, body?: unknown): Promise<T>;
+    delete<T>(path: string): Promise<T>;
+}

package/dist/client.js

@@ -0,0 +1,57 @@
+const DEFAULT_BASE_URL = 'https://api.postfa.st';
+export class PostFastClient {
+    baseUrl;
+    apiKey;
+    constructor() {
+        this.apiKey = process.env.POSTFAST_API_KEY ?? '';
+        this.baseUrl = (process.env.POSTFAST_API_URL ?? DEFAULT_BASE_URL).replace(/\/$/, '');
+        if (!this.apiKey) {
+            throw new Error('POSTFAST_API_KEY environment variable is required. Generate one in PostFast → Workspace Settings → API Key.');
+        }
+    }
+    async request(method, path, body, query) {
+        const url = new URL(`${this.baseUrl}${path}`);
+        if (query) {
+            for (const [key, value] of Object.entries(query)) {
+                if (value !== undefined && value !== '') {
+                    url.searchParams.set(key, value);
+                }
+            }
+        }
+        const headers = {
+            'pf-api-key': this.apiKey,
+            'Content-Type': 'application/json',
+        };
+        const response = await fetch(url.toString(), {
+            method,
+            headers,
+            body: body ? JSON.stringify(body) : undefined,
+        });
+        if (!response.ok) {
+            const text = await response.text();
+            let message;
+            try {
+                const json = JSON.parse(text);
+                message = json.message ?? json.error ?? text;
+            }
+            catch {
+                message = text;
+            }
+            throw new Error(`PostFast API error (${response.status}): ${message}`);
+        }
+        const text = await response.text();
+        if (!text)
+            return undefined;
+        return JSON.parse(text);
+    }
+    get(path, query) {
+        return this.request('GET', path, undefined, query);
+    }
+    post(path, body) {
+        return this.request('POST', path, body);
+    }
+    delete(path) {
+        return this.request('DELETE', path);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,MAAM,gBAAgB,GAAG,uBAAuB,CAAC;AAEjD,MAAM,OAAO,cAAc;IACjB,OAAO,CAAS;IAChB,MAAM,CAAS;IAEvB;QACE,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,EAAE,CAAC;QACjD,IAAI,CAAC,OAAO,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,gBAAgB,CAAC,CAAC,OAAO,CACvE,KAAK,EACL,EAAE,CACH,CAAC;QAEF,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CACb,6GAA6G,CAC9G,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAO,CACX,MAAc,EACd,IAAY,EACZ,IAAc,EACd,KAA0C;QAE1C,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,CAAC,CAAC;QAE9C,IAAI,KAAK,EAAE,CAAC;YACV,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACjD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;oBACxC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;gBACnC,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,OAAO,GAA2B;YACtC,YAAY,EAAE,IAAI,CAAC,MAAM;YACzB,cAAc,EAAE,kBAAkB;SACnC,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE;YAC3C,MAAM;YACN,OAAO;YACP,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;SAC9C,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnC,IAAI,OAAe,CAAC;YAEpB,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC9B,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC;YAC/C,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,GAAG,IAAI,CAAC;YACjB,CAAC;YAED,MAAM,IAAI,KAAK,CAAC,uBAAuB,QAAQ,CAAC,MAAM,MAAM,OAAO,EAAE,CAAC,CAAC;QACzE,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnC,IAAI,CAAC,IAAI;YAAE,OAAO,SAAc,CAAC;QAEjC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAM,CAAC;IAC/B,CAAC;IAED,GAAG,CAAI,IAAY,EAAE,KAA0C;QAC7D,OAAO,IAAI,CAAC,OAAO,CAAI,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;IACxD,CAAC;IAED,IAAI,CAAI,IAAY,EAAE,IAAc;QAClC,OAAO,IAAI,CAAC,OAAO,CAAI,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,CAAI,IAAY;QACpB,OAAO,IAAI,CAAC,OAAO,CAAI,QAAQ,EAAE,IAAI,CAAC,CAAC;IACzC,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { PostFastClient } from './client.js';
+import { registerPostTools } from './tools/posts.js';
+import { registerAccountTools } from './tools/accounts.js';
+import { registerFileTools } from './tools/files.js';
+const server = new McpServer({
+    name: 'postfast',
+    version: '0.1.0',
+});
+const client = new PostFastClient();
+registerPostTools(server, client);
+registerAccountTools(server, client);
+registerFileTools(server, client);
+const transport = new StdioServerTransport();
+await server.connect(transport);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,UAAU;IAChB,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,MAAM,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;AAEpC,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAClC,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACrC,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAElC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC"}

package/dist/tools/accounts.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { PostFastClient } from '../client.js';
+export declare function registerAccountTools(server: McpServer, client: PostFastClient): void;

package/dist/tools/accounts.js

@@ -0,0 +1,59 @@
+import { z } from 'zod';
+export function registerAccountTools(server, client) {
+    server.tool('list_accounts', 'List all social media accounts connected to the workspace', {}, async () => {
+        const data = await client.get('/social-media/my-social-accounts');
+        return {
+            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
+        };
+    });
+    server.tool('list_pinterest_boards', 'List Pinterest boards for a connected Pinterest account', {
+        socialMediaId: z
+            .string()
+            .uuid()
+            .describe('Pinterest account ID (from list_accounts)'),
+    }, async (input) => {
+        const data = await client.get(`/social-media/${input.socialMediaId}/pinterest-boards`);
+        return {
+            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
+        };
+    });
+    server.tool('list_youtube_playlists', 'List YouTube playlists for a connected YouTube account', {
+        socialMediaId: z
+            .string()
+            .uuid()
+            .describe('YouTube account ID (from list_accounts)'),
+    }, async (input) => {
+        const data = await client.get(`/social-media/${input.socialMediaId}/youtube-playlists`);
+        return {
+            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
+        };
+    });
+    server.tool('generate_connect_link', 'Generate a shareable link for external clients to connect their social accounts to the workspace', {
+        expiryDays: z
+            .number()
+            .int()
+            .min(1)
+            .max(30)
+            .default(7)
+            .describe('Link expiry in days (1-30, default 7)'),
+        sendEmail: z
+            .boolean()
+            .default(false)
+            .describe('Send the link via email'),
+        email: z
+            .string()
+            .email()
+            .optional()
+            .describe('Recipient email (required if sendEmail is true)'),
+    }, async (input) => {
+        const data = await client.post('/social-media/connect-link', {
+            expiryDays: input.expiryDays,
+            sendEmail: input.sendEmail,
+            email: input.email,
+        });
+        return {
+            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
+        };
+    });
+}
+//# sourceMappingURL=accounts.js.map

package/dist/tools/accounts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accounts.js","sourceRoot":"","sources":["../../src/tools/accounts.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,MAAM,UAAU,oBAAoB,CAClC,MAAiB,EACjB,MAAsB;IAEtB,MAAM,CAAC,IAAI,CACT,eAAe,EACf,2DAA2D,EAC3D,EAAE,EACF,KAAK,IAAI,EAAE;QACT,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAC3B,kCAAkC,CACnC,CAAC;QAEF,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SAC1E,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,uBAAuB,EACvB,yDAAyD,EACzD;QACE,aAAa,EAAE,CAAC;aACb,MAAM,EAAE;aACR,IAAI,EAAE;aACN,QAAQ,CAAC,2CAA2C,CAAC;KACzD,EACD,KAAK,EAAE,KAAK,EAAE,EAAE;QACd,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAC3B,iBAAiB,KAAK,CAAC,aAAa,mBAAmB,CACxD,CAAC;QAEF,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SAC1E,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,wBAAwB,EACxB,wDAAwD,EACxD;QACE,aAAa,EAAE,CAAC;aACb,MAAM,EAAE;aACR,IAAI,EAAE;aACN,QAAQ,CAAC,yCAAyC,CAAC;KACvD,EACD,KAAK,EAAE,KAAK,EAAE,EAAE;QACd,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAC3B,iBAAiB,KAAK,CAAC,aAAa,oBAAoB,CACzD,CAAC;QAEF,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SAC1E,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,uBAAuB,EACvB,kGAAkG,EAClG;QACE,UAAU,EAAE,CAAC;aACV,MAAM,EAAE;aACR,GAAG,EAAE;aACL,GAAG,CAAC,CAAC,CAAC;aACN,GAAG,CAAC,EAAE,CAAC;aACP,OAAO,CAAC,CAAC,CAAC;aACV,QAAQ,CAAC,uCAAuC,CAAC;QACpD,SAAS,EAAE,CAAC;aACT,OAAO,EAAE;aACT,OAAO,CAAC,KAAK,CAAC;aACd,QAAQ,CAAC,yBAAyB,CAAC;QACtC,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,KAAK,EAAE;aACP,QAAQ,EAAE;aACV,QAAQ,CAAC,iDAAiD,CAAC;KAC/D,EACD,KAAK,EAAE,KAAK,EAAE,EAAE;QACd,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAC5B,4BAA4B,EAC5B;YACE,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,KAAK,EAAE,KAAK,CAAC,KAAK;SACnB,CACF,CAAC;QAEF,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SAC1E,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/files.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { PostFastClient } from '../client.js';
+export declare function registerFileTools(server: McpServer, client: PostFastClient): void;

package/dist/tools/files.js

@@ -0,0 +1,81 @@
+import { readFile } from 'node:fs/promises';
+import { extname } from 'node:path';
+import { z } from 'zod';
+const MIME_MAP = {
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.png': 'image/png',
+    '.gif': 'image/gif',
+    '.webp': 'image/webp',
+    '.mp4': 'video/mp4',
+    '.webm': 'video/webm',
+    '.mov': 'video/quicktime',
+};
+const IMAGE_TYPES = [
+    'image/jpeg',
+    'image/png',
+    'image/gif',
+    'image/webp',
+];
+const VIDEO_TYPES = ['video/mp4', 'video/webm', 'video/quicktime'];
+function detectContentType(filePath) {
+    const ext = extname(filePath).toLowerCase();
+    const mime = MIME_MAP[ext];
+    if (!mime) {
+        throw new Error(`Unsupported file extension "${ext}". Supported: ${Object.keys(MIME_MAP).join(', ')}`);
+    }
+    return mime;
+}
+export function registerFileTools(server, client) {
+    server.tool('get_upload_urls', 'Get signed upload URLs for media files. Upload your file to the returned URL via PUT, then use the key in create_posts mediaItems.', {
+        contentType: z
+            .string()
+            .describe(`MIME type of the file. Supported: ${[...IMAGE_TYPES, ...VIDEO_TYPES].join(', ')}`),
+        count: z
+            .number()
+            .int()
+            .min(1)
+            .max(8)
+            .default(1)
+            .describe('Number of upload URLs (1-8 for images, 1 for videos)'),
+    }, async (input) => {
+        const data = await client.post('/file/get-signed-upload-urls', {
+            contentType: input.contentType,
+            count: input.count,
+        });
+        return {
+            content: [
+                { type: 'text', text: JSON.stringify(data, null, 2) },
+            ],
+        };
+    });
+    server.tool('upload_media', 'Upload a local file to PostFast and get back a media key for use in create_posts. Handles the full flow: detects content type, gets a signed URL, uploads the file, and returns the key and type.', {
+        filePath: z
+            .string()
+            .describe('Absolute path to the local file (e.g. /Users/me/photo.jpg)'),
+    }, async (input) => {
+        const contentType = detectContentType(input.filePath);
+        const isVideo = contentType.startsWith('video/');
+        const [uploadUrl] = await client.post('/file/get-signed-upload-urls', { contentType, count: 1 });
+        const fileBuffer = await readFile(input.filePath);
+        const uploadResponse = await fetch(uploadUrl.signedUrl, {
+            method: 'PUT',
+            headers: { 'Content-Type': contentType },
+            body: fileBuffer,
+        });
+        if (!uploadResponse.ok) {
+            throw new Error(`Upload failed (${uploadResponse.status}): ${await uploadResponse.text()}`);
+        }
+        const result = {
+            key: uploadUrl.key,
+            type: isVideo ? 'VIDEO' : 'IMAGE',
+            contentType,
+        };
+        return {
+            content: [
+                { type: 'text', text: JSON.stringify(result, null, 2) },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=files.js.map

package/dist/tools/files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../../src/tools/files.ts"],"names":[],"mappings":"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"}

package/dist/tools/posts.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { PostFastClient } from '../client.js';
+export declare function registerPostTools(server: McpServer, client: PostFastClient): void;

package/dist/tools/posts.js

@@ -0,0 +1,154 @@
+import { z } from 'zod';
+const PLATFORMS = [
+    'FACEBOOK',
+    'INSTAGRAM',
+    'X',
+    'TIKTOK',
+    'LINKEDIN',
+    'YOUTUBE',
+    'BLUESKY',
+    'THREADS',
+    'PINTEREST',
+    'TELEGRAM',
+];
+const STATUSES = ['DRAFT', 'SCHEDULED', 'PUBLISHED', 'FAILED'];
+export function registerPostTools(server, client) {
+    server.tool('list_posts', 'List social media posts with optional filters for platform, status, and date range', {
+        page: z.number().int().min(0).default(0).describe('Page number (0-based)'),
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .max(50)
+            .default(20)
+            .describe('Posts per page (max 50)'),
+        platforms: z
+            .array(z.enum(PLATFORMS))
+            .optional()
+            .describe('Filter by platforms'),
+        statuses: z
+            .array(z.enum(STATUSES))
+            .optional()
+            .describe('Filter by post statuses'),
+        from: z
+            .string()
+            .optional()
+            .describe('Start date filter (ISO 8601, e.g. 2025-01-01T00:00:00.000Z)'),
+        to: z
+            .string()
+            .optional()
+            .describe('End date filter (ISO 8601, e.g. 2025-01-31T23:59:59.999Z)'),
+    }, async (input) => {
+        const data = await client.get('/social-posts', {
+            page: String(input.page),
+            limit: String(input.limit),
+            platforms: input.platforms?.join(','),
+            statuses: input.statuses?.join(','),
+            from: input.from,
+            to: input.to,
+        });
+        return {
+            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
+        };
+    });
+    server.tool('create_posts', 'Create and schedule social media posts. Supports batch creation (up to 15 posts). Each post targets a specific social account.', {
+        posts: z
+            .array(z.object({
+            content: z.string().describe('Post text content'),
+            firstComment: z.string().optional().describe('First comment to add after publishing'),
+            mediaItems: z
+                .array(z.object({
+                key: z.string().describe('S3 media key from get_upload_urls'),
+                type: z.enum(['IMAGE', 'VIDEO']),
+                sortOrder: z.number().int().min(0),
+                coverTimestamp: z.string().optional().describe('Video cover timestamp'),
+            }))
+                .optional()
+                .describe('Media attachments'),
+            scheduledAt: z
+                .string()
+                .optional()
+                .describe('Schedule time (ISO 8601). Required when status is SCHEDULED.'),
+            socialMediaId: z
+                .string()
+                .uuid()
+                .describe('Target social account ID (from list_accounts)'),
+        }))
+            .min(1)
+            .max(15)
+            .describe('Array of posts to create'),
+        status: z
+            .enum(['DRAFT', 'SCHEDULED'])
+            .default('SCHEDULED')
+            .describe('Post status. SCHEDULED requires scheduledAt on all posts.'),
+        approvalStatus: z
+            .enum(['PENDING_APPROVAL', 'APPROVED'])
+            .default('APPROVED')
+            .describe('Approval workflow status'),
+        controls: z
+            .object({
+            // X/Twitter
+            xCommunityId: z.string().optional(),
+            xQuoteTweetUrl: z.string().optional(),
+            xRetweetUrl: z.string().optional(),
+            // TikTok
+            tiktokPrivacy: z.enum(['PUBLIC', 'MUTUAL_FRIENDS', 'ONLY_ME']).optional(),
+            tiktokIsDraft: z.boolean().optional(),
+            tiktokAllowComments: z.boolean().optional(),
+            tiktokAllowDuet: z.boolean().optional(),
+            tiktokAllowStitch: z.boolean().optional(),
+            tiktokBrandOrganic: z.boolean().optional(),
+            tiktokBrandContent: z.boolean().optional(),
+            tiktokAutoAddMusic: z.boolean().optional(),
+            // Instagram
+            instagramPostToGrid: z.boolean().optional(),
+            instagramPublishType: z.enum(['TIMELINE', 'STORY', 'REEL']).optional(),
+            instagramCollaborators: z.array(z.string()).optional(),
+            // YouTube
+            youtubePrivacy: z.enum(['PUBLIC', 'PRIVATE', 'UNLISTED']).optional(),
+            youtubeTags: z.array(z.string()).optional(),
+            youtubeCategoryId: z.string().optional(),
+            youtubeIsShort: z.boolean().optional(),
+            youtubeMadeForKids: z.boolean().optional(),
+            youtubeTitle: z.string().optional(),
+            youtubePlaylistId: z.string().optional(),
+            // Facebook
+            facebookContentType: z.enum(['POST', 'REEL', 'STORY']).optional(),
+            facebookAllowComments: z.boolean().optional(),
+            facebookPrivacy: z
+                .enum(['PUBLIC', 'FRIENDS_OF_FRIENDS', 'FRIENDS', 'SELF'])
+                .optional(),
+            facebookCarouselMainLink: z.string().optional(),
+            facebookCarouselShowEndCard: z.boolean().optional(),
+            facebookReelsCoverImageKey: z.string().optional(),
+            facebookReelsCollaborators: z.array(z.string()).optional(),
+            // Pinterest
+            pinterestBoardId: z.string().optional(),
+            pinterestLink: z.string().optional(),
+            // LinkedIn
+            linkedinAttachmentKey: z.string().optional(),
+            linkedinAttachmentTitle: z.string().optional(),
+        })
+            .optional()
+            .describe('Platform-specific controls (shared across all posts in the batch)'),
+    }, async (input) => {
+        const data = await client.post('/social-posts', {
+            posts: input.posts,
+            status: input.status,
+            approvalStatus: input.approvalStatus,
+            controls: input.controls,
+        });
+        return {
+            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
+        };
+    });
+    server.tool('delete_post', 'Delete a social media post by ID', {
+        id: z.string().uuid().describe('Post ID to delete'),
+    }, async (input) => {
+        const data = await client.delete(`/social-posts/${input.id}`);
+        return {
+            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
+        };
+    });
+}
+//# sourceMappingURL=posts.js.map

package/dist/tools/posts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"posts.js","sourceRoot":"","sources":["../../src/tools/posts.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,SAAS,GAAG;IAChB,UAAU;IACV,WAAW;IACX,GAAG;IACH,QAAQ;IACR,UAAU;IACV,SAAS;IACT,SAAS;IACT,SAAS;IACT,WAAW;IACX,UAAU;CACF,CAAC;AAEX,MAAM,QAAQ,GAAG,CAAC,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,CAAU,CAAC;AAExE,MAAM,UAAU,iBAAiB,CAAC,MAAiB,EAAE,MAAsB;IACzE,MAAM,CAAC,IAAI,CACT,YAAY,EACZ,oFAAoF,EACpF;QACE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,uBAAuB,CAAC;QAC1E,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,GAAG,EAAE;aACL,GAAG,CAAC,CAAC,CAAC;aACN,GAAG,CAAC,EAAE,CAAC;aACP,OAAO,CAAC,EAAE,CAAC;aACX,QAAQ,CAAC,yBAAyB,CAAC;QACtC,SAAS,EAAE,CAAC;aACT,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;aACxB,QAAQ,EAAE;aACV,QAAQ,CAAC,qBAAqB,CAAC;QAClC,QAAQ,EAAE,CAAC;aACR,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;aACvB,QAAQ,EAAE;aACV,QAAQ,CAAC,yBAAyB,CAAC;QACtC,IAAI,EAAE,CAAC;aACJ,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,6DAA6D,CAAC;QAC1E,EAAE,EAAE,CAAC;aACF,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,2DAA2D,CAAC;KACzE,EACD,KAAK,EAAE,KAAK,EAAE,EAAE;QACd,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAAiB,eAAe,EAAE;YAC7D,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;YACxB,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC;YAC1B,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC;YACrC,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC;YACnC,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,EAAE,EAAE,KAAK,CAAC,EAAE;SACb,CAAC,CAAC;QAEH,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SAC1E,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,cAAc,EACd,gIAAgI,EAChI;QACE,KAAK,EAAE,CAAC;aACL,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;YACjD,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;YACrF,UAAU,EAAE,CAAC;iBACV,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;gBACP,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;gBAC7D,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBAChC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;gBAClC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;aACxE,CAAC,CACH;iBACA,QAAQ,EAAE;iBACV,QAAQ,CAAC,mBAAmB,CAAC;YAChC,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACP,8DAA8D,CAC/D;YACH,aAAa,EAAE,CAAC;iBACb,MAAM,EAAE;iBACR,IAAI,EAAE;iBACN,QAAQ,CAAC,+CAA+C,CAAC;SAC7D,CAAC,CACH;aACA,GAAG,CAAC,CAAC,CAAC;aACN,GAAG,CAAC,EAAE,CAAC;aACP,QAAQ,CAAC,0BAA0B,CAAC;QACvC,MAAM,EAAE,CAAC;aACN,IAAI,CAAC,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;aAC5B,OAAO,CAAC,WAAW,CAAC;aACpB,QAAQ,CAAC,2DAA2D,CAAC;QACxE,cAAc,EAAE,CAAC;aACd,IAAI,CAAC,CAAC,kBAAkB,EAAE,UAAU,CAAC,CAAC;aACtC,OAAO,CAAC,UAAU,CAAC;aACnB,QAAQ,CAAC,0BAA0B,CAAC;QACvC,QAAQ,EAAE,CAAC;aACR,MAAM,CAAC;YACN,YAAY;YACZ,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YACnC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YACrC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAClC,SAAS;YACT,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,gBAAgB,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE;YACzE,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;YACrC,mBAAmB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;YAC3C,eAAe,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;YACvC,iBAAiB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;YACzC,kBAAkB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;YAC1C,kBAAkB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;YAC1C,kBAAkB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;YAC1C,YAAY;YACZ,mBAAmB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;YAC3C,oBAAoB,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE;YACtE,sBAAsB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;YACtD,UAAU;YACV,cAAc,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,QAAQ,EAAE;YACpE,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;YAC3C,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YACxC,cAAc,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;YACtC,kBAAkB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;YAC1C,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YACnC,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YACxC,WAAW;YACX,mBAAmB,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE;YACjE,qBAAqB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;YAC7C,eAAe,EAAE,CAAC;iBACf,IAAI,CAAC,CAAC,QAAQ,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;iBACzD,QAAQ,EAAE;YACb,wBAAwB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC/C,2BAA2B,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;YACnD,0BAA0B,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YACjD,0BAA0B,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;YAC1D,YAAY;YACZ,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YACvC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YACpC,WAAW;YACX,qBAAqB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC5C,uBAAuB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC/C,CAAC;aACD,QAAQ,EAAE;aACV,QAAQ,CAAC,mEAAmE,CAAC;KACjF,EACD,KAAK,EAAE,KAAK,EAAE,EAAE;QACd,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAAwB,eAAe,EAAE;YACrE,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,cAAc,EAAE,KAAK,CAAC,cAAc;YACpC,QAAQ,EAAE,KAAK,CAAC,QAAQ;SACzB,CAAC,CAAC;QAEH,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SAC1E,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,aAAa,EACb,kCAAkC,EAClC;QACE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;KACpD,EACD,KAAK,EAAE,KAAK,EAAE,EAAE;QACd,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,MAAM,CAC9B,iBAAiB,KAAK,CAAC,EAAE,EAAE,CAC5B,CAAC;QAEF,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SAC1E,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,103 @@
+export type Platform = 'FACEBOOK' | 'INSTAGRAM' | 'X' | 'TIKTOK' | 'LINKEDIN' | 'YOUTUBE' | 'BLUESKY' | 'THREADS' | 'PINTEREST' | 'TELEGRAM';
+export type PostStatus = 'DRAFT' | 'SCHEDULED' | 'PUBLISHED' | 'FAILED';
+export type ApprovalStatus = 'PENDING_APPROVAL' | 'IN_PROGRESS' | 'APPROVED' | 'REJECTED' | 'NEEDS_WORK';
+export interface SocialPost {
+    id: string;
+    content: string;
+    status: PostStatus;
+    approvalStatus: ApprovalStatus;
+    socialMediaId: string;
+    mediaItems: MediaItem[];
+    scheduledAt: string | null;
+    publishedAt: string | null;
+    failedAt: string | null;
+    platformPostId: string | null;
+    groupId: string | null;
+    firstComment: string | null;
+    firstCommentError: string | null;
+    lastError: {
+        message: string;
+        code: string | null;
+    } | null;
+}
+export interface MediaItem {
+    key: string;
+    type: 'IMAGE' | 'VIDEO';
+    sortOrder: number;
+    url?: string;
+    coverTimestamp?: string;
+}
+export interface PaginatedPosts {
+    data: SocialPost[];
+    totalCount: number;
+    pageInfo: {
+        page: number;
+        hasNextPage: boolean;
+        perPage: number;
+    };
+}
+export interface SocialAccount {
+    id: string;
+    platform: Platform;
+    platformUsername: string | null;
+    displayName: string | null;
+}
+export interface PinterestBoard {
+    id: string;
+    boardId: string;
+    name: string;
+    description: string | null;
+    imageUrl: string | null;
+}
+export interface YouTubePlaylist {
+    id: string;
+    playlistId: string;
+    title: string;
+    description: string | null;
+    thumbnailUrl: string | null;
+}
+export interface SignedUploadUrl {
+    key: string;
+    signedUrl: string;
+}
+export interface CreatePostInput {
+    content: string;
+    firstComment?: string;
+    mediaItems?: MediaItem[];
+    scheduledAt?: string;
+    socialMediaId: string;
+}
+export interface PostControls {
+    xCommunityId?: string;
+    xQuoteTweetUrl?: string;
+    xRetweetUrl?: string;
+    tiktokPrivacy?: 'PUBLIC' | 'MUTUAL_FRIENDS' | 'ONLY_ME';
+    tiktokIsDraft?: boolean;
+    tiktokAllowComments?: boolean;
+    tiktokAllowDuet?: boolean;
+    tiktokAllowStitch?: boolean;
+    tiktokBrandOrganic?: boolean;
+    tiktokBrandContent?: boolean;
+    tiktokAutoAddMusic?: boolean;
+    instagramPostToGrid?: boolean;
+    instagramPublishType?: 'TIMELINE' | 'STORY' | 'REEL';
+    instagramCollaborators?: string[];
+    youtubePrivacy?: 'PUBLIC' | 'PRIVATE' | 'UNLISTED';
+    youtubeTags?: string[];
+    youtubeCategoryId?: string;
+    youtubeIsShort?: boolean;
+    youtubeMadeForKids?: boolean;
+    youtubeTitle?: string;
+    youtubePlaylistId?: string;
+    facebookContentType?: 'POST' | 'REEL' | 'STORY';
+    facebookAllowComments?: boolean;
+    facebookPrivacy?: 'PUBLIC' | 'FRIENDS_OF_FRIENDS' | 'FRIENDS' | 'SELF';
+    facebookCarouselMainLink?: string;
+    facebookCarouselShowEndCard?: boolean;
+    facebookReelsCoverImageKey?: string;
+    facebookReelsCollaborators?: string[];
+    pinterestBoardId?: string;
+    pinterestLink?: string;
+    linkedinAttachmentKey?: string;
+    linkedinAttachmentTitle?: string;
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "postfast-mcp",
+  "version": "0.1.0",
+  "description": "MCP server for the PostFast API — schedule and manage social media posts via AI tools",
+  "type": "module",
+  "bin": {
+    "postfast-mcp": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "postfast",
+    "social-media",
+    "scheduling",
+    "model-context-protocol",
+    "claude",
+    "ai"
+  ],
+  "author": "PostFast",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/peturgeorgievv-factory/postfast-mcp"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "@types/node": "^22.0.0"
+  }
+}