posterly-mcp-server 0.19.1 → 0.19.2

package/dist/tools/get-brand.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { code, formatDateTime, mdKeyValue, mdTitle } from '../lib/format.js';
 export const getBrandTool = {
     name: 'get_brand',
     description: 'Get one brand/client by ID. Returns its workspace, source, linked legacy brand group if present, and the number of social accounts assigned to it.',
@@ -8,21 +9,18 @@ export const getBrandTool = {
     async execute(client, input) {
         const result = await client.getBrand(input.brand_id);
         const brand = result.brand;
-        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/dist/tools/get-connect-link.js

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 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',
     description: 'List dashboard handoff links/readiness for connecting social accounts, or get one platform connection URL. Use connection_url in a logged-in browser. Direct OAuth URLs are intentionally not exposed because provider callbacks rely on browser state.',
@@ -23,8 +24,18 @@ export const getConnectLinkTool = {
             return formatConnectOption(result.connect, true);
         }
         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');
     },
 };
 function formatConnectOption(option, includeRaw) {
@@ -36,11 +47,19 @@ function formatConnectOption(option, includeRaw) {
         ? `; credential fields: ${option.credential_fields.map((field) => 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/dist/tools/get-google-business-review-link.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { code, mdSuccess } from '../lib/format.js';
 export const getGoogleBusinessReviewLinkTool = {
     name: 'get_google_business_review_link',
     description: 'Get the direct public Google review link for a connected Google Business Profile location. Requires account_id or location_id.',
@@ -9,11 +10,10 @@ export const getGoogleBusinessReviewLinkTool = {
     }),
     async execute(client, input) {
         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/dist/tools/get-platform-schema.js

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 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',
     description: 'Get the platform schema for a specific connected account or platform. Call this before creating posts with platform_settings so you know allowed post types, media limits, helper tools, and field names.',
@@ -18,27 +19,33 @@ 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);
+            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 || 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 || 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) => `• ${field.key}${field.required ? ' (required)' : ''}: ${field.description}`).join('\n')}`
-                : 'Settings: none',
+                ? mdSection('Settings', mdTable(['Field', 'Required', 'Description'], fields.map((field) => [
+                    code(field.key),
+                    Boolean(field.required),
+                    field.description || field.label || 'n/a',
+                ])))
+                : mdSection('Settings', 'None'),
             helpers.length
-                ? `Helpers:\n${helpers.map((helper) => `• ${helper.name}: ${helper.description}`).join('\n')}`
-                : 'Helpers: none',
-            `Example settings: ${JSON.stringify(schema.settings_schema?.example || {})}`,
+                ? mdSection('Helpers', mdTable(['Helper', 'Description'], helpers.map((helper) => [
+                    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/dist/tools/get-post-analytics.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { code, compactText, formatDateTime, formatNumber, mdEmpty, mdSection, mdTable, mdTitle } from '../lib/format.js';
 export const getPostAnalyticsTool = {
     name: 'get_post_analytics',
     description: 'Get per-post engagement metrics (likes, comments, reach, impressions, saves, shares, plays, clicks, watch time) for a connected social account. Supports Instagram, Facebook, LinkedIn, Google Business Profile, Pinterest, and YouTube. Returns the most recent posts first.',
@@ -26,56 +27,58 @@ export const getPostAnalyticsTool = {
         const result = await client.getPostAnalytics(input);
         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 = [
-            `Post analytics for @${account.username} (${account.platform})`,
-            `Range: ${range.from} → ${range.to}  •  Showing ${posts.length} of ${total}`,
-            '',
-        ];
-        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');
+        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 });
+        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, post) {
+    const metrics = [];
+    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/dist/tools/get-post-missing.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { code, mdJson, mdTitle } from '../lib/format.js';
 export const getPostMissingTool = {
     name: 'get_post_missing',
     description: 'Inspect whether a post is missing required content, media, account, platform settings, or metadata before it can publish. Use this to repair failed or imported posts.',
@@ -7,6 +8,9 @@ export const getPostMissingTool = {
     }),
     async execute(client, input) {
         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/dist/tools/get-post.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { code, formatDateTime, mdKeyValue, mdQuote, mdSection, mdTitle, statusLabel } from '../lib/format.js';
 export const getPostTool = {
     name: 'get_post',
     description: 'Get details of a specific post by ID. Returns caption, status, scheduled time, media, and platform info.',
@@ -8,19 +9,20 @@ export const getPostTool = {
     async execute(client, input) {
         const result = await client.getPost(input.post_id);
         const p = result.post;
-        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, index) => `${index + 1}. ${url}`).join('\n'))
+                : '',
+        ].filter(Boolean).join('\n\n');
     },
 };

package/dist/tools/get-video-job.d.ts

@@ -8,11 +8,11 @@ export declare const getVideoJobTool: {
         status: z.ZodOptional<z.ZodEnum<["pending", "processing", "completed", "failed", "dismissed"]>>;
         limit: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
     }, "strip", z.ZodTypeAny, {
-        status?: "pending" | "processing" | "completed" | "failed" | "dismissed" | undefined;
+        status?: "completed" | "pending" | "processing" | "failed" | "dismissed" | undefined;
         limit?: number | undefined;
         job_id?: string | undefined;
     }, {
-        status?: "pending" | "processing" | "completed" | "failed" | "dismissed" | undefined;
+        status?: "completed" | "pending" | "processing" | "failed" | "dismissed" | undefined;
         limit?: number | undefined;
         job_id?: string | undefined;
     }>;

package/dist/tools/get-video-job.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { code, compactText, formatDateTime, mdJson, mdKeyValue, mdSection, mdTable, mdTitle, statusLabel } from '../lib/format.js';
 export const getVideoJobTool = {
     name: 'get_video_job',
     description: 'Get one Veo video generation job by ID, or list recent video jobs when job_id is omitted. Use after generate_video to poll for completed video_url.',
@@ -13,19 +14,35 @@ export const getVideoJobTool = {
             return formatJob(result.job, true);
         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, includeRaw) {
-    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/dist/tools/get-video-options.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { code, mdJson, mdKeyValue, mdSection, mdTable, mdTitle } from '../lib/format.js';
 export const getVideoOptionsTool = {
     name: 'get_video_options',
     description: 'List read-only Veo video generation options, input modes, durations, resolutions, aspect ratios, and credit-cost estimates. This does not generate video or spend credits.',
@@ -7,20 +8,25 @@ 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) => 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) => 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) => [
+                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) => [
+                code(mode.id),
+                mode.label || mode.name || 'n/a',
+            ]))),
+            mdJson('Raw options', options),
+        ].filter(Boolean).join('\n\n');
     },
 };

package/dist/tools/get-x-posting-quota.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { code, mdKeyValue, mdTitle, statusLabel } from '../lib/format.js';
 export const getXPostingQuotaTool = {
     name: 'get_x_posting_quota',
     description: 'Get managed X posting quota for a workspace, including total monthly allowance, used posts, remaining posts, and URL-blocking status.',
@@ -8,14 +9,16 @@ export const getXPostingQuotaTool = {
     async execute(client, input) {
         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/dist/tools/list-accounts.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { code, mdEmpty, mdTable, mdTitle } from '../lib/format.js';
 export const listAccountsTool = {
     name: 'list_accounts',
     description: 'List connected social media accounts. Returns platform, username, account ID, and workspace ID for each. Pass workspace_id to filter to a specific workspace; otherwise returns all accounts the caller owns across every workspace.',
@@ -12,10 +13,17 @@ export const listAccountsTool = {
         const accounts = await client.listAccounts({ workspace_id: input.workspace_id });
         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/dist/tools/list-activity.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { compactText, formatDateTime, mdEmpty, mdTable, mdTitle } from '../lib/format.js';
 export const listActivityTool = {
     name: 'list_activity',
     description: 'List recent activity and publish events for posts, including status changes, publish attempts, failures, and retries. Use this as the agent notifications feed.',
@@ -12,24 +13,18 @@ export const listActivityTool = {
     async execute(client, input) {
         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/dist/tools/list-brand-accounts.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { code, mdEmpty, mdTable, mdTitle } from '../lib/format.js';
 export const listBrandAccountsTool = {
     name: 'list_brand_accounts',
     description: 'List the connected social accounts assigned to a brand/client. Use this when a user refers to a brand name rather than a raw account handle.',
@@ -8,9 +9,16 @@ export const listBrandAccountsTool = {
     async execute(client, input) {
         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');
     },
 };