posterly-mcp-server 0.51.0 → 0.52.0

package/README.md

@@ -123,7 +123,7 @@ Add the same server definition to your Cursor MCP settings:
 
 ## Available tools
 
-`posterly-mcp-server@0.51.0` exposes 64 tools covering 100 actions. The hosted HTTP endpoint exposes the same catalog minus the three signup tools: 61 tools covering 97 actions.
+`posterly-mcp-server@0.52.0` exposes 64 tools covering 100 actions. The hosted HTTP endpoint exposes the same catalog minus the three signup tools: 61 tools covering 97 actions.
 
 Many tools pick what to do with one parameter: `view` (reads), `action` (writes), or `type`. A few pick their mode from which parameters you pass (for example `update_post` with `status` changes the status instead of editing). Every tool description names all of its views and actions.
 
@@ -446,7 +446,7 @@ In 0.45.0, the old tools below moved into the tools above. The old names still w
 
 This npm/stdio server can read local file paths. When `upload_media` receives a larger local file, it automatically requests a signed upload URL and uploads the raw bytes before returning the public media URL.
 
-The hosted HTTP MCP endpoint cannot do that for local files by itself because MCP tool calls are JSON-only. On hosted HTTP MCP, `upload_media` is for small base64 uploads up to 5MB decoded. For larger media there, use `upload_media` with `url` for public direct media URLs, or call `create_signed_upload` only from clients that can also `PUT` the raw file bytes to the returned `upload_url`.
+The hosted HTTP MCP endpoint cannot do that for local files by itself because MCP tool calls are JSON-only. On hosted HTTP MCP, `upload_media` is for small base64 uploads up to 5MB decoded. For larger media there, use `upload_media` with `url` for public direct media URLs, or call `create_signed_upload` only from clients that can also `PUT` the raw file bytes to the returned `upload_url`. One call covers 1 to 20 files with `files`; each file gets its own slot (or its own error), and slots expire in 15 minutes.
 
 ## What the brand tools are for
 

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

@@ -154,10 +154,20 @@ export interface ApiPostApproval {
     requested_at: string | null;
     completed_at: string | null;
 }
+/** Who or what created a post. Any field is null when it was never recorded. */
+export interface ApiPostCreator {
+    user_id: string | null;
+    name: string | null;
+    source: string | null;
+    source_label: string | null;
+}
 export interface Post {
     id: number;
     content: string;
     scheduled_at: string;
+    created_at?: string | null;
+    updated_at?: string | null;
+    created_by?: ApiPostCreator | null;
     social_account_id: string;
     media_url?: string;
     media_urls?: string[];
@@ -1232,6 +1242,33 @@ export interface XPostingQuotaResponse {
     addon?: Record<string, unknown>;
     plans?: Array<Record<string, unknown>>;
 }
+export type SignedUploadBatchSlot = {
+    index: number;
+    filename: string;
+    ok: true;
+    upload_url: string;
+    token: string;
+    path: string;
+    public_url: string;
+    expires_at: string;
+    max_size: number;
+    headers?: Record<string, string>;
+    provider?: string;
+} | {
+    index: number;
+    filename: string;
+    ok: false;
+    error: string;
+    code: string;
+};
+export interface SignedUploadBatchResponse {
+    slots: SignedUploadBatchSlot[];
+    summary: {
+        requested: number;
+        ok: number;
+        failed: number;
+    };
+}
 export declare class PosterlyClient {
     private baseUrl;
     private apiKey;
@@ -1673,6 +1710,11 @@ export declare class PosterlyClient {
         public_url: string;
         headers?: Record<string, string>;
     }>;
+    getSignedUploadUrls(files: Array<{
+        filename: string;
+        content_type: string;
+        size: number;
+    }>, workspaceId?: string): Promise<SignedUploadBatchResponse>;
     createMediaDrop(input?: {
         filename?: string;
         maxFiles?: number;

package/dist/lib/api-client.js

@@ -673,6 +673,12 @@ export class PosterlyClient {
             ...(workspaceId ? { workspace_id: workspaceId } : {}),
         });
     }
+    async getSignedUploadUrls(files, workspaceId) {
+        return this.request('POST', '/media/signed-upload', {
+            files,
+            ...(workspaceId ? { workspace_id: workspaceId } : {}),
+        });
+    }
     async createMediaDrop(input) {
         return this.request('POST', '/media/drop-sessions', {
             filename: input?.filename,

package/dist/lib/format.d.ts

@@ -68,6 +68,10 @@ export declare function formatCalendarDay(day: string): string;
  * day before); anything else reads as "from X up to Y".
  */
 export declare function formatPostRange(range: PostListRange): string;
+/** ISO 8601 in UTC to the second ("2026-10-07T07:32:54Z"); "unknown" when missing. */
+export declare function formatIsoTimestamp(value: string | null | undefined): string;
+/** "Georgia via Dashboard"; whichever half was never recorded reads as unknown. */
+export declare function formatPostCreator(creator: Post['created_by']): string;
 /**
  * One page of list_posts. Always says whether every matching post is shown,
  * and when it is not, exactly which offset to call next, so an agent never

package/dist/lib/format.js

@@ -304,6 +304,27 @@ export function formatPostRange(range) {
     const to = range.to ? `up to ${formatDateTimeInZone(range.to, tz)}` : '';
     return `${[from, to].filter(Boolean).join(' ')} (${tz})`;
 }
+/** ISO 8601 in UTC to the second ("2026-10-07T07:32:54Z"); "unknown" when missing. */
+export function formatIsoTimestamp(value) {
+    if (!value)
+        return 'unknown';
+    const date = new Date(value);
+    if (Number.isNaN(date.getTime()))
+        return value;
+    return date.toISOString().replace(/\.\d{3}Z$/, 'Z');
+}
+/** "Georgia via Dashboard"; whichever half was never recorded reads as unknown. */
+export function formatPostCreator(creator) {
+    const who = creator?.name || (creator?.user_id ? `user ${creator.user_id}` : null);
+    const via = creator?.source_label || null;
+    if (who && via)
+        return `${who} via ${via}`;
+    if (who)
+        return `${who} (source unknown)`;
+    if (via)
+        return `via ${via} (account unknown)`;
+    return 'unknown';
+}
 function approvalCell(post) {
     if (!post.approval || post.approval.status === 'none')
         return 'none';
@@ -340,7 +361,7 @@ export function formatPostListPage(data, options) {
         : first === 1
             ? `**Complete: all ${total} matching posts are shown.**`
             : `**Complete: this is the last page (posts ${first}-${last} of ${total}).**`;
-    const table = mdTable(['Status', 'Post ID', `Scheduled (${tz})`, 'Type', 'Account ID', 'Brand ID', 'Approval', 'Caption'], 
+    const table = mdTable(['Status', 'Post ID', `Scheduled (${tz})`, 'Type', 'Account ID', 'Brand ID', 'Approval', 'Created', 'Created by', 'Caption'], 
     // The API post row carries account and brand IDs only (no joined names);
     // list_accounts and list_brands, or view=counts, resolve them.
     posts.map((post) => [
@@ -351,6 +372,8 @@ export function formatPostListPage(data, options) {
         post.social_account_id != null ? String(post.social_account_id) : 'n/a',
         post.brand_id || 'none',
         approvalCell(post),
+        formatIsoTimestamp(post.created_at),
+        formatPostCreator(post.created_by),
         compactText(post.content, 80) || '(empty)',
     ]));
     return [

package/dist/lib/version.d.ts

@@ -1 +1 @@
-export declare const POSTERLY_MCP_VERSION = "0.51.0";
+export declare const POSTERLY_MCP_VERSION = "0.52.0";

package/dist/lib/version.js

@@ -5,4 +5,4 @@
 // tool set (minus the intentional pre-auth signup tools that only this stdio
 // package exposes). `npm run check:mcp-parity` enforces both the version match
 // and the tool-list match, and runs in the pre-commit hook.
-export const POSTERLY_MCP_VERSION = '0.51.0';
+export const POSTERLY_MCP_VERSION = '0.52.0';

package/dist/tools/create-media-drop.js

@@ -1,16 +1,16 @@
 import { z } from 'zod';
 export const createMediaDropTool = {
     name: 'create_media_drop',
-    description: 'Create a human drop page so ChatGPT or Claude users can upload a laptop file without dashboard login. Returns drop_url (https://www.poster.ly/drop/<token>). Send that URL to the user, wait, then call list_media. This is not the chat paperclip and not create_signed_upload.',
+    description: 'Create a human drop page so ChatGPT or Claude users can upload laptop files (up to 20 per link) without dashboard login. Returns drop_url (https://www.poster.ly/drop/<token>). Send that URL to the user, wait, then call list_media. This is not the chat paperclip and not create_signed_upload.',
     inputSchema: z.object({
         filename: z.string().optional().describe('Optional filename hint for the user, e.g. launch-video.mp4'),
         max_files: z
             .number()
             .int()
             .min(1)
-            .max(10)
+            .max(20)
             .optional()
-            .describe('How many files the drop can accept. Default 10, max 10.'),
+            .describe('How many files the drop can accept. Default 10, max 20.'),
         workspace_id: z.string().optional().describe('Optional. The workspace this acts in and whose plan pays (from whoami). Needed only when your connection can act in several workspaces.'),
     }),
     async execute(client, input) {

package/dist/tools/create-signed-upload.d.ts

@@ -1,28 +1,61 @@
 import { z } from 'zod';
-import type { PosterlyClient } from '../lib/api-client.js';
+import type { PosterlyClient, SignedUploadBatchResponse } from '../lib/api-client.js';
+type SignedUploadInput = {
+    filename?: string;
+    content_type?: string;
+    size?: number;
+    files?: Array<{
+        filename: string;
+        content_type: string;
+        size: number;
+    }>;
+    workspace_id?: string;
+};
+export declare function formatSignedUploadBatch(batch: SignedUploadBatchResponse, requested: Array<{
+    content_type: string;
+}>): string;
 export declare const createSignedUploadTool: {
     name: string;
     description: string;
     inputSchema: z.ZodObject<{
-        filename: z.ZodString;
-        content_type: z.ZodString;
-        size: z.ZodNumber;
+        filename: z.ZodOptional<z.ZodString>;
+        content_type: z.ZodOptional<z.ZodString>;
+        size: z.ZodOptional<z.ZodNumber>;
+        files: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            filename: z.ZodString;
+            content_type: z.ZodString;
+            size: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            filename: string;
+            content_type: string;
+            size: number;
+        }, {
+            filename: string;
+            content_type: string;
+            size: number;
+        }>, "many">>;
         workspace_id: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        filename: string;
-        content_type: string;
-        size: number;
         workspace_id?: string | undefined;
+        filename?: string | undefined;
+        content_type?: string | undefined;
+        size?: number | undefined;
+        files?: {
+            filename: string;
+            content_type: string;
+            size: number;
+        }[] | undefined;
     }, {
-        filename: string;
-        content_type: string;
-        size: number;
         workspace_id?: string | undefined;
+        filename?: string | undefined;
+        content_type?: string | undefined;
+        size?: number | undefined;
+        files?: {
+            filename: string;
+            content_type: string;
+            size: number;
+        }[] | undefined;
     }>;
-    execute(client: PosterlyClient, input: {
-        filename: string;
-        content_type: string;
-        size: number;
-        workspace_id?: string;
-    }): Promise<string>;
+    execute(client: PosterlyClient, input: SignedUploadInput): Promise<string>;
 };
+export {};

package/dist/tools/create-signed-upload.js

@@ -1,14 +1,71 @@
 import { z } from 'zod';
+const fileSchema = z.object({
+    filename: z.string().describe('Filename with extension, e.g. launch-video.mp4'),
+    content_type: z.string().describe('MIME type, e.g. video/mp4'),
+    size: z.number().int().positive().describe('File size in bytes'),
+});
+export function formatSignedUploadBatch(batch, requested) {
+    const lines = [
+        `Signed upload slots: ${batch.summary.requested} requested, ${batch.summary.ok} ready, ${batch.summary.failed} failed.`,
+        '',
+    ];
+    let earliestExpiry = null;
+    batch.slots.forEach((slot, position) => {
+        const number = position + 1;
+        if (slot.ok) {
+            const headers = slot.headers || {};
+            const headerKeys = Object.keys(headers);
+            const contentTypeKey = headerKeys.find((key) => key.toLowerCase() === 'content-type');
+            const contentType = contentTypeKey ? headers[contentTypeKey] : requested[slot.index]?.content_type;
+            lines.push(`${number}. ${slot.filename}`);
+            lines.push(`   PUT ${slot.upload_url}`);
+            if (contentType)
+                lines.push(`   Content-Type: ${contentType}`);
+            for (const key of headerKeys) {
+                if (key === contentTypeKey)
+                    continue;
+                lines.push(`   ${key}: ${headers[key]}`);
+            }
+            lines.push(`   Public URL after upload: ${slot.public_url}`);
+            if (slot.expires_at && (!earliestExpiry || slot.expires_at < earliestExpiry)) {
+                earliestExpiry = slot.expires_at;
+            }
+        }
+        else {
+            lines.push(`${number}. ${slot.filename || '(no filename)'}`);
+            lines.push(`   Failed (${slot.code}): ${slot.error}`);
+        }
+        lines.push('');
+    });
+    lines.push(`PUT each file, then pass public_url to create_post / create_posts_batch. Slots expire at ${earliestExpiry ?? 'the expires_at time returned (15 minutes)'}, call again for fresh slots.`);
+    return lines.join('\n');
+}
 export const createSignedUploadTool = {
     name: 'create_signed_upload',
-    description: 'Create a signed upload URL for a larger image or video. PUT the raw bytes to the returned upload_url (object storage) with the returned headers, then public_url can be used with create_post.',
+    description: 'Create signed upload URLs for larger images or videos, 1 to 20 files per call. For one file pass filename, content_type and size. For several pass files: [{filename, content_type, size}] (up to 20) and get one slot per file, with any file that fails reported in place. PUT the raw bytes of each file to its upload_url (object storage) with the returned headers, then pass public_url to create_post / create_posts_batch. Slots expire in 15 minutes.',
     inputSchema: z.object({
-        filename: z.string().describe('Filename with extension, e.g. launch-video.mp4'),
-        content_type: z.string().describe('MIME type, e.g. video/mp4'),
-        size: z.number().int().positive().describe('File size in bytes'),
+        filename: z.string().optional().describe('Single file: filename with extension, e.g. launch-video.mp4. Omit when using files.'),
+        content_type: z.string().optional().describe('Single file: MIME type, e.g. video/mp4. Omit when using files.'),
+        size: z.number().int().positive().optional().describe('Single file: size in bytes. Omit when using files.'),
+        files: z
+            .array(fileSchema)
+            .min(1)
+            .max(20)
+            .optional()
+            .describe('Batch: 1 to 20 files, each with filename, content_type and size. Use instead of the single-file fields.'),
         workspace_id: z.string().optional().describe('Optional. The workspace this acts in and whose plan pays (from whoami). Needed only when your connection can act in several workspaces.'),
     }),
     async execute(client, input) {
+        if (input.files !== undefined) {
+            if (input.filename !== undefined || input.content_type !== undefined || input.size !== undefined) {
+                throw new Error('Pass either files or the single-file fields (filename, content_type, size), not both.');
+            }
+            const batch = await client.getSignedUploadUrls(input.files, input.workspace_id);
+            return formatSignedUploadBatch(batch, input.files);
+        }
+        if (!input.filename || !input.content_type || !input.size) {
+            throw new Error('Provide filename, content_type and size for one file, or files for a batch of up to 20.');
+        }
         const signed = await client.getSignedUploadUrl(input.filename, input.content_type, input.size, input.workspace_id);
         return [
             'Signed upload created.',

package/dist/tools/get-post.js

@@ -1,9 +1,9 @@
 import { z } from 'zod';
-import { dashboardUrlForPost, formatLocalDateTime } from '../lib/format.js';
+import { dashboardUrlForPost, formatIsoTimestamp, formatLocalDateTime, formatPostCreator } from '../lib/format.js';
 import { validateArgs } from '../lib/tool-runtime.js';
 export const getPostTool = {
     name: 'get_post',
-    description: 'One post by ID. view=post (default): caption, status, scheduled time, media, and platform info. view=missing: whether the post is missing required content, media, account, platform settings, or metadata before it can publish; use it to repair failed or imported posts.',
+    description: 'One post by ID. view=post (default): caption, status, scheduled time, when it was created and by whom (account and channel, such as dashboard, API, or MCP), media, and platform info. view=missing: whether the post is missing required content, media, account, platform settings, or metadata before it can publish; use it to repair failed or imported posts.',
     inputSchema: z.object({
         post_id: z.number().describe('The post ID to look up'),
         view: z.enum(['post', 'missing']).optional().describe('post (default) or missing.'),
@@ -28,8 +28,14 @@ async function post(client, input) {
         `• Caption: ${p.content || '(empty)'}`,
         `• Type: ${p.post_type || 'unknown'}`,
         `• Scheduled: ${formatLocalDateTime(p.scheduled_at)}`,
-        `• View in posterly: ${dashboardUrlForPost({ id: p.id, scheduled_at: p.scheduled_at })}`,
     ];
+    if ('created_at' in p)
+        lines.push(`• Created: ${formatIsoTimestamp(p.created_at)}`);
+    if ('created_by' in p)
+        lines.push(`• Created by: ${formatPostCreator(p.created_by)}`);
+    if ('updated_at' in p)
+        lines.push(`• Last updated: ${formatIsoTimestamp(p.updated_at)}`);
+    lines.push(`• View in posterly: ${dashboardUrlForPost({ id: p.id, scheduled_at: p.scheduled_at })}`);
     if (p.platform_post_url)
         lines.push(`• Published URL: ${p.platform_post_url}`);
     if (p.media_url)

package/dist/tools/list-media.js

@@ -2,7 +2,7 @@ import { z } from 'zod';
 import { formatPagingNote } from '../lib/format.js';
 export const listMediaTool = {
     name: 'list_media',
-    description: 'List the newest media assets for the authenticated user. After create_media_drop, pass drop_session_id to see files the human uploaded on /drop/<token>. Use public_url with validate_post / create_post. The output says whether every matching file is shown; page with offset (offset + limit up to 1000) when it is not.',
+    description: 'List the newest media assets for the authenticated user. After create_media_drop, pass drop_session_id to see files the human uploaded on /drop/<token>. Use public_url with validate_post / create_post. A drop listing returns up to 20 files per page by default so a full drop fits one page. The output says whether every matching file is shown; page with offset (offset + limit up to 1000) when it is not.',
     inputSchema: z.object({
         limit: z
             .number()
@@ -10,7 +10,7 @@ export const listMediaTool = {
             .min(1)
             .max(50)
             .optional()
-            .describe('Number of assets to return (default 10, max 50)'),
+            .describe('Number of assets to return (default 10, or 20 when drop_session_id is set; max 50)'),
         offset: z
             .number()
             .int()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "posterly-mcp-server",
-  "version": "0.51.0",
+  "version": "0.52.0",
   "mcpName": "io.github.awpthorp/posterly",
   "description": "MCP server for posterly: schedule and publish social media posts across 18 platforms from any MCP client (Claude, ChatGPT, Cursor, Windsurf, Cline, and more)",
   "license": "MIT",

package/server.json

@@ -3,7 +3,7 @@
   "name": "io.github.awpthorp/posterly",
   "title": "posterly",
   "description": "Validate, schedule, publish, and analyze social content across 18 platforms with posterly.",
-  "version": "0.51.0",
+  "version": "0.52.0",
   "websiteUrl": "https://www.poster.ly/mcp",
   "repository": {
     "url": "https://github.com/awpthorp/posterly-mcp-server",
@@ -13,7 +13,7 @@
     {
       "registryType": "npm",
       "identifier": "posterly-mcp-server",
-      "version": "0.51.0",
+      "version": "0.52.0",
       "transport": {
         "type": "stdio"
       },