posterly-mcp-server 0.51.0 → 0.51.1

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.51.1` 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.
 

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[];

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.51.1";

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.51.1';

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "posterly-mcp-server",
-  "version": "0.51.0",
+  "version": "0.51.1",
   "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.51.1",
   "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.51.1",
       "transport": {
         "type": "stdio"
       },