posterly-mcp-server 0.19.3 → 0.19.4

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

@@ -164,6 +164,10 @@ export interface AccountAnalyticsSummary {
     total_watch_minutes?: number | null;
     total_likes?: number | null;
     platform_metrics?: Record<string, number | null | undefined>;
+    display_metrics?: Array<{
+        label: string;
+        value: number | null | undefined;
+    }>;
 }
 export interface AccountAnalyticsSnapshot {
     date: string;

package/dist/tools/get-account-analytics.js

@@ -1,7 +1,7 @@
 import { z } from 'zod';
 export const getAccountAnalyticsTool = {
     name: 'get_account_analytics',
-    description: 'Get daily analytics snapshots and a period summary for a connected social account. Supports Instagram, Facebook, LinkedIn, Google Business Profile, Pinterest, and YouTube. For Google Business Profile, returns Profile Views, Search Views, Maps Views, Customer Actions, and Posts.',
+    description: 'Get daily analytics snapshots and a period summary for a connected social account. Supports Instagram, Facebook, LinkedIn, Google Business Profile, Pinterest, and YouTube. Uses API-provided display_metrics for platform-native dashboard labels such as Google Business Profile Views, Search Views, Maps Views, Customer Actions, and Posts.',
     inputSchema: z.object({
         account_id: z
             .number()
@@ -27,13 +27,11 @@ export const getAccountAnalyticsTool = {
             '',
             'Summary:',
         ];
-        if (account.platform === 'google_business') {
-            const metrics = summary.platform_metrics || {};
-            pushMetric(lines, 'Profile Views', metrics.profile_views ?? summary.total_views);
-            pushMetric(lines, 'Search Views', metrics.search_views ?? summary.total_reach);
-            pushMetric(lines, 'Maps Views', metrics.maps_views ?? summary.total_profile_views);
-            pushMetric(lines, 'Customer Actions', metrics.customer_actions ?? summary.total_accounts_engaged);
-            pushMetric(lines, 'Posts', metrics.posts ?? summary.current_media_count);
+        const nativeRows = getNativeMetricRows(account.platform, summary);
+        if (nativeRows.length > 0) {
+            for (const [label, value] of nativeRows) {
+                pushMetric(lines, label, value);
+            }
         }
         else if (account.platform === 'pinterest') {
             pushGenericSummary(lines, summary);
@@ -50,6 +48,27 @@ export const getAccountAnalyticsTool = {
         return lines.join('\n');
     },
 };
+function getNativeMetricRows(platform, summary) {
+    // API-provided display_metrics is the contract for platform-native dashboards.
+    // Add future non-generic analytics platforms there so MCP output never guesses
+    // from internal storage field names.
+    const apiRows = (summary.display_metrics || [])
+        .filter((metric) => metric?.label)
+        .map((metric) => [metric.label, metric.value]);
+    if (apiRows.length > 0)
+        return apiRows;
+    if (platform === 'google_business') {
+        const metrics = summary.platform_metrics || {};
+        return [
+            ['Profile Views', metrics.profile_views ?? summary.total_views],
+            ['Search Views', metrics.search_views ?? summary.total_reach],
+            ['Maps Views', metrics.maps_views ?? summary.total_profile_views],
+            ['Customer Actions', metrics.customer_actions ?? summary.total_accounts_engaged],
+            ['Posts', metrics.posts ?? summary.current_media_count],
+        ];
+    }
+    return [];
+}
 function formatDelta(n) {
     return n >= 0 ? `+${n.toLocaleString()}` : n.toLocaleString();
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "posterly-mcp-server",
-  "version": "0.19.3",
+  "version": "0.19.4",
   "description": "MCP server for posterly — schedule social media posts from Claude Desktop",
   "license": "MIT",
   "homepage": "https://www.poster.ly/mcp",

package/src/lib/api-client.ts

@@ -152,6 +152,7 @@ export interface AccountAnalyticsSummary {
   total_watch_minutes?: number | null;
   total_likes?: number | null;
   platform_metrics?: Record<string, number | null | undefined>;
+  display_metrics?: Array<{ label: string; value: number | null | undefined }>;
 }
 
 export interface AccountAnalyticsSnapshot {

package/src/tools/get-account-analytics.ts

@@ -4,7 +4,7 @@ import type { AccountAnalyticsSummary, PosterlyClient } from '../lib/api-client.
 export const getAccountAnalyticsTool = {
   name: 'get_account_analytics',
   description:
-    'Get daily analytics snapshots and a period summary for a connected social account. Supports Instagram, Facebook, LinkedIn, Google Business Profile, Pinterest, and YouTube. For Google Business Profile, returns Profile Views, Search Views, Maps Views, Customer Actions, and Posts.',
+    'Get daily analytics snapshots and a period summary for a connected social account. Supports Instagram, Facebook, LinkedIn, Google Business Profile, Pinterest, and YouTube. Uses API-provided display_metrics for platform-native dashboard labels such as Google Business Profile Views, Search Views, Maps Views, Customer Actions, and Posts.',
   inputSchema: z.object({
     account_id: z
       .number()
@@ -37,13 +37,11 @@ export const getAccountAnalyticsTool = {
       'Summary:',
     ];
 
-    if (account.platform === 'google_business') {
-      const metrics = summary.platform_metrics || {};
-      pushMetric(lines, 'Profile Views', metrics.profile_views ?? summary.total_views);
-      pushMetric(lines, 'Search Views', metrics.search_views ?? summary.total_reach);
-      pushMetric(lines, 'Maps Views', metrics.maps_views ?? summary.total_profile_views);
-      pushMetric(lines, 'Customer Actions', metrics.customer_actions ?? summary.total_accounts_engaged);
-      pushMetric(lines, 'Posts', metrics.posts ?? summary.current_media_count);
+    const nativeRows = getNativeMetricRows(account.platform, summary);
+    if (nativeRows.length > 0) {
+      for (const [label, value] of nativeRows) {
+        pushMetric(lines, label, value);
+      }
     } else if (account.platform === 'pinterest') {
       pushGenericSummary(lines, summary);
       pushMetric(lines, 'Outbound clicks', summary.total_website_clicks);
@@ -59,6 +57,31 @@ export const getAccountAnalyticsTool = {
   },
 };
 
+type MetricRow = [label: string, value: number | null | undefined];
+
+function getNativeMetricRows(platform: string, summary: AccountAnalyticsSummary): MetricRow[] {
+  // API-provided display_metrics is the contract for platform-native dashboards.
+  // Add future non-generic analytics platforms there so MCP output never guesses
+  // from internal storage field names.
+  const apiRows = (summary.display_metrics || [])
+    .filter((metric) => metric?.label)
+    .map((metric) => [metric.label, metric.value] as MetricRow);
+  if (apiRows.length > 0) return apiRows;
+
+  if (platform === 'google_business') {
+    const metrics = summary.platform_metrics || {};
+    return [
+      ['Profile Views', metrics.profile_views ?? summary.total_views],
+      ['Search Views', metrics.search_views ?? summary.total_reach],
+      ['Maps Views', metrics.maps_views ?? summary.total_profile_views],
+      ['Customer Actions', metrics.customer_actions ?? summary.total_accounts_engaged],
+      ['Posts', metrics.posts ?? summary.current_media_count],
+    ];
+  }
+
+  return [];
+}
+
 function formatDelta(n: number): string {
   return n >= 0 ? `+${n.toLocaleString()}` : n.toLocaleString();
 }