posterly-mcp-server 0.2.0 → 0.2.2

package/dist/index.js

@@ -7,9 +7,12 @@ import { createPostTool } from './tools/create-post.js';
 import { findSlotTool } from './tools/find-slot.js';
 import { listPostsTool } from './tools/list-posts.js';
 import { uploadMediaTool } from './tools/upload-media.js';
+import { getPostTool } from './tools/get-post.js';
+import { updatePostTool } from './tools/update-post.js';
+import { deletePostTool } from './tools/delete-post.js';
 const server = new McpServer({
     name: 'posterly',
-    version: '0.1.0',
+    version: '0.2.2',
 });
 let client;
 try {
@@ -65,6 +68,33 @@ server.tool(uploadMediaTool.name, uploadMediaTool.description, uploadMediaTool.i
         return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
     }
 });
+server.tool(getPostTool.name, getPostTool.description, getPostTool.inputSchema.shape, async (input) => {
+    try {
+        const text = await getPostTool.execute(client, input);
+        return { content: [{ type: 'text', text }] };
+    }
+    catch (err) {
+        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+    }
+});
+server.tool(updatePostTool.name, updatePostTool.description, updatePostTool.inputSchema.shape, async (input) => {
+    try {
+        const text = await updatePostTool.execute(client, input);
+        return { content: [{ type: 'text', text }] };
+    }
+    catch (err) {
+        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+    }
+});
+server.tool(deletePostTool.name, deletePostTool.description, deletePostTool.inputSchema.shape, async (input) => {
+    try {
+        const text = await deletePostTool.execute(client, input);
+        return { content: [{ type: 'text', text }] };
+    }
+    catch (err) {
+        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+    }
+});
 // Start the server
 async function main() {
     const transport = new StdioServerTransport();

package/dist/lib/api-client.d.ts

@@ -49,6 +49,23 @@ export declare class PosterlyClient {
     }): Promise<{
         post: Post;
     }>;
+    getPost(id: number): Promise<{
+        post: Post;
+    }>;
+    updatePost(id: number, data: {
+        caption?: string;
+        scheduled_at?: string;
+        media_url?: string;
+        media_urls?: string[];
+        post_type?: string;
+        metadata?: Record<string, unknown>;
+    }): Promise<{
+        post: Post;
+    }>;
+    deletePost(id: number): Promise<{
+        deleted: boolean;
+        id: number;
+    }>;
     findAvailableSlots(params?: {
         account_ids?: string[];
         timezone?: string;

package/dist/lib/api-client.js

@@ -50,6 +50,15 @@ export class PosterlyClient {
     async createPost(data) {
         return this.request('POST', '/posts', data);
     }
+    async getPost(id) {
+        return this.request('GET', `/posts/${id}`);
+    }
+    async updatePost(id, data) {
+        return this.request('PATCH', `/posts/${id}`, data);
+    }
+    async deletePost(id) {
+        return this.request('DELETE', `/posts/${id}`);
+    }
     async findAvailableSlots(params) {
         const searchParams = new URLSearchParams();
         if (params?.account_ids?.length)

package/dist/tools/delete-post.d.ts

@@ -0,0 +1,16 @@
+import { z } from 'zod';
+import type { PosterlyClient } from '../lib/api-client.js';
+export declare const deletePostTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        post_id: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        post_id: number;
+    }, {
+        post_id: number;
+    }>;
+    execute(client: PosterlyClient, input: {
+        post_id: number;
+    }): Promise<string>;
+};

package/dist/tools/delete-post.js

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+export const deletePostTool = {
+    name: 'delete_post',
+    description: 'Delete a scheduled or draft post. Cannot delete published or currently publishing posts.',
+    inputSchema: z.object({
+        post_id: z.number().describe('The post ID to delete'),
+    }),
+    async execute(client, input) {
+        const result = await client.deletePost(input.post_id);
+        return `Post #${result.id} deleted successfully.`;
+    },
+};

package/dist/tools/get-post.d.ts

@@ -0,0 +1,16 @@
+import { z } from 'zod';
+import type { PosterlyClient } from '../lib/api-client.js';
+export declare const getPostTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        post_id: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        post_id: number;
+    }, {
+        post_id: number;
+    }>;
+    execute(client: PosterlyClient, input: {
+        post_id: number;
+    }): Promise<string>;
+};

package/dist/tools/get-post.js

@@ -0,0 +1,26 @@
+import { z } from 'zod';
+export const getPostTool = {
+    name: 'get_post',
+    description: 'Get details of a specific post by ID. Returns caption, status, scheduled time, media, and platform info.',
+    inputSchema: z.object({
+        post_id: z.number().describe('The post ID to look up'),
+    }),
+    async execute(client, input) {
+        const result = await client.getPost(input.post_id);
+        const p = result.post;
+        const lines = [
+            `Post #${p.id}`,
+            `• Status: ${p.status}`,
+            `• Caption: ${p.content || '(empty)'}`,
+            `• Type: ${p.post_type || 'unknown'}`,
+            `• Scheduled: ${p.scheduled_at ? new Date(p.scheduled_at).toLocaleString() : 'N/A'}`,
+        ];
+        if (p.platform_post_url)
+            lines.push(`• Published URL: ${p.platform_post_url}`);
+        if (p.media_url)
+            lines.push(`• Media: ${p.media_url}`);
+        if (p.media_urls?.length)
+            lines.push(`• Media (${p.media_urls.length}): ${p.media_urls.join(', ')}`);
+        return lines.join('\n');
+    },
+};

package/dist/tools/update-post.d.ts

@@ -0,0 +1,36 @@
+import { z } from 'zod';
+import type { PosterlyClient } from '../lib/api-client.js';
+export declare const updatePostTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        post_id: z.ZodNumber;
+        caption: z.ZodOptional<z.ZodString>;
+        scheduled_at: z.ZodOptional<z.ZodString>;
+        media_url: z.ZodOptional<z.ZodString>;
+        media_urls: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        post_type: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        post_id: number;
+        caption?: string | undefined;
+        scheduled_at?: string | undefined;
+        media_url?: string | undefined;
+        media_urls?: string[] | undefined;
+        post_type?: string | undefined;
+    }, {
+        post_id: number;
+        caption?: string | undefined;
+        scheduled_at?: string | undefined;
+        media_url?: string | undefined;
+        media_urls?: string[] | undefined;
+        post_type?: string | undefined;
+    }>;
+    execute(client: PosterlyClient, input: {
+        post_id: number;
+        caption?: string;
+        scheduled_at?: string;
+        media_url?: string;
+        media_urls?: string[];
+        post_type?: string;
+    }): Promise<string>;
+};

package/dist/tools/update-post.js

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+export const updatePostTool = {
+    name: 'update_post',
+    description: 'Update a scheduled or draft post. Can change caption, scheduled time, media, or post type. Cannot edit published or currently publishing posts.',
+    inputSchema: z.object({
+        post_id: z.number().describe('The post ID to update'),
+        caption: z.string().optional().describe('New caption/text content'),
+        scheduled_at: z
+            .string()
+            .optional()
+            .describe('New scheduled time (ISO 8601, e.g. 2026-03-10T09:00:00Z)'),
+        media_url: z.string().optional().describe('New media URL'),
+        media_urls: z.array(z.string()).optional().describe('New media URLs for carousel'),
+        post_type: z
+            .string()
+            .optional()
+            .describe('New post type: text, image, video, carousel, reel, story'),
+    }),
+    async execute(client, input) {
+        const { post_id, ...updates } = input;
+        const result = await client.updatePost(post_id, updates);
+        const p = result.post;
+        const when = p.scheduled_at
+            ? new Date(p.scheduled_at).toLocaleString()
+            : 'N/A';
+        return `Post #${p.id} updated successfully!\n• Status: ${p.status}\n• Caption: ${p.content || '(empty)'}\n• Scheduled: ${when}`;
+    },
+};

package/dist/tools/upload-media.js

@@ -1,16 +1,16 @@
 import { z } from 'zod';
 export const uploadMediaTool = {
     name: 'upload_media',
-    description: 'Upload an image or video file to posterly. Returns a URL that can be used with create_post. Supports JPEG, PNG, GIF, WebP, MP4, MOV, WebM. Images up to 10MB, videos up to 50MB.',
+    description: 'Upload an image or video file to posterly. Returns a URL that can be used with create_post. Supports JPEG, PNG, GIF, WebP, MP4, MOV, WebM. Images up to 10MB, videos up to 50MB. IMPORTANT: If the user shares an image in the chat, use base64_data (not file_path) since chat-uploaded images are not on the local filesystem. Only use file_path when the user provides an actual local filesystem path.',
     inputSchema: z.object({
         file_path: z
             .string()
             .optional()
-            .describe('Absolute path to a local file to upload'),
+            .describe('Absolute local filesystem path (e.g. /Users/name/photo.jpg). Only use when the user gives you an explicit path. Do NOT guess paths for images uploaded in chat.'),
         base64_data: z
             .string()
             .optional()
-            .describe('Base64-encoded file data (alternative to file_path)'),
+            .describe('Base64-encoded file data. PREFERRED for images shared directly in chat — extract the image data as base64 and pass it here.'),
         filename: z
             .string()
             .describe('Filename with extension (e.g. photo.jpg, video.mp4)'),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "posterly-mcp-server",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "MCP server for posterly — schedule social media posts from Claude Desktop",
   "license": "MIT",
   "type": "module",

package/src/index.ts

@@ -8,10 +8,13 @@ import { createPostTool } from './tools/create-post.js';
 import { findSlotTool } from './tools/find-slot.js';
 import { listPostsTool } from './tools/list-posts.js';
 import { uploadMediaTool } from './tools/upload-media.js';
+import { getPostTool } from './tools/get-post.js';
+import { updatePostTool } from './tools/update-post.js';
+import { deletePostTool } from './tools/delete-post.js';
 
 const server = new McpServer({
   name: 'posterly',
-  version: '0.1.0',
+  version: '0.2.2',
 });
 
 let client: PosterlyClient;
@@ -94,6 +97,48 @@ server.tool(
   }
 );
 
+server.tool(
+  getPostTool.name,
+  getPostTool.description,
+  getPostTool.inputSchema.shape,
+  async (input) => {
+    try {
+      const text = await getPostTool.execute(client, input as any);
+      return { content: [{ type: 'text' as const, text }] };
+    } catch (err: any) {
+      return { content: [{ type: 'text' as const, text: `Error: ${err.message}` }], isError: true };
+    }
+  }
+);
+
+server.tool(
+  updatePostTool.name,
+  updatePostTool.description,
+  updatePostTool.inputSchema.shape,
+  async (input) => {
+    try {
+      const text = await updatePostTool.execute(client, input as any);
+      return { content: [{ type: 'text' as const, text }] };
+    } catch (err: any) {
+      return { content: [{ type: 'text' as const, text: `Error: ${err.message}` }], isError: true };
+    }
+  }
+);
+
+server.tool(
+  deletePostTool.name,
+  deletePostTool.description,
+  deletePostTool.inputSchema.shape,
+  async (input) => {
+    try {
+      const text = await deletePostTool.execute(client, input as any);
+      return { content: [{ type: 'text' as const, text }] };
+    } catch (err: any) {
+      return { content: [{ type: 'text' as const, text: `Error: ${err.message}` }], isError: true };
+    }
+  }
+);
+
 // Start the server
 async function main() {
   const transport = new StdioServerTransport();

package/src/lib/api-client.ts

@@ -104,6 +104,28 @@ export class PosterlyClient {
     return this.request('POST', '/posts', data);
   }
 
+  async getPost(id: number): Promise<{ post: Post }> {
+    return this.request('GET', `/posts/${id}`);
+  }
+
+  async updatePost(
+    id: number,
+    data: {
+      caption?: string;
+      scheduled_at?: string;
+      media_url?: string;
+      media_urls?: string[];
+      post_type?: string;
+      metadata?: Record<string, unknown>;
+    },
+  ): Promise<{ post: Post }> {
+    return this.request('PATCH', `/posts/${id}`, data);
+  }
+
+  async deletePost(id: number): Promise<{ deleted: boolean; id: number }> {
+    return this.request('DELETE', `/posts/${id}`);
+  }
+
   async findAvailableSlots(params?: {
     account_ids?: string[];
     timezone?: string;

package/src/tools/delete-post.ts

@@ -0,0 +1,19 @@
+import { z } from 'zod';
+import type { PosterlyClient } from '../lib/api-client.js';
+
+export const deletePostTool = {
+  name: 'delete_post',
+  description:
+    'Delete a scheduled or draft post. Cannot delete published or currently publishing posts.',
+  inputSchema: z.object({
+    post_id: z.number().describe('The post ID to delete'),
+  }),
+
+  async execute(
+    client: PosterlyClient,
+    input: { post_id: number },
+  ) {
+    const result = await client.deletePost(input.post_id);
+    return `Post #${result.id} deleted successfully.`;
+  },
+};

package/src/tools/get-post.ts

@@ -0,0 +1,33 @@
+import { z } from 'zod';
+import type { PosterlyClient } from '../lib/api-client.js';
+
+export const getPostTool = {
+  name: 'get_post',
+  description:
+    'Get details of a specific post by ID. Returns caption, status, scheduled time, media, and platform info.',
+  inputSchema: z.object({
+    post_id: z.number().describe('The post ID to look up'),
+  }),
+
+  async execute(
+    client: PosterlyClient,
+    input: { post_id: number },
+  ) {
+    const result = await client.getPost(input.post_id);
+    const p = result.post as Record<string, any>;
+
+    const lines = [
+      `Post #${p.id}`,
+      `• Status: ${p.status}`,
+      `• Caption: ${p.content || '(empty)'}`,
+      `• Type: ${p.post_type || 'unknown'}`,
+      `• Scheduled: ${p.scheduled_at ? new Date(p.scheduled_at).toLocaleString() : 'N/A'}`,
+    ];
+
+    if (p.platform_post_url) lines.push(`• Published URL: ${p.platform_post_url}`);
+    if (p.media_url) lines.push(`• Media: ${p.media_url}`);
+    if (p.media_urls?.length) lines.push(`• Media (${p.media_urls.length}): ${p.media_urls.join(', ')}`);
+
+    return lines.join('\n');
+  },
+};

package/src/tools/update-post.ts

@@ -0,0 +1,44 @@
+import { z } from 'zod';
+import type { PosterlyClient } from '../lib/api-client.js';
+
+export const updatePostTool = {
+  name: 'update_post',
+  description:
+    'Update a scheduled or draft post. Can change caption, scheduled time, media, or post type. Cannot edit published or currently publishing posts.',
+  inputSchema: z.object({
+    post_id: z.number().describe('The post ID to update'),
+    caption: z.string().optional().describe('New caption/text content'),
+    scheduled_at: z
+      .string()
+      .optional()
+      .describe('New scheduled time (ISO 8601, e.g. 2026-03-10T09:00:00Z)'),
+    media_url: z.string().optional().describe('New media URL'),
+    media_urls: z.array(z.string()).optional().describe('New media URLs for carousel'),
+    post_type: z
+      .string()
+      .optional()
+      .describe('New post type: text, image, video, carousel, reel, story'),
+  }),
+
+  async execute(
+    client: PosterlyClient,
+    input: {
+      post_id: number;
+      caption?: string;
+      scheduled_at?: string;
+      media_url?: string;
+      media_urls?: string[];
+      post_type?: string;
+    },
+  ) {
+    const { post_id, ...updates } = input;
+    const result = await client.updatePost(post_id, updates);
+    const p = result.post as Record<string, any>;
+
+    const when = p.scheduled_at
+      ? new Date(p.scheduled_at).toLocaleString()
+      : 'N/A';
+
+    return `Post #${p.id} updated successfully!\n• Status: ${p.status}\n• Caption: ${p.content || '(empty)'}\n• Scheduled: ${when}`;
+  },
+};

package/src/tools/upload-media.ts

@@ -4,16 +4,16 @@ import type { PosterlyClient } from '../lib/api-client.js';
 export const uploadMediaTool = {
   name: 'upload_media',
   description:
-    'Upload an image or video file to posterly. Returns a URL that can be used with create_post. Supports JPEG, PNG, GIF, WebP, MP4, MOV, WebM. Images up to 10MB, videos up to 50MB.',
+    'Upload an image or video file to posterly. Returns a URL that can be used with create_post. Supports JPEG, PNG, GIF, WebP, MP4, MOV, WebM. Images up to 10MB, videos up to 50MB. IMPORTANT: If the user shares an image in the chat, use base64_data (not file_path) since chat-uploaded images are not on the local filesystem. Only use file_path when the user provides an actual local filesystem path.',
   inputSchema: z.object({
     file_path: z
       .string()
       .optional()
-      .describe('Absolute path to a local file to upload'),
+      .describe('Absolute local filesystem path (e.g. /Users/name/photo.jpg). Only use when the user gives you an explicit path. Do NOT guess paths for images uploaded in chat.'),
     base64_data: z
       .string()
       .optional()
-      .describe('Base64-encoded file data (alternative to file_path)'),
+      .describe('Base64-encoded file data. PREFERRED for images shared directly in chat — extract the image data as base64 and pass it here.'),
     filename: z
       .string()
       .describe('Filename with extension (e.g. photo.jpg, video.mp4)'),