posterly-mcp-server 0.45.1 → 0.45.3

package/README.md

@@ -122,7 +122,7 @@ Add the same server definition to your Cursor MCP settings:
 
 ## Available tools
 
-`posterly-mcp-server@0.45.1` exposes 62 tools covering 94 actions. The hosted HTTP endpoint exposes the same catalog minus the three signup tools: 59 tools covering 91 actions.
+`posterly-mcp-server@0.45.3` exposes 62 tools covering 94 actions. The hosted HTTP endpoint exposes the same catalog minus the three signup tools: 59 tools covering 91 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/RELEASING.md

@@ -101,3 +101,15 @@ up on their next client restart; there is nothing for them to do.
 Do not `npm unpublish` and do not republish the same number — npm versions are
 immutable and unpublishing breaks anyone who already resolved it. Cut the next
 patch version and publish that.
+
+
+## Publishing from GitHub (trusted publishing)
+
+npm now requires 2FA or a trusted publisher to publish. The repo has a manual
+workflow, `.github/workflows/publish-mcp.yml` ("Publish MCP"), that publishes
+`mcp-server/` with GitHub OIDC, so no npm token or one-time code is needed.
+One-time setup on npmjs.com: package `posterly-mcp-server` > Settings >
+Trusted Publisher > GitHub Actions, owner `awpthorp`, repository `posterly`,
+workflow `publish-mcp.yml`. After an MCP change merges and deploys, run it from
+the Actions tab (or `gh workflow run publish-mcp.yml`), then
+`npm run check:mcp-published`. It skips if the version is already on npm.

package/dist/lib/version.d.ts

@@ -1 +1 @@
-export declare const POSTERLY_MCP_VERSION = "0.45.1";
+export declare const POSTERLY_MCP_VERSION = "0.45.3";

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.45.1';
+export const POSTERLY_MCP_VERSION = '0.45.3';

package/dist/tools/audit-google-business-profile.d.ts

@@ -1,5 +1,9 @@
 import { z } from 'zod';
 import type { PosterlyClient } from '../lib/api-client.js';
+export declare function formatGoogleBusinessAuditText(result: {
+    audit?: any;
+    fetchedAt?: string;
+}): string;
 export declare const auditGoogleBusinessProfileTool: {
     name: string;
     description: string;

package/dist/tools/audit-google-business-profile.js

@@ -1,7 +1,37 @@
 import { z } from 'zod';
+const AUDIT_SECTION_ORDER = ['basicInfo', 'hours', 'categories', 'description', 'media', 'attributes', 'reviews'];
+export function formatGoogleBusinessAuditText(result) {
+    const audit = result.audit || {};
+    const recommendations = Array.isArray(audit.recommendations) ? audit.recommendations : [];
+    const sections = audit.sections && typeof audit.sections === 'object' ? audit.sections : {};
+    const lines = [
+        `Google Business audit: ${audit.businessName || 'Unknown business'}`,
+        `Score: ${audit.overallScore ?? 'n/a'} (${audit.overallGrade || 'n/a'})`,
+        `Fetched: ${result.fetchedAt || 'unknown'}`,
+    ];
+    const keys = [
+        ...AUDIT_SECTION_ORDER.filter((key) => sections[key]),
+        ...Object.keys(sections).filter((key) => !AUDIT_SECTION_ORDER.includes(key)),
+    ];
+    if (keys.length > 0) {
+        lines.push('Sections:');
+        for (const key of keys) {
+            const section = sections[key] || {};
+            const label = section.label || key;
+            lines.push(`- ${label}: ${section.score ?? 'n/a'}/${section.maxScore ?? 'n/a'}`);
+        }
+    }
+    if (recommendations.length > 0) {
+        lines.push('Top recommendations:');
+        for (const rec of recommendations.slice(0, 5)) {
+            lines.push(`- ${rec.priority || 'medium'}: ${rec.description || rec.title || 'Recommendation'}`);
+        }
+    }
+    return lines.join('\n');
+}
 export const auditGoogleBusinessProfileTool = {
     name: 'audit_google_business_profile',
-    description: 'Run a live local-profile audit for a connected Google Business Profile location, including completeness, categories, media, attributes, reviews, and recommendations.',
+    description: 'Run a live local-profile audit for a connected Google Business Profile location. Returns the 0-100 completeness score, letter grade, a score for each section (profile basics, hours, categories, description, photos, attributes, review health), and recommendations.',
     inputSchema: z.object({
         workspace_id: z.string().optional().describe('Filter to a workspace ID from whoami.'),
         account_id: z.number().int().positive().optional().describe('Google Business account ID from list_accounts.'),
@@ -9,19 +39,6 @@ export const auditGoogleBusinessProfileTool = {
     }),
     async execute(client, input) {
         const result = await client.auditGoogleBusinessProfile(input);
-        const audit = result.audit || {};
-        const recommendations = Array.isArray(audit.recommendations) ? audit.recommendations : [];
-        const lines = [
-            `Google Business audit: ${audit.businessName || 'Unknown business'}`,
-            `Score: ${audit.overallScore ?? 'n/a'} (${audit.overallGrade || 'n/a'})`,
-            `Fetched: ${result.fetchedAt || 'unknown'}`,
-        ];
-        if (recommendations.length > 0) {
-            lines.push('Top recommendations:');
-            for (const rec of recommendations.slice(0, 5)) {
-                lines.push(`- ${rec.priority || 'medium'}: ${rec.description || rec.title || 'Recommendation'}`);
-            }
-        }
-        return lines.join('\n');
+        return formatGoogleBusinessAuditText(result);
     },
 };

package/dist/tools/create-post.js

@@ -310,6 +310,15 @@ export const createPostTool = {
             `• Scheduled: ${when}`,
             `• View in posterly: ${dashboardUrl}`,
         ];
+        if (p.reel_cover_url) {
+            lines.push(`• Reel cover: ${p.reel_cover_url}`);
+        }
+        if (p.thumbnail_url) {
+            lines.push(`• Thumbnail: ${p.thumbnail_url}`);
+        }
+        if (p.youtube_thumbnail_url) {
+            lines.push(`• YouTube thumbnail: ${p.youtube_thumbnail_url}`);
+        }
         if (thread_posts) {
             lines.push(`• Thread: ${thread_posts.length} posts`);
         }

package/dist/tools/update-post.js

@@ -191,6 +191,9 @@ async function editPost(client, input) {
             ['Status', statusLabel(p.status)],
             ['Scheduled', formatDateTime(p.scheduled_at)],
             ['Type', p.post_type || 'unknown'],
+            ...(p.reel_cover_url ? [['Reel cover', p.reel_cover_url]] : []),
+            ...(p.thumbnail_url ? [['Thumbnail', p.thumbnail_url]] : []),
+            ...(p.youtube_thumbnail_url ? [['YouTube thumbnail', p.youtube_thumbnail_url]] : []),
         ]),
         mdSection('Caption', p.content ? mdQuote(p.content) : '_(empty)_'),
     ].join('\n\n');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "posterly-mcp-server",
-  "version": "0.45.1",
+  "version": "0.45.3",
   "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.45.1",
+  "version": "0.45.3",
   "websiteUrl": "https://www.poster.ly/mcp",
   "repository": {
     "url": "https://github.com/awpthorp/posterly",
@@ -14,7 +14,7 @@
     {
       "registryType": "npm",
       "identifier": "posterly-mcp-server",
-      "version": "0.45.1",
+      "version": "0.45.3",
       "transport": {
         "type": "stdio"
       },

package/src/lib/version.ts

@@ -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.45.1';
+export const POSTERLY_MCP_VERSION = '0.45.3';

package/src/tools/audit-google-business-profile.ts

@@ -1,10 +1,42 @@
 import { z } from 'zod';
 import type { PosterlyClient } from '../lib/api-client.js';
 
+const AUDIT_SECTION_ORDER = ['basicInfo', 'hours', 'categories', 'description', 'media', 'attributes', 'reviews'];
+
+export function formatGoogleBusinessAuditText(result: { audit?: any; fetchedAt?: string }): string {
+  const audit = result.audit || {};
+  const recommendations = Array.isArray(audit.recommendations) ? audit.recommendations : [];
+  const sections = audit.sections && typeof audit.sections === 'object' ? audit.sections : {};
+  const lines = [
+    `Google Business audit: ${audit.businessName || 'Unknown business'}`,
+    `Score: ${audit.overallScore ?? 'n/a'} (${audit.overallGrade || 'n/a'})`,
+    `Fetched: ${result.fetchedAt || 'unknown'}`,
+  ];
+  const keys = [
+    ...AUDIT_SECTION_ORDER.filter((key) => sections[key]),
+    ...Object.keys(sections).filter((key) => !AUDIT_SECTION_ORDER.includes(key)),
+  ];
+  if (keys.length > 0) {
+    lines.push('Sections:');
+    for (const key of keys) {
+      const section = sections[key] || {};
+      const label = section.label || key;
+      lines.push(`- ${label}: ${section.score ?? 'n/a'}/${section.maxScore ?? 'n/a'}`);
+    }
+  }
+  if (recommendations.length > 0) {
+    lines.push('Top recommendations:');
+    for (const rec of recommendations.slice(0, 5)) {
+      lines.push(`- ${rec.priority || 'medium'}: ${rec.description || rec.title || 'Recommendation'}`);
+    }
+  }
+  return lines.join('\n');
+}
+
 export const auditGoogleBusinessProfileTool = {
   name: 'audit_google_business_profile',
   description:
-    'Run a live local-profile audit for a connected Google Business Profile location, including completeness, categories, media, attributes, reviews, and recommendations.',
+    'Run a live local-profile audit for a connected Google Business Profile location. Returns the 0-100 completeness score, letter grade, a score for each section (profile basics, hours, categories, description, photos, attributes, review health), and recommendations.',
   inputSchema: z.object({
     workspace_id: z.string().optional().describe('Filter to a workspace ID from whoami.'),
     account_id: z.number().int().positive().optional().describe('Google Business account ID from list_accounts.'),
@@ -20,19 +52,6 @@ export const auditGoogleBusinessProfileTool = {
     },
   ) {
     const result = await client.auditGoogleBusinessProfile(input);
-    const audit = result.audit || {};
-    const recommendations = Array.isArray(audit.recommendations) ? audit.recommendations : [];
-    const lines = [
-      `Google Business audit: ${audit.businessName || 'Unknown business'}`,
-      `Score: ${audit.overallScore ?? 'n/a'} (${audit.overallGrade || 'n/a'})`,
-      `Fetched: ${result.fetchedAt || 'unknown'}`,
-    ];
-    if (recommendations.length > 0) {
-      lines.push('Top recommendations:');
-      for (const rec of recommendations.slice(0, 5)) {
-        lines.push(`- ${rec.priority || 'medium'}: ${rec.description || rec.title || 'Recommendation'}`);
-      }
-    }
-    return lines.join('\n');
+    return formatGoogleBusinessAuditText(result);
   },
 };

package/src/tools/create-post.ts

@@ -345,6 +345,15 @@ export const createPostTool = {
       `• Scheduled: ${when}`,
       `• View in posterly: ${dashboardUrl}`,
     ];
+    if (p.reel_cover_url) {
+      lines.push(`• Reel cover: ${p.reel_cover_url}`);
+    }
+    if (p.thumbnail_url) {
+      lines.push(`• Thumbnail: ${p.thumbnail_url}`);
+    }
+    if (p.youtube_thumbnail_url) {
+      lines.push(`• YouTube thumbnail: ${p.youtube_thumbnail_url}`);
+    }
     if (thread_posts) {
       lines.push(`• Thread: ${thread_posts.length} posts`);
     }

package/src/tools/update-post.ts

@@ -217,6 +217,9 @@ async function editPost(client: PosterlyClient, input: EditInput): Promise<strin
       ['Status', statusLabel(p.status)],
       ['Scheduled', formatDateTime(p.scheduled_at)],
       ['Type', p.post_type || 'unknown'],
+      ...(p.reel_cover_url ? [['Reel cover', p.reel_cover_url] as [string, string]] : []),
+      ...(p.thumbnail_url ? [['Thumbnail', p.thumbnail_url] as [string, string]] : []),
+      ...(p.youtube_thumbnail_url ? [['YouTube thumbnail', p.youtube_thumbnail_url] as [string, string]] : []),
     ]),
     mdSection('Caption', p.content ? mdQuote(p.content) : '_(empty)_'),
   ].join('\n\n');