posterly-mcp-server 0.19.0 → 0.19.2

package/README.md

@@ -11,6 +11,8 @@ This package gives Claude Desktop, Cursor, Windsurf, Cline, and other local MCP
 - generate images
 - read account and post analytics
 
+Tool results are returned as Markdown-first chat summaries with headings, compact tables, short next-step notes, and occasional status icons. MCP clients may still rephrase the final answer, but the raw tool content is designed to look good directly in chat.
+
 Posterly also exposes the same toolset over HTTP at [poster.ly/mcp](https://www.poster.ly/mcp), but this npm package is the local `stdio` transport.
 
 ## Requirements
@@ -93,7 +95,7 @@ Add the same server definition to your Cursor MCP settings:
 
 ## Available tools
 
-`posterly-mcp-server@0.19.0` exposes 49 tools:
+`posterly-mcp-server@0.19.2` exposes 49 tools:
 
 - `whoami`
 - `list_accounts`

package/dist/generated/platform-manifest.d.ts

@@ -33,7 +33,7 @@ export declare const PLATFORM_MANIFEST: {
         readonly youtube: "youtube";
     };
     readonly helperNames: readonly ["linkedin.recent_mentions", "pinterest.boards", "tiktok.creator_info", "x.quota", "youtube.playlists"];
-    readonly analyticsPlatformIds: readonly ["instagram", "linkedin", "youtube", "pinterest", "google_business"];
+    readonly analyticsPlatformIds: readonly ["instagram", "facebook", "linkedin", "youtube", "pinterest", "google_business"];
     readonly connectTargetIds: readonly ["instagram", "meta", "facebook", "youtube", "tiktok", "linkedin", "linkedin_page", "threads", "google_business", "pinterest", "twitter", "telegram", "bluesky", "reddit", "wordpress", "mastodon", "medium", "devto", "hashnode", "discord", "slack", "skool", "whop"];
     readonly connectInputs: readonly ["bluesky", "devto", "discord", "facebook", "facebook_instagram", "facebook_pages", "gmb", "google-business", "google_business", "google_business_profile", "hashnode", "instagram", "instagram-standalone", "instagram_direct", "linkedin", "linkedin-company", "linkedin-page", "linkedin_company", "linkedin_page", "linkedin_personal", "mastodon", "medium", "meta", "meta_business", "pinterest", "reddit", "skool", "slack", "telegram", "threads", "tiktok", "twitter", "whop", "wordpress", "x", "x_twitter", "youtube"];
     readonly connectAliases: {
@@ -86,7 +86,7 @@ export declare const PLATFORM_MANIFEST: {
         readonly status: "supported";
         readonly aliases: readonly [];
         readonly postTypes: readonly ["text", "image", "video", "carousel", "reel", "story", "cover_photo"];
-        readonly analyticsSupported: false;
+        readonly analyticsSupported: true;
         readonly helpers: readonly [];
     }, {
         readonly id: "tiktok";
@@ -389,4 +389,4 @@ export declare const ALL_PLATFORM_INPUTS: readonly ["bluesky", "devto", "discord
 export declare const PLATFORM_HELPER_NAMES: readonly ["linkedin.recent_mentions", "pinterest.boards", "tiktok.creator_info", "x.quota", "youtube.playlists"];
 export declare const CONNECT_TARGET_IDS: readonly ["instagram", "meta", "facebook", "youtube", "tiktok", "linkedin", "linkedin_page", "threads", "google_business", "pinterest", "twitter", "telegram", "bluesky", "reddit", "wordpress", "mastodon", "medium", "devto", "hashnode", "discord", "slack", "skool", "whop"];
 export declare const CONNECT_INPUTS: readonly ["bluesky", "devto", "discord", "facebook", "facebook_instagram", "facebook_pages", "gmb", "google-business", "google_business", "google_business_profile", "hashnode", "instagram", "instagram-standalone", "instagram_direct", "linkedin", "linkedin-company", "linkedin-page", "linkedin_company", "linkedin_page", "linkedin_personal", "mastodon", "medium", "meta", "meta_business", "pinterest", "reddit", "skool", "slack", "telegram", "threads", "tiktok", "twitter", "whop", "wordpress", "x", "x_twitter", "youtube"];
-export declare const ANALYTICS_PLATFORM_IDS: readonly ["instagram", "linkedin", "youtube", "pinterest", "google_business"];
+export declare const ANALYTICS_PLATFORM_IDS: readonly ["instagram", "facebook", "linkedin", "youtube", "pinterest", "google_business"];

package/dist/generated/platform-manifest.js

@@ -131,6 +131,7 @@ export const PLATFORM_MANIFEST = {
     ],
     "analyticsPlatformIds": [
         "instagram",
+        "facebook",
         "linkedin",
         "youtube",
         "pinterest",
@@ -268,7 +269,7 @@ export const PLATFORM_MANIFEST = {
                 "story",
                 "cover_photo"
             ],
-            "analyticsSupported": false,
+            "analyticsSupported": true,
             "helpers": []
         },
         {
@@ -692,4 +693,4 @@ export const ALL_PLATFORM_INPUTS = ["bluesky", "devto", "discord", "facebook", "
 export const PLATFORM_HELPER_NAMES = ["linkedin.recent_mentions", "pinterest.boards", "tiktok.creator_info", "x.quota", "youtube.playlists"];
 export const CONNECT_TARGET_IDS = ["instagram", "meta", "facebook", "youtube", "tiktok", "linkedin", "linkedin_page", "threads", "google_business", "pinterest", "twitter", "telegram", "bluesky", "reddit", "wordpress", "mastodon", "medium", "devto", "hashnode", "discord", "slack", "skool", "whop"];
 export const CONNECT_INPUTS = ["bluesky", "devto", "discord", "facebook", "facebook_instagram", "facebook_pages", "gmb", "google-business", "google_business", "google_business_profile", "hashnode", "instagram", "instagram-standalone", "instagram_direct", "linkedin", "linkedin-company", "linkedin-page", "linkedin_company", "linkedin_page", "linkedin_personal", "mastodon", "medium", "meta", "meta_business", "pinterest", "reddit", "skool", "slack", "telegram", "threads", "tiktok", "twitter", "whop", "wordpress", "x", "x_twitter", "youtube"];
-export const ANALYTICS_PLATFORM_IDS = ["instagram", "linkedin", "youtube", "pinterest", "google_business"];
+export const ANALYTICS_PLATFORM_IDS = ["instagram", "facebook", "linkedin", "youtube", "pinterest", "google_business"];

package/dist/index.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { mdError } from './lib/format.js';
 import { PosterlyClient } from './lib/api-client.js';
 import { listAccountsTool } from './tools/list-accounts.js';
 import { disconnectAccountTool } from './tools/disconnect-account.js';
@@ -70,7 +71,7 @@ server.tool(whoamiTool.name, whoamiTool.description, whoamiTool.inputSchema.shap
         return { content: [{ type: 'text', text }] };
     }
     catch (err) {
-        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+        return { content: [{ type: 'text', text: mdError(err.message) }], isError: true };
     }
 });
 server.tool(listAccountsTool.name, listAccountsTool.description, listAccountsTool.inputSchema.shape, async (input) => {
@@ -79,7 +80,7 @@ server.tool(listAccountsTool.name, listAccountsTool.description, listAccountsToo
         return { content: [{ type: 'text', text }] };
     }
     catch (err) {
-        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+        return { content: [{ type: 'text', text: mdError(err.message) }], isError: true };
     }
 });
 server.tool(disconnectAccountTool.name, disconnectAccountTool.description, disconnectAccountTool.inputSchema.shape, async (input) => {
@@ -88,7 +89,7 @@ server.tool(disconnectAccountTool.name, disconnectAccountTool.description, disco
         return { content: [{ type: 'text', text }] };
     }
     catch (err) {
-        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+        return { content: [{ type: 'text', text: mdError(err.message) }], isError: true };
     }
 });
 server.tool(getConnectLinkTool.name, getConnectLinkTool.description, getConnectLinkTool.inputSchema.shape, async (input) => {
@@ -97,7 +98,7 @@ server.tool(getConnectLinkTool.name, getConnectLinkTool.description, getConnectL
         return { content: [{ type: 'text', text }] };
     }
     catch (err) {
-        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+        return { content: [{ type: 'text', text: mdError(err.message) }], isError: true };
     }
 });
 server.tool(listOAuthClientsTool.name, listOAuthClientsTool.description, listOAuthClientsTool.inputSchema.shape, async () => {
@@ -106,7 +107,7 @@ server.tool(listOAuthClientsTool.name, listOAuthClientsTool.description, listOAu
         return { content: [{ type: 'text', text }] };
     }
     catch (err) {
-        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+        return { content: [{ type: 'text', text: mdError(err.message) }], isError: true };
     }
 });
 server.tool(createOAuthClientTool.name, createOAuthClientTool.description, createOAuthClientTool.inputSchema.shape, async (input) => {
@@ -115,7 +116,7 @@ server.tool(createOAuthClientTool.name, createOAuthClientTool.description, creat
         return { content: [{ type: 'text', text }] };
     }
     catch (err) {
-        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+        return { content: [{ type: 'text', text: mdError(err.message) }], isError: true };
     }
 });
 server.tool(updateOAuthClientTool.name, updateOAuthClientTool.description, updateOAuthClientTool.inputSchema.shape, async (input) => {
@@ -124,7 +125,7 @@ server.tool(updateOAuthClientTool.name, updateOAuthClientTool.description, updat
         return { content: [{ type: 'text', text }] };
     }
     catch (err) {
-        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+        return { content: [{ type: 'text', text: mdError(err.message) }], isError: true };
     }
 });
 server.tool(deleteOAuthClientTool.name, deleteOAuthClientTool.description, deleteOAuthClientTool.inputSchema.shape, async (input) => {
@@ -133,7 +134,7 @@ server.tool(deleteOAuthClientTool.name, deleteOAuthClientTool.description, delet
         return { content: [{ type: 'text', text }] };
     }
     catch (err) {
-        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+        return { content: [{ type: 'text', text: mdError(err.message) }], isError: true };
     }
 });
 server.tool(listPlatformsTool.name, listPlatformsTool.description, listPlatformsTool.inputSchema.shape, async (input) => {
@@ -142,7 +143,7 @@ server.tool(listPlatformsTool.name, listPlatformsTool.description, listPlatforms
         return { content: [{ type: 'text', text }] };
     }
     catch (err) {
-        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+        return { content: [{ type: 'text', text: mdError(err.message) }], isError: true };
     }
 });
 server.tool(getPlatformSchemaTool.name, getPlatformSchemaTool.description, getPlatformSchemaTool.inputSchema.shape, async (input) => {
@@ -151,7 +152,7 @@ server.tool(getPlatformSchemaTool.name, getPlatformSchemaTool.description, getPl
         return { content: [{ type: 'text', text }] };
     }
     catch (err) {
-        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+        return { content: [{ type: 'text', text: mdError(err.message) }], isError: true };
     }
 });
 server.tool(triggerPlatformHelperTool.name, triggerPlatformHelperTool.description, triggerPlatformHelperTool.inputSchema.shape, async (input) => {
@@ -160,7 +161,7 @@ server.tool(triggerPlatformHelperTool.name, triggerPlatformHelperTool.descriptio
         return { content: [{ type: 'text', text }] };
     }
     catch (err) {
-        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+        return { content: [{ type: 'text', text: mdError(err.message) }], isError: true };
     }
 });
 server.tool(listBrandsTool.name, listBrandsTool.description, listBrandsTool.inputSchema.shape, async (input) => {
@@ -169,7 +170,7 @@ server.tool(listBrandsTool.name, listBrandsTool.description, listBrandsTool.inpu
         return { content: [{ type: 'text', text }] };
     }
     catch (err) {
-        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+        return { content: [{ type: 'text', text: mdError(err.message) }], isError: true };
     }
 });
 server.tool(getBrandTool.name, getBrandTool.description, getBrandTool.inputSchema.shape, async (input) => {
@@ -178,7 +179,7 @@ server.tool(getBrandTool.name, getBrandTool.description, getBrandTool.inputSchem
         return { content: [{ type: 'text', text }] };
     }
     catch (err) {
-        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+        return { content: [{ type: 'text', text: mdError(err.message) }], isError: true };
     }
 });
 server.tool(listBrandAccountsTool.name, listBrandAccountsTool.description, listBrandAccountsTool.inputSchema.shape, async (input) => {
@@ -187,7 +188,7 @@ server.tool(listBrandAccountsTool.name, listBrandAccountsTool.description, listB
         return { content: [{ type: 'text', text }] };
     }
     catch (err) {
-        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+        return { content: [{ type: 'text', text: mdError(err.message) }], isError: true };
     }
 });
 server.tool(getBrandProfileTool.name, getBrandProfileTool.description, getBrandProfileTool.inputSchema.shape, async (input) => {
@@ -196,7 +197,7 @@ server.tool(getBrandProfileTool.name, getBrandProfileTool.description, getBrandP
         return { content: [{ type: 'text', text }] };
     }
     catch (err) {
-        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+        return { content: [{ type: 'text', text: mdError(err.message) }], isError: true };
     }
 });
 server.tool(createPostTool.name, createPostTool.description, createPostTool.inputSchema.shape, async (input) => {
@@ -205,7 +206,7 @@ server.tool(createPostTool.name, createPostTool.description, createPostTool.inpu
         return { content: [{ type: 'text', text }] };
     }
     catch (err) {
-        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+        return { content: [{ type: 'text', text: mdError(err.message) }], isError: true };
     }
 });
 server.tool(createPostsBatchTool.name, createPostsBatchTool.description, createPostsBatchTool.inputSchema.shape, async (input) => {
@@ -214,7 +215,7 @@ server.tool(createPostsBatchTool.name, createPostsBatchTool.description, createP
         return { content: [{ type: 'text', text }] };
     }
     catch (err) {
-        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+        return { content: [{ type: 'text', text: mdError(err.message) }], isError: true };
     }
 });
 server.tool(findSlotTool.name, findSlotTool.description, findSlotTool.inputSchema.shape, async (input) => {
@@ -223,7 +224,7 @@ server.tool(findSlotTool.name, findSlotTool.description, findSlotTool.inputSchem
         return { content: [{ type: 'text', text }] };
     }
     catch (err) {
-        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+        return { content: [{ type: 'text', text: mdError(err.message) }], isError: true };
     }
 });
 server.tool(listPostsTool.name, listPostsTool.description, listPostsTool.inputSchema.shape, async (input) => {
@@ -232,7 +233,7 @@ server.tool(listPostsTool.name, listPostsTool.description, listPostsTool.inputSc
         return { content: [{ type: 'text', text }] };
     }
     catch (err) {
-        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+        return { content: [{ type: 'text', text: mdError(err.message) }], isError: true };
     }
 });
 server.tool(uploadMediaTool.name, uploadMediaTool.description, uploadMediaTool.inputSchema.shape, async (input) => {
@@ -241,7 +242,7 @@ server.tool(uploadMediaTool.name, uploadMediaTool.description, uploadMediaTool.i
         return { content: [{ type: 'text', text }] };
     }
     catch (err) {
-        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+        return { content: [{ type: 'text', text: mdError(err.message) }], isError: true };
     }
 });
 server.tool(uploadMediaFromUrlTool.name, uploadMediaFromUrlTool.description, uploadMediaFromUrlTool.inputSchema.shape, async (input) => {
@@ -250,7 +251,7 @@ server.tool(uploadMediaFromUrlTool.name, uploadMediaFromUrlTool.description, upl
         return { content: [{ type: 'text', text }] };
     }
     catch (err) {
-        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+        return { content: [{ type: 'text', text: mdError(err.message) }], isError: true };
     }
 });
 server.tool(createSignedUploadTool.name, createSignedUploadTool.description, createSignedUploadTool.inputSchema.shape, async (input) => {
@@ -259,7 +260,7 @@ server.tool(createSignedUploadTool.name, createSignedUploadTool.description, cre
         return { content: [{ type: 'text', text }] };
     }
     catch (err) {
-        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+        return { content: [{ type: 'text', text: mdError(err.message) }], isError: true };
     }
 });
 server.tool(getVideoOptionsTool.name, getVideoOptionsTool.description, getVideoOptionsTool.inputSchema.shape, async () => {
@@ -268,7 +269,7 @@ server.tool(getVideoOptionsTool.name, getVideoOptionsTool.description, getVideoO
         return { content: [{ type: 'text', text }] };
     }
     catch (err) {
-        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+        return { content: [{ type: 'text', text: mdError(err.message) }], isError: true };
     }
 });
 server.tool(runVideoFunctionTool.name, runVideoFunctionTool.description, runVideoFunctionTool.inputSchema.shape, async (input) => {
@@ -277,7 +278,7 @@ server.tool(runVideoFunctionTool.name, runVideoFunctionTool.description, runVide
         return { content: [{ type: 'text', text }] };
     }
     catch (err) {
-        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+        return { content: [{ type: 'text', text: mdError(err.message) }], isError: true };
     }
 });
 server.tool(generateVideoTool.name, generateVideoTool.description, generateVideoTool.inputSchema.shape, async (input) => {
@@ -286,7 +287,7 @@ server.tool(generateVideoTool.name, generateVideoTool.description, generateVideo
         return { content: [{ type: 'text', text }] };
     }
     catch (err) {
-        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+        return { content: [{ type: 'text', text: mdError(err.message) }], isError: true };
     }
 });
 server.tool(getVideoJobTool.name, getVideoJobTool.description, getVideoJobTool.inputSchema.shape, async (input) => {
@@ -295,7 +296,7 @@ server.tool(getVideoJobTool.name, getVideoJobTool.description, getVideoJobTool.i
         return { content: [{ type: 'text', text }] };
     }
     catch (err) {
-        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+        return { content: [{ type: 'text', text: mdError(err.message) }], isError: true };
     }
 });
 server.tool(generateImageTool.name, generateImageTool.description, generateImageTool.inputSchema.shape, async (input) => {
@@ -304,7 +305,7 @@ server.tool(generateImageTool.name, generateImageTool.description, generateImage
         return { content: [{ type: 'text', text }] };
     }
     catch (err) {
-        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+        return { content: [{ type: 'text', text: mdError(err.message) }], isError: true };
     }
 });
 server.tool(getPostTool.name, getPostTool.description, getPostTool.inputSchema.shape, async (input) => {
@@ -313,7 +314,7 @@ server.tool(getPostTool.name, getPostTool.description, getPostTool.inputSchema.s
         return { content: [{ type: 'text', text }] };
     }
     catch (err) {
-        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+        return { content: [{ type: 'text', text: mdError(err.message) }], isError: true };
     }
 });
 server.tool(getPostMissingTool.name, getPostMissingTool.description, getPostMissingTool.inputSchema.shape, async (input) => {
@@ -322,7 +323,7 @@ server.tool(getPostMissingTool.name, getPostMissingTool.description, getPostMiss
         return { content: [{ type: 'text', text }] };
     }
     catch (err) {
-        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+        return { content: [{ type: 'text', text: mdError(err.message) }], isError: true };
     }
 });
 server.tool(updatePostTool.name, updatePostTool.description, updatePostTool.inputSchema.shape, async (input) => {
@@ -331,7 +332,7 @@ server.tool(updatePostTool.name, updatePostTool.description, updatePostTool.inpu
         return { content: [{ type: 'text', text }] };
     }
     catch (err) {
-        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+        return { content: [{ type: 'text', text: mdError(err.message) }], isError: true };
     }
 });
 server.tool(updatePostStatusTool.name, updatePostStatusTool.description, updatePostStatusTool.inputSchema.shape, async (input) => {
@@ -340,7 +341,7 @@ server.tool(updatePostStatusTool.name, updatePostStatusTool.description, updateP
         return { content: [{ type: 'text', text }] };
     }
     catch (err) {
-        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+        return { content: [{ type: 'text', text: mdError(err.message) }], isError: true };
     }
 });
 server.tool(updatePostReleaseIdTool.name, updatePostReleaseIdTool.description, updatePostReleaseIdTool.inputSchema.shape, async (input) => {
@@ -349,7 +350,7 @@ server.tool(updatePostReleaseIdTool.name, updatePostReleaseIdTool.description, u
         return { content: [{ type: 'text', text }] };
     }
     catch (err) {
-        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+        return { content: [{ type: 'text', text: mdError(err.message) }], isError: true };
     }
 });
 server.tool(deletePostTool.name, deletePostTool.description, deletePostTool.inputSchema.shape, async (input) => {
@@ -358,7 +359,7 @@ server.tool(deletePostTool.name, deletePostTool.description, deletePostTool.inpu
         return { content: [{ type: 'text', text }] };
     }
     catch (err) {
-        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+        return { content: [{ type: 'text', text: mdError(err.message) }], isError: true };
     }
 });
 server.tool(deletePostGroupTool.name, deletePostGroupTool.description, deletePostGroupTool.inputSchema.shape, async (input) => {
@@ -367,7 +368,7 @@ server.tool(deletePostGroupTool.name, deletePostGroupTool.description, deletePos
         return { content: [{ type: 'text', text }] };
     }
     catch (err) {
-        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+        return { content: [{ type: 'text', text: mdError(err.message) }], isError: true };
     }
 });
 server.tool(getAccountAnalyticsTool.name, getAccountAnalyticsTool.description, getAccountAnalyticsTool.inputSchema.shape, async (input) => {
@@ -376,7 +377,7 @@ server.tool(getAccountAnalyticsTool.name, getAccountAnalyticsTool.description, g
         return { content: [{ type: 'text', text }] };
     }
     catch (err) {
-        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+        return { content: [{ type: 'text', text: mdError(err.message) }], isError: true };
     }
 });
 server.tool(getPostAnalyticsTool.name, getPostAnalyticsTool.description, getPostAnalyticsTool.inputSchema.shape, async (input) => {
@@ -385,7 +386,7 @@ server.tool(getPostAnalyticsTool.name, getPostAnalyticsTool.description, getPost
         return { content: [{ type: 'text', text }] };
     }
     catch (err) {
-        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+        return { content: [{ type: 'text', text: mdError(err.message) }], isError: true };
     }
 });
 server.tool(listGoogleBusinessReviewsTool.name, listGoogleBusinessReviewsTool.description, listGoogleBusinessReviewsTool.inputSchema.shape, async (input) => {
@@ -394,7 +395,7 @@ server.tool(listGoogleBusinessReviewsTool.name, listGoogleBusinessReviewsTool.de
         return { content: [{ type: 'text', text }] };
     }
     catch (err) {
-        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+        return { content: [{ type: 'text', text: mdError(err.message) }], isError: true };
     }
 });
 server.tool(getGoogleBusinessReviewLinkTool.name, getGoogleBusinessReviewLinkTool.description, getGoogleBusinessReviewLinkTool.inputSchema.shape, async (input) => {
@@ -403,7 +404,7 @@ server.tool(getGoogleBusinessReviewLinkTool.name, getGoogleBusinessReviewLinkToo
         return { content: [{ type: 'text', text }] };
     }
     catch (err) {
-        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+        return { content: [{ type: 'text', text: mdError(err.message) }], isError: true };
     }
 });
 server.tool(auditGoogleBusinessProfileTool.name, auditGoogleBusinessProfileTool.description, auditGoogleBusinessProfileTool.inputSchema.shape, async (input) => {
@@ -412,7 +413,7 @@ server.tool(auditGoogleBusinessProfileTool.name, auditGoogleBusinessProfileTool.
         return { content: [{ type: 'text', text }] };
     }
     catch (err) {
-        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+        return { content: [{ type: 'text', text: mdError(err.message) }], isError: true };
     }
 });
 server.tool(suggestGoogleBusinessReviewReplyTool.name, suggestGoogleBusinessReviewReplyTool.description, suggestGoogleBusinessReviewReplyTool.inputSchema.shape, async (input) => {
@@ -421,7 +422,7 @@ server.tool(suggestGoogleBusinessReviewReplyTool.name, suggestGoogleBusinessRevi
         return { content: [{ type: 'text', text }] };
     }
     catch (err) {
-        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+        return { content: [{ type: 'text', text: mdError(err.message) }], isError: true };
     }
 });
 server.tool(replyGoogleBusinessReviewTool.name, replyGoogleBusinessReviewTool.description, replyGoogleBusinessReviewTool.inputSchema.shape, async (input) => {
@@ -430,7 +431,7 @@ server.tool(replyGoogleBusinessReviewTool.name, replyGoogleBusinessReviewTool.de
         return { content: [{ type: 'text', text }] };
     }
     catch (err) {
-        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+        return { content: [{ type: 'text', text: mdError(err.message) }], isError: true };
     }
 });
 server.tool(deleteGoogleBusinessReviewReplyTool.name, deleteGoogleBusinessReviewReplyTool.description, deleteGoogleBusinessReviewReplyTool.inputSchema.shape, async (input) => {
@@ -439,7 +440,7 @@ server.tool(deleteGoogleBusinessReviewReplyTool.name, deleteGoogleBusinessReview
         return { content: [{ type: 'text', text }] };
     }
     catch (err) {
-        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+        return { content: [{ type: 'text', text: mdError(err.message) }], isError: true };
     }
 });
 server.tool(listActivityTool.name, listActivityTool.description, listActivityTool.inputSchema.shape, async (input) => {
@@ -448,7 +449,7 @@ server.tool(listActivityTool.name, listActivityTool.description, listActivityToo
         return { content: [{ type: 'text', text }] };
     }
     catch (err) {
-        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+        return { content: [{ type: 'text', text: mdError(err.message) }], isError: true };
     }
 });
 server.tool(listWebhooksTool.name, listWebhooksTool.description, listWebhooksTool.inputSchema.shape, async (input) => {
@@ -457,7 +458,7 @@ server.tool(listWebhooksTool.name, listWebhooksTool.description, listWebhooksToo
         return { content: [{ type: 'text', text }] };
     }
     catch (err) {
-        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+        return { content: [{ type: 'text', text: mdError(err.message) }], isError: true };
     }
 });
 server.tool(createWebhookTool.name, createWebhookTool.description, createWebhookTool.inputSchema.shape, async (input) => {
@@ -466,7 +467,7 @@ server.tool(createWebhookTool.name, createWebhookTool.description, createWebhook
         return { content: [{ type: 'text', text }] };
     }
     catch (err) {
-        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+        return { content: [{ type: 'text', text: mdError(err.message) }], isError: true };
     }
 });
 server.tool(updateWebhookTool.name, updateWebhookTool.description, updateWebhookTool.inputSchema.shape, async (input) => {
@@ -475,7 +476,7 @@ server.tool(updateWebhookTool.name, updateWebhookTool.description, updateWebhook
         return { content: [{ type: 'text', text }] };
     }
     catch (err) {
-        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+        return { content: [{ type: 'text', text: mdError(err.message) }], isError: true };
     }
 });
 server.tool(deleteWebhookTool.name, deleteWebhookTool.description, deleteWebhookTool.inputSchema.shape, async (input) => {
@@ -484,7 +485,7 @@ server.tool(deleteWebhookTool.name, deleteWebhookTool.description, deleteWebhook
         return { content: [{ type: 'text', text }] };
     }
     catch (err) {
-        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+        return { content: [{ type: 'text', text: mdError(err.message) }], isError: true };
     }
 });
 server.tool(testWebhookTool.name, testWebhookTool.description, testWebhookTool.inputSchema.shape, async (input) => {
@@ -493,7 +494,7 @@ server.tool(testWebhookTool.name, testWebhookTool.description, testWebhookTool.i
         return { content: [{ type: 'text', text }] };
     }
     catch (err) {
-        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+        return { content: [{ type: 'text', text: mdError(err.message) }], isError: true };
     }
 });
 server.tool(getXPostingQuotaTool.name, getXPostingQuotaTool.description, getXPostingQuotaTool.inputSchema.shape, async (input) => {
@@ -502,7 +503,7 @@ server.tool(getXPostingQuotaTool.name, getXPostingQuotaTool.description, getXPos
         return { content: [{ type: 'text', text }] };
     }
     catch (err) {
-        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+        return { content: [{ type: 'text', text: mdError(err.message) }], isError: true };
     }
 });
 // Start the server

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

@@ -147,6 +147,7 @@ export interface Whoami {
 export interface AccountAnalyticsSummary {
     current_followers: number;
     followers_change: number;
+    current_media_count?: number;
     total_reach: number | null;
     total_views: number | null;
     total_profile_views?: number | null;
@@ -162,6 +163,7 @@ export interface AccountAnalyticsSummary {
     total_bookings: number | null;
     total_watch_minutes?: number | null;
     total_likes?: number | null;
+    platform_metrics?: Record<string, number | null | undefined>;
 }
 export interface AccountAnalyticsSnapshot {
     date: string;

package/dist/lib/api-client.js

@@ -318,7 +318,7 @@ export class PosterlyClient {
             guessContentType(input.filename);
         const SIZE_THRESHOLD = 3 * 1024 * 1024; // 3MB
         if (fileBuffer.length > SIZE_THRESHOLD) {
-            // Large file: use signed URL to upload directly to Supabase Storage
+            // Large file: use signed URL so the API can validate actual bytes before storage.
             const signed = await this.getSignedUploadUrl(input.filename, contentType, fileBuffer.length);
             const uploadRes = await fetch(signed.upload_url, {
                 method: 'PUT',

package/dist/lib/format.d.ts

@@ -0,0 +1,21 @@
+type CellValue = string | number | boolean | null | undefined;
+export declare function mdTitle(title: string, subtitle?: string): string;
+export declare function mdTable(headers: string[], rows: CellValue[][]): string;
+export declare function mdKeyValue(rows: Array<[string, CellValue]>): string;
+export declare function mdSection(title: string, body?: string): string;
+export declare function mdBullets(items: Array<string | null | undefined>): string;
+export declare function mdJson(title: string, value: unknown): string;
+export declare function mdQuote(text: string): string;
+export declare function mdEmpty(title: string, detail: string, nextStep?: string): string;
+export declare function mdSuccess(title: string, rows: Array<[string, CellValue]>, nextStep?: string): string;
+export declare function mdError(message: string): string;
+export declare function formatNumber(value: number | null | undefined): string;
+export declare function formatPercent(value: number | null | undefined): string;
+export declare function formatDelta(value: number | null | undefined): string;
+export declare function formatDateTime(value: string | null | undefined): string;
+export declare function formatDate(value: string | null | undefined): string;
+export declare function formatBytes(value: number | null | undefined): string;
+export declare function compactText(value: string | null | undefined, maxLength?: number): string;
+export declare function statusLabel(status: string | null | undefined): string;
+export declare function code(value: CellValue): string;
+export {};