posterly-mcp-server 0.19.1 → 0.19.2

package/src/tools/get-brand.ts

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import type { PosterlyClient } from '../lib/api-client.js';
+import { code, formatDateTime, mdKeyValue, mdTitle } from '../lib/format.js';
 
 export const getBrandTool = {
   name: 'get_brand',
@@ -16,19 +17,18 @@ export const getBrandTool = {
     const result = await client.getBrand(input.brand_id);
     const brand = result.brand as Record<string, any>;
 
-    const lines = [
-      `Brand: ${brand.name}`,
-      `• ID: ${brand.id}`,
-      `• Source: ${brand.source}`,
-      `• Workspace: ${brand.workspace_id || 'N/A'}`,
-      `• Accounts assigned: ${brand.account_count ?? 0}`,
-    ];
-
-    if (brand.workspace_client_id) lines.push(`• Workspace client ID: ${brand.workspace_client_id}`);
-    if (brand.legacy_brand_group_id) lines.push(`• Legacy brand group ID: ${brand.legacy_brand_group_id}`);
-    if (brand.created_at) lines.push(`• Created: ${brand.created_at}`);
-    if (brand.updated_at) lines.push(`• Updated: ${brand.updated_at}`);
-
-    return lines.join('\n');
+    return [
+      mdTitle(`Brand: ${brand.name}`),
+      mdKeyValue([
+        ['Brand ID', code(brand.id)],
+        ['Source', brand.source],
+        ['Workspace', brand.workspace_id ? code(brand.workspace_id) : 'n/a'],
+        ['Accounts assigned', brand.account_count ?? 0],
+        ['Workspace client ID', brand.workspace_client_id ? code(brand.workspace_client_id) : undefined],
+        ['Legacy brand group ID', brand.legacy_brand_group_id ? code(brand.legacy_brand_group_id) : undefined],
+        ['Created', formatDateTime(brand.created_at)],
+        ['Updated', formatDateTime(brand.updated_at)],
+      ]),
+    ].join('\n\n');
   },
 };

package/src/tools/get-connect-link.ts

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 import type { ConnectOption, PosterlyClient } from '../lib/api-client.js';
 import { CONNECT_INPUTS, PLANNED_PLATFORM_IDS } from '../generated/platform-manifest.js';
+import { code, mdJson, mdKeyValue, mdSection, mdTable, mdTitle, statusLabel } from '../lib/format.js';
 
 export const getConnectLinkTool = {
   name: 'get_connect_link',
@@ -31,8 +32,21 @@ export const getConnectLinkTool = {
     }
 
     const options = result.connect_options || [];
-    const lines = options.map((option) => formatConnectOption(option, false));
-    return `Posterly connection options (${options.length}):\n${lines.join('\n\n')}`;
+    return [
+      mdTitle(`Posterly connection options (${options.length})`),
+      mdTable(
+        ['Provider', 'Target', 'Status', 'Method', 'Connected', 'Readiness'],
+        options.map((option) => [
+          option.label,
+          code(option.platform),
+          statusLabel(option.status),
+          option.method,
+          option.connected_count ?? option.connected_accounts?.length ?? 0,
+          option.missing_env?.length ? 'missing config' : 'configured',
+        ]),
+      ),
+      '**Tip:** Call this tool with a specific `platform` to get the direct dashboard handoff URL.',
+    ].join('\n\n');
   },
 };
 
@@ -45,12 +59,20 @@ function formatConnectOption(option: ConnectOption, includeRaw: boolean): string
     ? `; credential fields: ${option.credential_fields.map((field: any) => field.key).join(', ')}`
     : '';
   const scopes = option.scopes?.length ? `; scopes: ${option.scopes.join(', ')}` : '';
-  const raw = includeRaw ? `\n\nRaw connect option:\n${JSON.stringify(option, null, 2)}` : '';
+  const raw = includeRaw ? mdJson('Raw connect option', option) : '';
 
   return [
-    `${option.label} (${option.platform})`,
-    `Status: ${option.status}; method: ${option.method}; ${missing}; connected accounts: ${accounts}`,
-    `Connection URL: ${option.connection_url || 'not available'}${fields}${scopes}`,
+    mdTitle(`${option.label} connection`, code(option.platform)),
+    mdKeyValue([
+      ['Status', statusLabel(option.status)],
+      ['Method', option.method],
+      ['Readiness', missing],
+      ['Connected accounts', accounts],
+      ['Connection URL', option.connection_url || 'not available'],
+      ['Credential fields', fields.replace(/^; credential fields: /, '') || undefined],
+      ['Scopes', scopes.replace(/^; scopes: /, '') || undefined],
+    ]),
+    option.notes?.length ? mdSection('Notes', option.notes.map((note) => `- ${note}`).join('\n')) : '',
     raw,
-  ].join('\n');
+  ].filter(Boolean).join('\n\n');
 }

package/src/tools/get-google-business-review-link.ts

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import type { PosterlyClient } from '../lib/api-client.js';
+import { code, mdSuccess } from '../lib/format.js';
 
 export const getGoogleBusinessReviewLinkTool = {
   name: 'get_google_business_review_link',
@@ -20,11 +21,10 @@ export const getGoogleBusinessReviewLinkTool = {
     },
   ) {
     const result = await client.getGoogleBusinessReviewLink(input);
-    return [
-      `Review link for ${result.businessName}:`,
-      result.reviewLink,
-      `Place ID: ${result.placeId}`,
-      `Account ID: ${result.account_id}`,
-    ].join('\n');
+    return mdSuccess(`Review link for ${result.businessName}`, [
+      ['Review link', result.reviewLink],
+      ['Place ID', code(result.placeId)],
+      ['Account ID', code(result.account_id)],
+    ]);
   },
 };

package/src/tools/get-platform-schema.ts

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 import type { PosterlyClient } from '../lib/api-client.js';
 import { ALL_PLATFORM_INPUTS, SUPPORTED_PLATFORM_IDS } from '../generated/platform-manifest.js';
+import { code, mdJson, mdKeyValue, mdSection, mdTable, mdTitle, statusLabel } from '../lib/format.js';
 
 export const getPlatformSchemaTool = {
   name: 'get_platform_schema',
@@ -24,29 +25,41 @@ export const getPlatformSchemaTool = {
   ) {
     const result = await client.getPlatformSchema(input);
     const schema = result.schema || result.platform || result.platforms?.[0];
-    if (!schema) return JSON.stringify(result, null, 2);
+    if (!schema) return mdJson('Platform schema response', result);
 
     const fields = schema.settings_schema?.fields || [];
     const helpers = schema.helper_tools || [];
-    const accountLine = result.account
-      ? `Account: ${(result.account.username as string) || result.account.id} (${result.account.platform})\n`
-      : '';
 
     return [
-      `${schema.label} (${schema.id}) schema`,
-      accountLine.trim(),
-      `Status: ${schema.status}`,
-      `Post types: ${schema.post_types.join(', ') || 'n/a'}`,
-      `Content limit: ${schema.content_limit ?? 'n/a'}`,
-      `Media: ${JSON.stringify(schema.media)}`,
-      `Analytics: ${schema.analytics_supported ? 'yes' : 'no'}`,
+      mdTitle(`${schema.label} schema`, code(schema.id)),
+      mdKeyValue([
+        ['Account', result.account ? `${(result.account.username as string) || result.account.id} (${result.account.platform})` : undefined],
+        ['Status', statusLabel(schema.status)],
+        ['Post types', schema.post_types.join(', ') || 'n/a'],
+        ['Content limit', schema.content_limit ?? 'n/a'],
+        ['Analytics', schema.analytics_supported],
+      ]),
       fields.length
-        ? `Settings:\n${fields.map((field: any) => `• ${field.key}${field.required ? ' (required)' : ''}: ${field.description}`).join('\n')}`
-        : 'Settings: none',
+        ? mdSection('Settings', mdTable(
+          ['Field', 'Required', 'Description'],
+          fields.map((field: any) => [
+            code(field.key),
+            Boolean(field.required),
+            field.description || field.label || 'n/a',
+          ]),
+        ))
+        : mdSection('Settings', 'None'),
       helpers.length
-        ? `Helpers:\n${helpers.map((helper: any) => `• ${helper.name}: ${helper.description}`).join('\n')}`
-        : 'Helpers: none',
-      `Example settings: ${JSON.stringify(schema.settings_schema?.example || {})}`,
+        ? mdSection('Helpers', mdTable(
+          ['Helper', 'Description'],
+          helpers.map((helper: any) => [
+            code(helper.name),
+            helper.description || 'n/a',
+          ]),
+        ))
+        : mdSection('Helpers', 'None'),
+      mdJson('Media rules', schema.media),
+      mdJson('Example settings', schema.settings_schema?.example || {}),
     ].filter(Boolean).join('\n');
   },
 };

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

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import type { PosterlyClient } from '../lib/api-client.js';
+import { code, compactText, formatDateTime, formatNumber, mdEmpty, mdSection, mdTable, mdTitle } from '../lib/format.js';
 
 export const getPostAnalyticsTool = {
   name: 'get_post_analytics',
@@ -40,59 +41,65 @@ export const getPostAnalyticsTool = {
     const { account, range, posts, total } = result;
 
     if (posts.length === 0) {
-      return `No analytics found for @${account.username} (${account.platform}) between ${range.from} and ${range.to}.`;
+      return mdEmpty('post analytics', `No post analytics were found for @${account.username} (${account.platform}) between ${range.from} and ${range.to}.`);
     }
 
-    const lines: string[] = [
-      `Post analytics for @${account.username} (${account.platform})`,
-      `Range: ${range.from} → ${range.to}  •  Showing ${posts.length} of ${total}`,
-      '',
-    ];
+    const totals = posts.reduce(
+      (acc, post) => ({
+        likes: acc.likes + post.likes,
+        comments: acc.comments + post.comments,
+        reach: acc.reach + post.reach,
+        impressions: acc.impressions + post.impressions,
+        shares: acc.shares + post.shares,
+        saves: acc.saves + post.saved,
+      }),
+      { likes: 0, comments: 0, reach: 0, impressions: 0, shares: 0, saves: 0 },
+    );
 
-    for (const p of posts) {
-      const postedAt = p.posted_at
-        ? new Date(p.posted_at).toLocaleString()
-        : 'unknown date';
-      const caption = p.caption_snippet
-        ? p.caption_snippet.length > 60
-          ? `${p.caption_snippet.slice(0, 60)}…`
-          : p.caption_snippet
-        : '(no caption)';
-      const metrics = [
-        `${p.likes} likes`,
-        `${p.comments} comments`,
-        `${p.reach.toLocaleString()} reach`,
-      ];
-      if (p.impressions) metrics.push(`${p.impressions.toLocaleString()} impressions`);
-      if (p.saved) metrics.push(`${p.saved} saved`);
-      if (p.shares) metrics.push(`${p.shares} shares`);
-      if (p.plays) metrics.push(`${p.plays.toLocaleString()} plays`);
-      if (account.platform === 'youtube' && p.total_watch_time_ms) {
-        metrics.push(`${Math.round(p.total_watch_time_ms / 60000).toLocaleString()} watch minutes`);
-      }
-      if (account.platform === 'youtube' && p.avg_watch_time_ms) {
-        metrics.push(`${Math.round(p.avg_watch_time_ms / 1000)}s avg view`);
-      }
-      if (p.url_link_clicks) {
-        metrics.push(
-          account.platform === 'pinterest'
-            ? `${p.url_link_clicks.toLocaleString()} outbound clicks`
-            : `${p.url_link_clicks.toLocaleString()} link clicks`
-        );
-      }
-      if (p.user_profile_clicks) {
-        metrics.push(
-          account.platform === 'pinterest'
-            ? `${p.user_profile_clicks.toLocaleString()} pin clicks`
-            : `${p.user_profile_clicks.toLocaleString()} profile clicks`
-        );
-      }
-
-      lines.push(`• [${postedAt}] ${caption}`);
-      lines.push(`  ${metrics.join(' • ')}`);
-      if (p.permalink) lines.push(`  ${p.permalink}`);
-    }
-
-    return lines.join('\n');
+    return [
+      mdTitle(`📈 Post analytics for @${account.username}`, `${account.platform} · ${range.from} → ${range.to} · showing ${posts.length} of ${total}`),
+      mdSection('Returned totals', mdTable(
+        ['Likes', 'Comments', 'Reach', 'Impressions', 'Shares', 'Saves'],
+        [[totals.likes, totals.comments, totals.reach, totals.impressions, totals.shares, totals.saves]],
+      )),
+      mdSection('Posts', mdTable(
+        ['Posted', 'Post', 'Caption', 'Reach', 'Likes', 'Comments', 'Extras'],
+        posts.map((post) => [
+          formatDateTime(post.posted_at),
+          post.id ? code(post.id) : code(post.platform_media_id),
+          compactText(post.caption_snippet, 70) || '(no caption)',
+          formatNumber(post.reach),
+          formatNumber(post.likes),
+          formatNumber(post.comments),
+          buildExtras(account.platform, post),
+        ]),
+      )),
+    ].join('\n\n');
   },
 };
+
+function buildExtras(platform: string, post: any): string {
+  const metrics: string[] = [];
+  if (post.impressions) metrics.push(`${formatNumber(post.impressions)} impressions`);
+  if (post.saved) metrics.push(`${formatNumber(post.saved)} saved`);
+  if (post.shares) metrics.push(`${formatNumber(post.shares)} shares`);
+  if (post.plays) metrics.push(`${formatNumber(post.plays)} plays`);
+  if (platform === 'youtube' && post.total_watch_time_ms) {
+    metrics.push(`${formatNumber(Math.round(post.total_watch_time_ms / 60000))} watch minutes`);
+  }
+  if (platform === 'youtube' && post.avg_watch_time_ms) {
+    metrics.push(`${formatNumber(Math.round(post.avg_watch_time_ms / 1000))}s avg view`);
+  }
+  if (post.url_link_clicks) {
+    metrics.push(platform === 'pinterest'
+      ? `${formatNumber(post.url_link_clicks)} outbound clicks`
+      : `${formatNumber(post.url_link_clicks)} link clicks`);
+  }
+  if (post.user_profile_clicks) {
+    metrics.push(platform === 'pinterest'
+      ? `${formatNumber(post.user_profile_clicks)} pin clicks`
+      : `${formatNumber(post.user_profile_clicks)} profile clicks`);
+  }
+  if (post.permalink) metrics.push(post.permalink);
+  return metrics.join(' · ') || 'n/a';
+}

package/src/tools/get-post-missing.ts

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import type { PosterlyClient } from '../lib/api-client.js';
+import { code, mdJson, mdTitle } from '../lib/format.js';
 
 export const getPostMissingTool = {
   name: 'get_post_missing',
@@ -11,7 +12,9 @@ export const getPostMissingTool = {
 
   async execute(client: PosterlyClient, input: { post_id: number }) {
     const result = await client.getPostMissing(input.post_id);
-    return JSON.stringify(result, null, 2);
+    return [
+      mdTitle(`Post readiness for ${code(input.post_id)}`),
+      mdJson('Missing fields response', result),
+    ].join('\n\n');
   },
 };
-

package/src/tools/get-post.ts

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import type { PosterlyClient } from '../lib/api-client.js';
+import { code, formatDateTime, mdKeyValue, mdQuote, mdSection, mdTitle, statusLabel } from '../lib/format.js';
 
 export const getPostTool = {
   name: 'get_post',
@@ -16,18 +17,20 @@ export const getPostTool = {
     const result = await client.getPost(input.post_id);
     const p = result.post as Record<string, any>;
 
-    const lines = [
-      `Post #${p.id}`,
-      `• Status: ${p.status}`,
-      `• Caption: ${p.content || '(empty)'}`,
-      `• Type: ${p.post_type || 'unknown'}`,
-      `• Scheduled: ${p.scheduled_at ? new Date(p.scheduled_at).toLocaleString() : 'N/A'}`,
-    ];
-
-    if (p.platform_post_url) lines.push(`• Published URL: ${p.platform_post_url}`);
-    if (p.media_url) lines.push(`• Media: ${p.media_url}`);
-    if (p.media_urls?.length) lines.push(`• Media (${p.media_urls.length}): ${p.media_urls.join(', ')}`);
-
-    return lines.join('\n');
+    return [
+      mdTitle(`Post ${code(p.id)}`),
+      mdKeyValue([
+        ['Status', statusLabel(p.status)],
+        ['Type', p.post_type || 'unknown'],
+        ['Scheduled', formatDateTime(p.scheduled_at)],
+        ['Published URL', p.platform_post_url],
+        ['Media', p.media_url],
+        ['Media count', p.media_urls?.length],
+      ]),
+      mdSection('Caption', p.content ? mdQuote(p.content) : '_(empty)_'),
+      p.media_urls?.length
+        ? mdSection('Media URLs', p.media_urls.map((url: string, index: number) => `${index + 1}. ${url}`).join('\n'))
+        : '',
+    ].filter(Boolean).join('\n\n');
   },
 };

package/src/tools/get-video-job.ts

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import type { PosterlyClient, VideoJob } from '../lib/api-client.js';
+import { code, compactText, formatDateTime, mdJson, mdKeyValue, mdSection, mdTable, mdTitle, statusLabel } from '../lib/format.js';
 
 export const getVideoJobTool = {
   name: 'get_video_job',
@@ -17,20 +18,39 @@ export const getVideoJobTool = {
 
     const jobs = result.jobs || [];
     return [
-      `Video jobs (${jobs.length})`,
-      jobs.map((job) => formatJob(job, false)).join('\n\n'),
+      mdTitle(`Video jobs (${jobs.length})`),
+      mdTable(
+        ['Job ID', 'Status', 'Prompt', 'Model', 'Created', 'Cost'],
+        jobs.map((job) => [
+          code(job.id),
+          statusLabel(job.status),
+          compactText(job.prompt, 70),
+          job.model,
+          formatDateTime(job.created_at),
+          job.credit_cost,
+        ]),
+      ),
     ].filter(Boolean).join('\n');
   },
 };
 
 function formatJob(job: VideoJob, includeRaw: boolean): string {
-  const lines = [
-    `${job.id} — ${job.status}`,
-    `Prompt: ${job.prompt}`,
-    `Model: ${job.model}; duration: ${job.duration_seconds}s; resolution: ${job.resolution || 'n/a'}; cost: ${job.credit_cost}`,
-    job.video_url ? `Video URL: ${job.video_url}` : null,
-    job.error_message ? `Error: ${job.error_message}` : null,
-    includeRaw ? `\nRaw job:\n${JSON.stringify(job, null, 2)}` : null,
-  ];
-  return lines.filter(Boolean).join('\n');
+  return [
+    mdTitle(`Video job ${code(job.id)}`),
+    mdKeyValue([
+      ['Status', statusLabel(job.status)],
+      ['Model', job.model],
+      ['Duration', `${job.duration_seconds}s`],
+      ['Aspect ratio', job.aspect_ratio],
+      ['Resolution', job.resolution || 'n/a'],
+      ['Credit cost', job.credit_cost],
+      ['Created', formatDateTime(job.created_at)],
+      ['Started', formatDateTime(job.started_at)],
+      ['Completed', formatDateTime(job.completed_at)],
+      ['Video URL', job.video_url || undefined],
+      ['Error', job.error_message || undefined],
+    ]),
+    mdSection('Prompt', job.prompt),
+    includeRaw ? mdJson('Raw job', job) : '',
+  ].filter(Boolean).join('\n\n');
 }

package/src/tools/get-video-options.ts

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import type { PosterlyClient } from '../lib/api-client.js';
+import { code, mdJson, mdKeyValue, mdSection, mdTable, mdTitle } from '../lib/format.js';
 
 export const getVideoOptionsTool = {
   name: 'get_video_options',
@@ -11,20 +12,31 @@ export const getVideoOptionsTool = {
     const options = await client.getVideoOptions();
     const models = Array.isArray(options.models) ? options.models : [];
     const inputModes = Array.isArray(options.input_modes) ? options.input_modes : [];
-    const lines = [
-      'Video generation options',
-      `Provider: ${options.provider || 'unknown'}`,
-      `Public generation status: ${options.public_generation_status || 'unknown'}`,
-      '',
-      `Models: ${models.map((model: any) => model.id).filter(Boolean).join(', ') || 'none'}`,
-      `Durations: ${(options.durations_seconds || []).join(', ')} seconds`,
-      `Resolutions: ${(options.resolutions || []).join(', ')}`,
-      `Aspect ratios: ${(options.aspect_ratios || []).join(', ')}`,
-      `Input modes: ${inputModes.map((mode: any) => mode.id).filter(Boolean).join(', ') || 'none'}`,
-      '',
-      'Raw options:',
-      JSON.stringify(options, null, 2),
-    ];
-    return lines.join('\n');
+    return [
+      mdTitle('Video generation options'),
+      mdKeyValue([
+        ['Provider', options.provider || 'unknown'],
+        ['Public generation status', options.public_generation_status || 'unknown'],
+        ['Durations', `${(options.durations_seconds || []).join(', ')} seconds`],
+        ['Resolutions', (options.resolutions || []).join(', ')],
+        ['Aspect ratios', (options.aspect_ratios || []).join(', ')],
+      ]),
+      mdSection('Models', mdTable(
+        ['Model', 'Label', 'Credit cost'],
+        models.map((model: any) => [
+          code(model.id),
+          model.label || model.name || 'n/a',
+          model.credit_cost ?? model.cost ?? 'n/a',
+        ]),
+      )),
+      mdSection('Input modes', mdTable(
+        ['Mode', 'Label'],
+        inputModes.map((mode: any) => [
+          code(mode.id),
+          mode.label || mode.name || 'n/a',
+        ]),
+      )),
+      mdJson('Raw options', options),
+    ].filter(Boolean).join('\n\n');
   },
 };

package/src/tools/get-x-posting-quota.ts

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import type { PosterlyClient } from '../lib/api-client.js';
+import { code, mdKeyValue, mdTitle, statusLabel } from '../lib/format.js';
 
 export const getXPostingQuotaTool = {
   name: 'get_x_posting_quota',
@@ -12,14 +13,16 @@ export const getXPostingQuotaTool = {
   async execute(client: PosterlyClient, input: { workspace_id?: string }) {
     const quota = await client.getXPostingQuota(input);
     return [
-      'X posting quota',
-      `• Workspace: ${quota.workspace_id || 'default'}`,
-      `• Tier: ${quota.tier || 'unknown'}`,
-      `• Total posts: ${quota.total_posts}`,
-      `• Used posts: ${quota.used_posts}`,
-      `• Remaining posts: ${quota.remaining_posts}`,
-      `• URL posting blocked: ${quota.urls_blocked ? 'yes' : 'no'}`,
-      `• Period: ${quota.current_period_start} -> ${quota.current_period_end}`,
-    ].join('\n');
+      mdTitle('X posting quota'),
+      mdKeyValue([
+        ['Workspace', quota.workspace_id ? code(quota.workspace_id) : 'default'],
+        ['Tier', quota.tier || 'unknown'],
+        ['Total posts', quota.total_posts],
+        ['Used posts', quota.used_posts],
+        ['Remaining posts', quota.remaining_posts],
+        ['URL posting', statusLabel(quota.urls_blocked ? 'blocked' : 'available')],
+        ['Period', `${quota.current_period_start} → ${quota.current_period_end}`],
+      ]),
+    ].join('\n\n');
   },
 };

package/src/tools/list-accounts.ts

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import type { PosterlyClient } from '../lib/api-client.js';
+import { code, mdEmpty, mdTable, mdTitle } from '../lib/format.js';
 
 export const listAccountsTool = {
   name: 'list_accounts',
@@ -17,13 +18,21 @@ export const listAccountsTool = {
 
     if (accounts.length === 0) {
       return input.workspace_id
-        ? 'No connected accounts found in this workspace.'
-        : 'No connected accounts found. Connect accounts in the posterly dashboard first.';
+        ? mdEmpty('connected accounts', 'This workspace does not have any social accounts connected yet.')
+        : mdEmpty('connected accounts', 'Posterly does not see any connected social accounts yet.', 'Connect accounts in the Posterly dashboard, then run this again.');
     }
 
-    const lines = accounts.map(
-      (a) => `• ${a.platform} — @${a.username} (ID: ${a.id}${a.workspace_id ? `, ws: ${a.workspace_id}` : ''})`
-    );
-    return `Connected accounts (${accounts.length}):\n${lines.join('\n')}`;
+    return [
+      mdTitle(`Connected accounts (${accounts.length})`),
+      mdTable(
+        ['Platform', 'Account', 'Account ID', 'Workspace'],
+        accounts.map((account) => [
+          account.platform,
+          `@${account.username}`,
+          code(account.id),
+          account.workspace_id ? code(account.workspace_id) : 'default',
+        ]),
+      ),
+    ].join('\n\n');
   },
 };

package/src/tools/list-activity.ts

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import type { PosterlyClient } from '../lib/api-client.js';
+import { compactText, formatDateTime, mdEmpty, mdTable, mdTitle } from '../lib/format.js';
 
 export const listActivityTool = {
   name: 'list_activity',
@@ -25,27 +26,22 @@ export const listActivityTool = {
   ) {
     const result = await client.listActivity(input);
     if (result.items.length === 0) {
-      return 'No activity found matching your filters.';
+      return mdEmpty('activity', 'No activity matched those filters.');
     }
 
-    const lines = [
-      `Activity (${result.items.length} of ${result.total}):`,
-    ];
-
-    for (const item of result.items) {
-      const when = item.created_at ? new Date(item.created_at).toLocaleString() : 'unknown time';
-      if (item.type === 'publish') {
-        const outcome = item.outcome || 'publish';
-        const platform = item.platform ? ` on ${item.platform}` : '';
-        const detail = item.error_message ? ` - ${item.error_message}` : '';
-        lines.push(`- [${when}] post #${item.post_id || '?'} ${outcome}${platform}${detail}`);
-      } else {
-        const label = item.description || item.action || 'activity';
-        lines.push(`- [${when}] post #${item.post_id || '?'} ${label}`);
-      }
-    }
-
-    return lines.join('\n');
+    return [
+      mdTitle(`Activity (${result.items.length} of ${result.total})`),
+      mdTable(
+        ['When', 'Source', 'Post', 'Platform', 'Event', 'Detail'],
+        result.items.map((item) => [
+          formatDateTime(item.created_at),
+          item.type,
+          item.post_id ?? '?',
+          item.platform || 'n/a',
+          item.type === 'publish' ? item.outcome || 'publish' : item.action || 'activity',
+          compactText(item.error_message || item.description, 120) || 'n/a',
+        ]),
+      ),
+    ].join('\n\n');
   },
 };
-

package/src/tools/list-brand-accounts.ts

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import type { PosterlyClient } from '../lib/api-client.js';
+import { code, mdEmpty, mdTable, mdTitle } from '../lib/format.js';
 
 export const listBrandAccountsTool = {
   name: 'list_brand_accounts',
@@ -16,13 +17,20 @@ export const listBrandAccountsTool = {
     const accounts = await client.listBrandAccounts(input.brand_id);
 
     if (accounts.length === 0) {
-      return 'No social accounts are currently assigned to this brand.';
+      return mdEmpty('brand accounts', 'No social accounts are currently assigned to this brand.');
     }
 
-    const lines = accounts.map(
-      (account) => `• ${account.platform} — @${account.username} (ID: ${account.id}${account.workspace_id ? `, ws: ${account.workspace_id}` : ''})`
-    );
-
-    return `Brand accounts (${accounts.length}):\n${lines.join('\n')}`;
+    return [
+      mdTitle(`Brand accounts (${accounts.length})`),
+      mdTable(
+        ['Platform', 'Account', 'Account ID', 'Workspace'],
+        accounts.map((account) => [
+          account.platform,
+          `@${account.username}`,
+          code(account.id),
+          account.workspace_id ? code(account.workspace_id) : 'default',
+        ]),
+      ),
+    ].join('\n\n');
   },
 };