posterly-mcp-server 0.48.3 → 0.48.4

package/README.md

@@ -123,7 +123,7 @@ Add the same server definition to your Cursor MCP settings:
 
 ## Available tools
 
-`posterly-mcp-server@0.48.3` exposes 62 tools covering 95 actions. The hosted HTTP endpoint exposes the same catalog minus the three signup tools: 59 tools covering 92 actions.
+`posterly-mcp-server@0.48.4` exposes 62 tools covering 95 actions. The hosted HTTP endpoint exposes the same catalog minus the three signup tools: 59 tools covering 92 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

@@ -559,12 +559,24 @@ export type SuggestedSlotBasis = 'yours' | 'platform' | 'default';
 export interface SuggestedSlot extends Slot {
     basis: SuggestedSlotBasis;
     reason: string;
+    /** 1-5; confidence-capped by basis (yours up to 5, platform up to 4, default up to 3). */
+    stars: number;
+    /** Tooltip text for `stars`, distinct from `reason`. */
+    star_reason: string;
+}
+export interface SuggestedTimesWeeklyRating {
+    stars: number;
+    basis: SuggestedSlotBasis;
+    reason: string;
+    estimated: boolean;
 }
 export interface SuggestedSlotsResponse {
     timezone: string;
     basis: SuggestedSlotBasis;
     basis_label: string;
     slots: SuggestedSlot[];
+    /** Only present when include=weekly_ratings was passed. */
+    weekly_ratings?: SuggestedTimesWeeklyRating[];
 }
 export interface Workspace {
     id: string;

package/dist/lib/format.d.ts

@@ -7,6 +7,13 @@ export declare function formatLocalDateTime(value?: string | null): string;
 export declare function dashboardUrlForPost(post: Pick<Post, 'id' | 'scheduled_at'>): string;
 export declare function dashboardUrlForPosts(): string;
 export declare function dashboardUrlForPostList(posts: Array<Pick<Post, 'scheduled_at'>>): string;
+/**
+ * Renders a 1-5 star rating as filled/empty glyphs, e.g. 4 -> "★★★★☆".
+ * Appends " (est.)" for a default-basis rating, matching the dashboard's
+ * "Estimated" badge, so a thin or absent data signal reads the same way on
+ * both surfaces.
+ */
+export declare function starGlyphs(stars: unknown, estimated?: boolean): string;
 export declare function truncateText(value: string | null | undefined, max?: number): string;
 export declare function formatAccountLabel(account: Account): string;
 export declare function formatConnectedAccounts(accounts?: Account[]): string;

package/dist/lib/format.js

@@ -25,6 +25,17 @@ export function dashboardUrlForPostList(posts) {
     }
     return DASHBOARD_TABLE_URL;
 }
+/**
+ * Renders a 1-5 star rating as filled/empty glyphs, e.g. 4 -> "★★★★☆".
+ * Appends " (est.)" for a default-basis rating, matching the dashboard's
+ * "Estimated" badge, so a thin or absent data signal reads the same way on
+ * both surfaces.
+ */
+export function starGlyphs(stars, estimated = false) {
+    const n = Math.max(0, Math.min(5, Math.round(Number(stars)) || 0));
+    const glyphs = '★'.repeat(n) + '☆'.repeat(5 - n);
+    return estimated ? `${glyphs} (est.)` : glyphs;
+}
 export function truncateText(value, max = 80) {
     const text = value?.trim() || '';
     if (!text)

package/dist/lib/version.d.ts

@@ -1 +1 @@
-export declare const POSTERLY_MCP_VERSION = "0.48.3";
+export declare const POSTERLY_MCP_VERSION = "0.48.4";

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

package/dist/tools/find-slot.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { formatDate, mdEmpty, mdTable, mdTitle } from '../lib/format.js';
+import { formatDate, mdEmpty, mdTable, mdTitle, starGlyphs } from '../lib/format.js';
 const SUGGESTED_BASIS_LABELS = {
     yours: 'Based on your posts',
     platform: 'Popular on this platform',
@@ -7,7 +7,7 @@ const SUGGESTED_BASIS_LABELS = {
 };
 export const findSlotTool = {
     name: 'find_available_slot',
-    description: 'Find available time slots for posting. Respects a 1-hour gap between posts and preferred hours (8am-10pm in the given timezone). Returns up to 10 slots. IMPORTANT: pass a timezone explicitly - default is America/New_York and slots will be off if the user is elsewhere. Pass workspace_id to only avoid collisions with posts in that workspace. strategy "best_engagement" (needs account_ids) ranks the next 7 days by when these accounts get the most engagement, with a reason per slot.',
+    description: 'Find available time slots for posting. Respects a 1-hour gap between posts and preferred hours (8am-10pm in the given timezone). Returns up to 10 slots. IMPORTANT: pass a timezone explicitly - default is America/New_York and slots will be off if the user is elsewhere. Pass workspace_id to only avoid collisions with posts in that workspace. strategy "best_engagement" (needs account_ids) ranks the next 7 days by when these accounts get the most engagement, with a 1-5 star rating and a reason per slot.',
     inputSchema: z.object({
         account_ids: z
             .array(z.string())
@@ -54,9 +54,10 @@ export const findSlotTool = {
                 `Basis: ${basis}${result.timezone ? ` (${result.timezone})` : ''}`,
                 // local_time already carries the date in the requested timezone, so
                 // no separate Date column (a machine-local date could disagree).
-                mdTable(['Option', 'Local time', 'Why'], slots.map((slot, index) => [
+                mdTable(['Option', 'Local time', 'Rating', 'Why'], slots.map((slot, index) => [
                     index + 1,
                     slot.local_time,
+                    starGlyphs(slot.stars, slot.basis === 'default'),
                     slot.reason || 'n/a',
                 ])),
             ].join('\n\n');

package/package.json

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

package/src/lib/api-client.ts

@@ -611,6 +611,17 @@ export type SuggestedSlotBasis = 'yours' | 'platform' | 'default';
 export interface SuggestedSlot extends Slot {
   basis: SuggestedSlotBasis;
   reason: string;
+  /** 1-5; confidence-capped by basis (yours up to 5, platform up to 4, default up to 3). */
+  stars: number;
+  /** Tooltip text for `stars`, distinct from `reason`. */
+  star_reason: string;
+}
+
+export interface SuggestedTimesWeeklyRating {
+  stars: number;
+  basis: SuggestedSlotBasis;
+  reason: string;
+  estimated: boolean;
 }
 
 export interface SuggestedSlotsResponse {
@@ -618,6 +629,8 @@ export interface SuggestedSlotsResponse {
   basis: SuggestedSlotBasis;
   basis_label: string;
   slots: SuggestedSlot[];
+  /** Only present when include=weekly_ratings was passed. */
+  weekly_ratings?: SuggestedTimesWeeklyRating[];
 }
 
 export interface Workspace {

package/src/lib/format.ts

@@ -33,6 +33,18 @@ export function dashboardUrlForPostList(posts: Array<Pick<Post, 'scheduled_at'>>
   return DASHBOARD_TABLE_URL;
 }
 
+/**
+ * Renders a 1-5 star rating as filled/empty glyphs, e.g. 4 -> "★★★★☆".
+ * Appends " (est.)" for a default-basis rating, matching the dashboard's
+ * "Estimated" badge, so a thin or absent data signal reads the same way on
+ * both surfaces.
+ */
+export function starGlyphs(stars: unknown, estimated = false): string {
+  const n = Math.max(0, Math.min(5, Math.round(Number(stars)) || 0));
+  const glyphs = '★'.repeat(n) + '☆'.repeat(5 - n);
+  return estimated ? `${glyphs} (est.)` : glyphs;
+}
+
 export function truncateText(value: string | null | undefined, max = 80): string {
   const text = value?.trim() || '';
   if (!text) return '(empty)';

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

package/src/tools/find-slot.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import type { PosterlyClient } from '../lib/api-client.js';
-import { formatDate, mdEmpty, mdTable, mdTitle } from '../lib/format.js';
+import { formatDate, mdEmpty, mdTable, mdTitle, starGlyphs } from '../lib/format.js';
 
 const SUGGESTED_BASIS_LABELS: Record<string, string> = {
   yours: 'Based on your posts',
@@ -11,7 +11,7 @@ const SUGGESTED_BASIS_LABELS: Record<string, string> = {
 export const findSlotTool = {
   name: 'find_available_slot',
   description:
-    'Find available time slots for posting. Respects a 1-hour gap between posts and preferred hours (8am-10pm in the given timezone). Returns up to 10 slots. IMPORTANT: pass a timezone explicitly - default is America/New_York and slots will be off if the user is elsewhere. Pass workspace_id to only avoid collisions with posts in that workspace. strategy "best_engagement" (needs account_ids) ranks the next 7 days by when these accounts get the most engagement, with a reason per slot.',
+    'Find available time slots for posting. Respects a 1-hour gap between posts and preferred hours (8am-10pm in the given timezone). Returns up to 10 slots. IMPORTANT: pass a timezone explicitly - default is America/New_York and slots will be off if the user is elsewhere. Pass workspace_id to only avoid collisions with posts in that workspace. strategy "best_engagement" (needs account_ids) ranks the next 7 days by when these accounts get the most engagement, with a 1-5 star rating and a reason per slot.',
   inputSchema: z.object({
     account_ids: z
       .array(z.string())
@@ -69,10 +69,11 @@ export const findSlotTool = {
         // local_time already carries the date in the requested timezone, so
         // no separate Date column (a machine-local date could disagree).
         mdTable(
-          ['Option', 'Local time', 'Why'],
+          ['Option', 'Local time', 'Rating', 'Why'],
           slots.map((slot, index) => [
             index + 1,
             slot.local_time,
+            starGlyphs(slot.stars, slot.basis === 'default'),
             slot.reason || 'n/a',
           ]),
         ),