posterly-mcp-server 0.19.1 → 0.19.2

package/src/index.ts

@@ -2,6 +2,7 @@
 
 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';
@@ -77,7 +78,7 @@ server.tool(
       const text = await whoamiTool.execute(client);
       return { content: [{ type: 'text' as const, text }] };
     } catch (err: any) {
-      return { content: [{ type: 'text' as const, text: `Error: ${err.message}` }], isError: true };
+      return { content: [{ type: 'text' as const, text: mdError(err.message) }], isError: true };
     }
   }
 );
@@ -91,7 +92,7 @@ server.tool(
       const text = await listAccountsTool.execute(client, input as any);
       return { content: [{ type: 'text' as const, text }] };
     } catch (err: any) {
-      return { content: [{ type: 'text' as const, text: `Error: ${err.message}` }], isError: true };
+      return { content: [{ type: 'text' as const, text: mdError(err.message) }], isError: true };
     }
   }
 );
@@ -105,7 +106,7 @@ server.tool(
       const text = await disconnectAccountTool.execute(client, input as any);
       return { content: [{ type: 'text' as const, text }] };
     } catch (err: any) {
-      return { content: [{ type: 'text' as const, text: `Error: ${err.message}` }], isError: true };
+      return { content: [{ type: 'text' as const, text: mdError(err.message) }], isError: true };
     }
   }
 );
@@ -119,7 +120,7 @@ server.tool(
       const text = await getConnectLinkTool.execute(client, input as any);
       return { content: [{ type: 'text' as const, text }] };
     } catch (err: any) {
-      return { content: [{ type: 'text' as const, text: `Error: ${err.message}` }], isError: true };
+      return { content: [{ type: 'text' as const, text: mdError(err.message) }], isError: true };
     }
   }
 );
@@ -133,7 +134,7 @@ server.tool(
       const text = await listOAuthClientsTool.execute(client);
       return { content: [{ type: 'text' as const, text }] };
     } catch (err: any) {
-      return { content: [{ type: 'text' as const, text: `Error: ${err.message}` }], isError: true };
+      return { content: [{ type: 'text' as const, text: mdError(err.message) }], isError: true };
     }
   }
 );
@@ -147,7 +148,7 @@ server.tool(
       const text = await createOAuthClientTool.execute(client, input as any);
       return { content: [{ type: 'text' as const, text }] };
     } catch (err: any) {
-      return { content: [{ type: 'text' as const, text: `Error: ${err.message}` }], isError: true };
+      return { content: [{ type: 'text' as const, text: mdError(err.message) }], isError: true };
     }
   }
 );
@@ -161,7 +162,7 @@ server.tool(
       const text = await updateOAuthClientTool.execute(client, input as any);
       return { content: [{ type: 'text' as const, text }] };
     } catch (err: any) {
-      return { content: [{ type: 'text' as const, text: `Error: ${err.message}` }], isError: true };
+      return { content: [{ type: 'text' as const, text: mdError(err.message) }], isError: true };
     }
   }
 );
@@ -175,7 +176,7 @@ server.tool(
       const text = await deleteOAuthClientTool.execute(client, input as any);
       return { content: [{ type: 'text' as const, text }] };
     } catch (err: any) {
-      return { content: [{ type: 'text' as const, text: `Error: ${err.message}` }], isError: true };
+      return { content: [{ type: 'text' as const, text: mdError(err.message) }], isError: true };
     }
   }
 );
@@ -189,7 +190,7 @@ server.tool(
       const text = await listPlatformsTool.execute(client, input as any);
       return { content: [{ type: 'text' as const, text }] };
     } catch (err: any) {
-      return { content: [{ type: 'text' as const, text: `Error: ${err.message}` }], isError: true };
+      return { content: [{ type: 'text' as const, text: mdError(err.message) }], isError: true };
     }
   }
 );
@@ -203,7 +204,7 @@ server.tool(
       const text = await getPlatformSchemaTool.execute(client, input as any);
       return { content: [{ type: 'text' as const, text }] };
     } catch (err: any) {
-      return { content: [{ type: 'text' as const, text: `Error: ${err.message}` }], isError: true };
+      return { content: [{ type: 'text' as const, text: mdError(err.message) }], isError: true };
     }
   }
 );
@@ -217,7 +218,7 @@ server.tool(
       const text = await triggerPlatformHelperTool.execute(client, input as any);
       return { content: [{ type: 'text' as const, text }] };
     } catch (err: any) {
-      return { content: [{ type: 'text' as const, text: `Error: ${err.message}` }], isError: true };
+      return { content: [{ type: 'text' as const, text: mdError(err.message) }], isError: true };
     }
   }
 );
@@ -231,7 +232,7 @@ server.tool(
       const text = await listBrandsTool.execute(client, input as any);
       return { content: [{ type: 'text' as const, text }] };
     } catch (err: any) {
-      return { content: [{ type: 'text' as const, text: `Error: ${err.message}` }], isError: true };
+      return { content: [{ type: 'text' as const, text: mdError(err.message) }], isError: true };
     }
   }
 );
@@ -245,7 +246,7 @@ server.tool(
       const text = await getBrandTool.execute(client, input as any);
       return { content: [{ type: 'text' as const, text }] };
     } catch (err: any) {
-      return { content: [{ type: 'text' as const, text: `Error: ${err.message}` }], isError: true };
+      return { content: [{ type: 'text' as const, text: mdError(err.message) }], isError: true };
     }
   }
 );
@@ -259,7 +260,7 @@ server.tool(
       const text = await listBrandAccountsTool.execute(client, input as any);
       return { content: [{ type: 'text' as const, text }] };
     } catch (err: any) {
-      return { content: [{ type: 'text' as const, text: `Error: ${err.message}` }], isError: true };
+      return { content: [{ type: 'text' as const, text: mdError(err.message) }], isError: true };
     }
   }
 );
@@ -273,7 +274,7 @@ server.tool(
       const text = await getBrandProfileTool.execute(client, input as any);
       return { content: [{ type: 'text' as const, text }] };
     } catch (err: any) {
-      return { content: [{ type: 'text' as const, text: `Error: ${err.message}` }], isError: true };
+      return { content: [{ type: 'text' as const, text: mdError(err.message) }], isError: true };
     }
   }
 );
@@ -287,7 +288,7 @@ server.tool(
       const text = await createPostTool.execute(client, input as any);
       return { content: [{ type: 'text' as const, text }] };
     } catch (err: any) {
-      return { content: [{ type: 'text' as const, text: `Error: ${err.message}` }], isError: true };
+      return { content: [{ type: 'text' as const, text: mdError(err.message) }], isError: true };
     }
   }
 );
@@ -301,7 +302,7 @@ server.tool(
       const text = await createPostsBatchTool.execute(client, input as any);
       return { content: [{ type: 'text' as const, text }] };
     } catch (err: any) {
-      return { content: [{ type: 'text' as const, text: `Error: ${err.message}` }], isError: true };
+      return { content: [{ type: 'text' as const, text: mdError(err.message) }], isError: true };
     }
   }
 );
@@ -315,7 +316,7 @@ server.tool(
       const text = await findSlotTool.execute(client, input as any);
       return { content: [{ type: 'text' as const, text }] };
     } catch (err: any) {
-      return { content: [{ type: 'text' as const, text: `Error: ${err.message}` }], isError: true };
+      return { content: [{ type: 'text' as const, text: mdError(err.message) }], isError: true };
     }
   }
 );
@@ -329,7 +330,7 @@ server.tool(
       const text = await listPostsTool.execute(client, input as any);
       return { content: [{ type: 'text' as const, text }] };
     } catch (err: any) {
-      return { content: [{ type: 'text' as const, text: `Error: ${err.message}` }], isError: true };
+      return { content: [{ type: 'text' as const, text: mdError(err.message) }], isError: true };
     }
   }
 );
@@ -343,7 +344,7 @@ server.tool(
       const text = await uploadMediaTool.execute(client, input as any);
       return { content: [{ type: 'text' as const, text }] };
     } catch (err: any) {
-      return { content: [{ type: 'text' as const, text: `Error: ${err.message}` }], isError: true };
+      return { content: [{ type: 'text' as const, text: mdError(err.message) }], isError: true };
     }
   }
 );
@@ -357,7 +358,7 @@ server.tool(
       const text = await uploadMediaFromUrlTool.execute(client, input as any);
       return { content: [{ type: 'text' as const, text }] };
     } catch (err: any) {
-      return { content: [{ type: 'text' as const, text: `Error: ${err.message}` }], isError: true };
+      return { content: [{ type: 'text' as const, text: mdError(err.message) }], isError: true };
     }
   }
 );
@@ -371,7 +372,7 @@ server.tool(
       const text = await createSignedUploadTool.execute(client, input as any);
       return { content: [{ type: 'text' as const, text }] };
     } catch (err: any) {
-      return { content: [{ type: 'text' as const, text: `Error: ${err.message}` }], isError: true };
+      return { content: [{ type: 'text' as const, text: mdError(err.message) }], isError: true };
     }
   }
 );
@@ -385,7 +386,7 @@ server.tool(
       const text = await getVideoOptionsTool.execute(client);
       return { content: [{ type: 'text' as const, text }] };
     } catch (err: any) {
-      return { content: [{ type: 'text' as const, text: `Error: ${err.message}` }], isError: true };
+      return { content: [{ type: 'text' as const, text: mdError(err.message) }], isError: true };
     }
   }
 );
@@ -399,7 +400,7 @@ server.tool(
       const text = await runVideoFunctionTool.execute(client, input as any);
       return { content: [{ type: 'text' as const, text }] };
     } catch (err: any) {
-      return { content: [{ type: 'text' as const, text: `Error: ${err.message}` }], isError: true };
+      return { content: [{ type: 'text' as const, text: mdError(err.message) }], isError: true };
     }
   }
 );
@@ -413,7 +414,7 @@ server.tool(
       const text = await generateVideoTool.execute(client, input as any);
       return { content: [{ type: 'text' as const, text }] };
     } catch (err: any) {
-      return { content: [{ type: 'text' as const, text: `Error: ${err.message}` }], isError: true };
+      return { content: [{ type: 'text' as const, text: mdError(err.message) }], isError: true };
     }
   }
 );
@@ -427,7 +428,7 @@ server.tool(
       const text = await getVideoJobTool.execute(client, input as any);
       return { content: [{ type: 'text' as const, text }] };
     } catch (err: any) {
-      return { content: [{ type: 'text' as const, text: `Error: ${err.message}` }], isError: true };
+      return { content: [{ type: 'text' as const, text: mdError(err.message) }], isError: true };
     }
   }
 );
@@ -441,7 +442,7 @@ server.tool(
       const text = await generateImageTool.execute(client, input as any);
       return { content: [{ type: 'text' as const, text }] };
     } catch (err: any) {
-      return { content: [{ type: 'text' as const, text: `Error: ${err.message}` }], isError: true };
+      return { content: [{ type: 'text' as const, text: mdError(err.message) }], isError: true };
     }
   }
 );
@@ -455,7 +456,7 @@ server.tool(
       const text = await getPostTool.execute(client, input as any);
       return { content: [{ type: 'text' as const, text }] };
     } catch (err: any) {
-      return { content: [{ type: 'text' as const, text: `Error: ${err.message}` }], isError: true };
+      return { content: [{ type: 'text' as const, text: mdError(err.message) }], isError: true };
     }
   }
 );
@@ -469,7 +470,7 @@ server.tool(
       const text = await getPostMissingTool.execute(client, input as any);
       return { content: [{ type: 'text' as const, text }] };
     } catch (err: any) {
-      return { content: [{ type: 'text' as const, text: `Error: ${err.message}` }], isError: true };
+      return { content: [{ type: 'text' as const, text: mdError(err.message) }], isError: true };
     }
   }
 );
@@ -483,7 +484,7 @@ server.tool(
       const text = await updatePostTool.execute(client, input as any);
       return { content: [{ type: 'text' as const, text }] };
     } catch (err: any) {
-      return { content: [{ type: 'text' as const, text: `Error: ${err.message}` }], isError: true };
+      return { content: [{ type: 'text' as const, text: mdError(err.message) }], isError: true };
     }
   }
 );
@@ -497,7 +498,7 @@ server.tool(
       const text = await updatePostStatusTool.execute(client, input as any);
       return { content: [{ type: 'text' as const, text }] };
     } catch (err: any) {
-      return { content: [{ type: 'text' as const, text: `Error: ${err.message}` }], isError: true };
+      return { content: [{ type: 'text' as const, text: mdError(err.message) }], isError: true };
     }
   }
 );
@@ -511,7 +512,7 @@ server.tool(
       const text = await updatePostReleaseIdTool.execute(client, input as any);
       return { content: [{ type: 'text' as const, text }] };
     } catch (err: any) {
-      return { content: [{ type: 'text' as const, text: `Error: ${err.message}` }], isError: true };
+      return { content: [{ type: 'text' as const, text: mdError(err.message) }], isError: true };
     }
   }
 );
@@ -525,7 +526,7 @@ server.tool(
       const text = await deletePostTool.execute(client, input as any);
       return { content: [{ type: 'text' as const, text }] };
     } catch (err: any) {
-      return { content: [{ type: 'text' as const, text: `Error: ${err.message}` }], isError: true };
+      return { content: [{ type: 'text' as const, text: mdError(err.message) }], isError: true };
     }
   }
 );
@@ -539,7 +540,7 @@ server.tool(
       const text = await deletePostGroupTool.execute(client, input as any);
       return { content: [{ type: 'text' as const, text }] };
     } catch (err: any) {
-      return { content: [{ type: 'text' as const, text: `Error: ${err.message}` }], isError: true };
+      return { content: [{ type: 'text' as const, text: mdError(err.message) }], isError: true };
     }
   }
 );
@@ -553,7 +554,7 @@ server.tool(
       const text = await getAccountAnalyticsTool.execute(client, input as any);
       return { content: [{ type: 'text' as const, text }] };
     } catch (err: any) {
-      return { content: [{ type: 'text' as const, text: `Error: ${err.message}` }], isError: true };
+      return { content: [{ type: 'text' as const, text: mdError(err.message) }], isError: true };
     }
   }
 );
@@ -567,7 +568,7 @@ server.tool(
       const text = await getPostAnalyticsTool.execute(client, input as any);
       return { content: [{ type: 'text' as const, text }] };
     } catch (err: any) {
-      return { content: [{ type: 'text' as const, text: `Error: ${err.message}` }], isError: true };
+      return { content: [{ type: 'text' as const, text: mdError(err.message) }], isError: true };
     }
   }
 );
@@ -581,7 +582,7 @@ server.tool(
       const text = await listGoogleBusinessReviewsTool.execute(client, input as any);
       return { content: [{ type: 'text' as const, text }] };
     } catch (err: any) {
-      return { content: [{ type: 'text' as const, text: `Error: ${err.message}` }], isError: true };
+      return { content: [{ type: 'text' as const, text: mdError(err.message) }], isError: true };
     }
   }
 );
@@ -595,7 +596,7 @@ server.tool(
       const text = await getGoogleBusinessReviewLinkTool.execute(client, input as any);
       return { content: [{ type: 'text' as const, text }] };
     } catch (err: any) {
-      return { content: [{ type: 'text' as const, text: `Error: ${err.message}` }], isError: true };
+      return { content: [{ type: 'text' as const, text: mdError(err.message) }], isError: true };
     }
   }
 );
@@ -609,7 +610,7 @@ server.tool(
       const text = await auditGoogleBusinessProfileTool.execute(client, input as any);
       return { content: [{ type: 'text' as const, text }] };
     } catch (err: any) {
-      return { content: [{ type: 'text' as const, text: `Error: ${err.message}` }], isError: true };
+      return { content: [{ type: 'text' as const, text: mdError(err.message) }], isError: true };
     }
   }
 );
@@ -623,7 +624,7 @@ server.tool(
       const text = await suggestGoogleBusinessReviewReplyTool.execute(client, input as any);
       return { content: [{ type: 'text' as const, text }] };
     } catch (err: any) {
-      return { content: [{ type: 'text' as const, text: `Error: ${err.message}` }], isError: true };
+      return { content: [{ type: 'text' as const, text: mdError(err.message) }], isError: true };
     }
   }
 );
@@ -637,7 +638,7 @@ server.tool(
       const text = await replyGoogleBusinessReviewTool.execute(client, input as any);
       return { content: [{ type: 'text' as const, text }] };
     } catch (err: any) {
-      return { content: [{ type: 'text' as const, text: `Error: ${err.message}` }], isError: true };
+      return { content: [{ type: 'text' as const, text: mdError(err.message) }], isError: true };
     }
   }
 );
@@ -651,7 +652,7 @@ server.tool(
       const text = await deleteGoogleBusinessReviewReplyTool.execute(client, input as any);
       return { content: [{ type: 'text' as const, text }] };
     } catch (err: any) {
-      return { content: [{ type: 'text' as const, text: `Error: ${err.message}` }], isError: true };
+      return { content: [{ type: 'text' as const, text: mdError(err.message) }], isError: true };
     }
   }
 );
@@ -665,7 +666,7 @@ server.tool(
       const text = await listActivityTool.execute(client, input as any);
       return { content: [{ type: 'text' as const, text }] };
     } catch (err: any) {
-      return { content: [{ type: 'text' as const, text: `Error: ${err.message}` }], isError: true };
+      return { content: [{ type: 'text' as const, text: mdError(err.message) }], isError: true };
     }
   }
 );
@@ -679,7 +680,7 @@ server.tool(
       const text = await listWebhooksTool.execute(client, input as any);
       return { content: [{ type: 'text' as const, text }] };
     } catch (err: any) {
-      return { content: [{ type: 'text' as const, text: `Error: ${err.message}` }], isError: true };
+      return { content: [{ type: 'text' as const, text: mdError(err.message) }], isError: true };
     }
   }
 );
@@ -693,7 +694,7 @@ server.tool(
       const text = await createWebhookTool.execute(client, input as any);
       return { content: [{ type: 'text' as const, text }] };
     } catch (err: any) {
-      return { content: [{ type: 'text' as const, text: `Error: ${err.message}` }], isError: true };
+      return { content: [{ type: 'text' as const, text: mdError(err.message) }], isError: true };
     }
   }
 );
@@ -707,7 +708,7 @@ server.tool(
       const text = await updateWebhookTool.execute(client, input as any);
       return { content: [{ type: 'text' as const, text }] };
     } catch (err: any) {
-      return { content: [{ type: 'text' as const, text: `Error: ${err.message}` }], isError: true };
+      return { content: [{ type: 'text' as const, text: mdError(err.message) }], isError: true };
     }
   }
 );
@@ -721,7 +722,7 @@ server.tool(
       const text = await deleteWebhookTool.execute(client, input as any);
       return { content: [{ type: 'text' as const, text }] };
     } catch (err: any) {
-      return { content: [{ type: 'text' as const, text: `Error: ${err.message}` }], isError: true };
+      return { content: [{ type: 'text' as const, text: mdError(err.message) }], isError: true };
     }
   }
 );
@@ -735,7 +736,7 @@ server.tool(
       const text = await testWebhookTool.execute(client, input as any);
       return { content: [{ type: 'text' as const, text }] };
     } catch (err: any) {
-      return { content: [{ type: 'text' as const, text: `Error: ${err.message}` }], isError: true };
+      return { content: [{ type: 'text' as const, text: mdError(err.message) }], isError: true };
     }
   }
 );
@@ -749,7 +750,7 @@ server.tool(
       const text = await getXPostingQuotaTool.execute(client, input as any);
       return { content: [{ type: 'text' as const, text }] };
     } catch (err: any) {
-      return { content: [{ type: 'text' as const, text: `Error: ${err.message}` }], isError: true };
+      return { content: [{ type: 'text' as const, text: mdError(err.message) }], isError: true };
     }
   }
 );

package/src/lib/api-client.ts

@@ -895,7 +895,7 @@ export class PosterlyClient {
     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,

package/src/lib/format.ts

@@ -0,0 +1,132 @@
+type CellValue = string | number | boolean | null | undefined;
+
+export function mdTitle(title: string, subtitle?: string): string {
+  return [`## ${title}`, subtitle ? `_${subtitle}_` : ''].filter(Boolean).join('\n');
+}
+
+export function mdTable(headers: string[], rows: CellValue[][]): string {
+  const visibleRows = rows.filter((row) => row.some((cell) => cell !== undefined && cell !== null && cell !== ''));
+  if (visibleRows.length === 0) return '';
+
+  const header = `| ${headers.map(escapeCell).join(' | ')} |`;
+  const divider = `| ${headers.map(() => '---').join(' | ')} |`;
+  const body = visibleRows.map((row) => `| ${row.map((cell) => escapeCell(formatCell(cell))).join(' | ')} |`);
+
+  return [header, divider, ...body].join('\n');
+}
+
+export function mdKeyValue(rows: Array<[string, CellValue]>): string {
+  return mdTable(['Field', 'Value'], rows);
+}
+
+export function mdSection(title: string, body?: string): string {
+  if (!body) return '';
+  return [`### ${title}`, body].join('\n');
+}
+
+export function mdBullets(items: Array<string | null | undefined>): string {
+  return items.filter(Boolean).map((item) => `- ${item}`).join('\n');
+}
+
+export function mdJson(title: string, value: unknown): string {
+  return [`### ${title}`, '```json', JSON.stringify(value, null, 2), '```'].join('\n');
+}
+
+export function mdQuote(text: string): string {
+  return text.split('\n').map((line) => `> ${line}`).join('\n');
+}
+
+export function mdEmpty(title: string, detail: string, nextStep?: string): string {
+  return [
+    mdTitle(`No ${title}`),
+    detail,
+    nextStep ? `\n**Next step:** ${nextStep}` : '',
+  ].filter(Boolean).join('\n');
+}
+
+export function mdSuccess(title: string, rows: Array<[string, CellValue]>, nextStep?: string): string {
+  return [
+    mdTitle(`✅ ${title}`),
+    mdKeyValue(rows),
+    nextStep ? `\n**Next step:** ${nextStep}` : '',
+  ].filter(Boolean).join('\n');
+}
+
+export function mdError(message: string): string {
+  return [
+    mdTitle('⚠️ Posterly tool error'),
+    `**Message:** ${message}`,
+  ].join('\n');
+}
+
+export function formatNumber(value: number | null | undefined): string {
+  return value == null ? 'n/a' : value.toLocaleString();
+}
+
+export function formatPercent(value: number | null | undefined): string {
+  return value == null ? 'n/a' : `${value.toLocaleString()}%`;
+}
+
+export function formatDelta(value: number | null | undefined): string {
+  if (value == null) return 'n/a';
+  return value >= 0 ? `+${value.toLocaleString()}` : value.toLocaleString();
+}
+
+export function formatDateTime(value: string | null | undefined): string {
+  if (!value) return 'n/a';
+  const date = new Date(value);
+  if (Number.isNaN(date.getTime())) return value;
+  return date.toLocaleString();
+}
+
+export function formatDate(value: string | null | undefined): string {
+  if (!value) return 'n/a';
+  const date = new Date(value);
+  if (Number.isNaN(date.getTime())) return value;
+  return date.toLocaleDateString('en-US', { weekday: 'short', month: 'short', day: 'numeric', year: 'numeric' });
+}
+
+export function formatBytes(value: number | null | undefined): string {
+  if (value == null) return 'n/a';
+  if (value < 1024) return `${value} B`;
+  const units = ['KB', 'MB', 'GB', 'TB'];
+  let size = value / 1024;
+  let unitIndex = 0;
+  while (size >= 1024 && unitIndex < units.length - 1) {
+    size /= 1024;
+    unitIndex += 1;
+  }
+  return `${size.toFixed(size >= 10 ? 0 : 1)} ${units[unitIndex]}`;
+}
+
+export function compactText(value: string | null | undefined, maxLength = 90): string {
+  const text = String(value || '').replace(/\s+/g, ' ').trim();
+  if (!text) return '';
+  return text.length > maxLength ? `${text.slice(0, Math.max(0, maxLength - 1))}…` : text;
+}
+
+export function statusLabel(status: string | null | undefined): string {
+  const value = String(status || 'unknown').toLowerCase();
+  if (['created', 'success', 'succeeded', 'completed', 'published', 'active'].includes(value)) return `✅ ${status}`;
+  if (['scheduled', 'queued', 'pending', 'processing'].includes(value)) return `🕒 ${status}`;
+  if (['failed', 'error', 'inactive', 'deleted'].includes(value)) return `⚠️ ${status}`;
+  if (['draft', 'paused'].includes(value)) return `⏸️ ${status}`;
+  return status || 'unknown';
+}
+
+export function code(value: CellValue): string {
+  return `\`${formatCell(value).replace(/`/g, '\\`')}\``;
+}
+
+function formatCell(value: CellValue): string {
+  if (value === null || value === undefined || value === '') return 'n/a';
+  if (typeof value === 'boolean') return value ? 'yes' : 'no';
+  if (typeof value === 'number') return value.toLocaleString();
+  return String(value);
+}
+
+function escapeCell(value: CellValue): string {
+  return formatCell(value)
+    .replace(/\|/g, '\\|')
+    .replace(/\r?\n/g, '<br>');
+}

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

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import type { PosterlyClient } from '../lib/api-client.js';
+import { formatDateTime, mdKeyValue, mdSection, mdTable, mdTitle } from '../lib/format.js';
 
 export const auditGoogleBusinessProfileTool = {
   name: 'audit_google_business_profile',
@@ -22,17 +23,22 @@ 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 [
+      mdTitle(`Google Business audit: ${audit.businessName || 'Unknown business'}`),
+      mdKeyValue([
+        ['Score', audit.overallScore ?? 'n/a'],
+        ['Grade', audit.overallGrade || 'n/a'],
+        ['Fetched', formatDateTime(result.fetchedAt)],
+      ]),
+      recommendations.length > 0
+        ? mdSection('Top recommendations', mdTable(
+          ['Priority', 'Recommendation'],
+          recommendations.slice(0, 5).map((rec: any) => [
+            rec.priority || 'medium',
+            rec.description || rec.title || 'Recommendation',
+          ]),
+        ))
+        : '',
+    ].filter(Boolean).join('\n\n');
   },
 };

package/src/tools/create-oauth-client.ts

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import type { PosterlyClient } from '../lib/api-client.js';
+import { code, mdSuccess } from '../lib/format.js';
 
 const scopeSchema = z.enum(['accounts:read', 'accounts:write', 'posts:read', 'posts:write', 'media:write', 'analytics:read']);
 
@@ -28,9 +29,14 @@ export const createOAuthClientTool = {
       is_active?: boolean;
       confirm: true;
     },
-  ) {
+    ) {
     const { confirm: _confirm, ...payload } = input;
     const result = await client.createOAuthClient(payload);
-    return `OAuth client created: ${result.client.client_name}\nclient_id: ${result.client.client_id}\nRedirect URIs: ${result.client.allowed_redirect_uris.join(', ')}`;
+    return mdSuccess('OAuth client created', [
+      ['Client', result.client.client_name],
+      ['Client ID', code(result.client.client_id)],
+      ['Redirect URIs', result.client.allowed_redirect_uris.join(', ')],
+      ['Default scopes', result.client.default_scopes.join(', ')],
+    ]);
   },
 };