posterly-mcp-server 0.19.2 → 0.19.4

package/dist/tools/create-signed-upload.js

@@ -1,5 +1,4 @@
 import { z } from 'zod';
-import { code, formatBytes, mdSuccess } from '../lib/format.js';
 export const createSignedUploadTool = {
     name: 'create_signed_upload',
     description: 'Create a signed upload URL for a larger image or video. Upload the binary to upload_url; the API validates actual bytes before storage, then public_url can be used with create_post.',
@@ -10,14 +9,12 @@ export const createSignedUploadTool = {
     }),
     async execute(client, input) {
         const signed = await client.getSignedUploadUrl(input.filename, input.content_type, input.size);
-        return mdSuccess('Signed upload created', [
-            ['Filename', input.filename],
-            ['Content type', input.content_type],
-            ['Size', formatBytes(input.size)],
-            ['Upload URL', signed.upload_url],
-            ['Token', code(signed.token)],
-            ['Storage path', signed.path],
-            ['Public URL after upload', signed.public_url],
-        ]);
+        return [
+            'Signed upload created.',
+            `• Upload URL: ${signed.upload_url}`,
+            `• Token: ${signed.token}`,
+            `• Storage path: ${signed.path}`,
+            `• Public URL after upload: ${signed.public_url}`,
+        ].join('\n');
     },
 };

package/dist/tools/create-webhook.js

@@ -1,6 +1,5 @@
 import { z } from 'zod';
 import { webhookEventSchema } from './webhook-events.js';
-import { code, mdSuccess } from '../lib/format.js';
 export const createWebhookTool = {
     name: 'create_webhook',
     description: 'Create a webhook subscription for post/account/analytics events. WRITE WITH OUTBOUND SIDE EFFECTS: show the user the target URL, workspace, events, and active state, then get explicit confirmation before calling. The response includes the signing secret once.',
@@ -15,11 +14,7 @@ export const createWebhookTool = {
     async execute(client, input) {
         const { confirm: _confirm, ...payload } = input;
         const result = await client.createWebhook(payload);
-        return mdSuccess('Webhook created', [
-            ['Webhook ID', code(result.webhook.id)],
-            ['URL', result.webhook.url],
-            ['Events', result.webhook.events.join(', ')],
-            ['Signing secret', result.secret ? code(result.secret) : undefined],
-        ], 'Store the signing secret now; Posterly only returns it once.');
+        const secret = result.secret ? `\nSigning secret: ${result.secret}` : '';
+        return `Webhook created: ${result.webhook.id}\nURL: ${result.webhook.url}\nEvents: ${result.webhook.events.join(', ')}${secret}`;
     },
 };

package/dist/tools/delete-google-business-review-reply.d.ts

@@ -28,5 +28,5 @@ export declare const deleteGoogleBusinessReviewReplyTool: {
         location_id?: string;
         review_name: string;
         confirm: true;
-    }): Promise<string>;
+    }): Promise<any>;
 };

package/dist/tools/delete-google-business-review-reply.js

@@ -1,5 +1,4 @@
 import { z } from 'zod';
-import { mdSuccess } from '../lib/format.js';
 export const deleteGoogleBusinessReviewReplyTool = {
     name: 'delete_google_business_review_reply',
     description: 'Delete the owner reply from a Google Business Profile review. DESTRUCTIVE: confirm the review and location with the user, then pass confirm=true only after explicit confirmation.',
@@ -13,8 +12,6 @@ export const deleteGoogleBusinessReviewReplyTool = {
     async execute(client, input) {
         const { confirm: _confirm, ...payload } = input;
         const result = await client.deleteGoogleBusinessReviewReply(payload);
-        return mdSuccess('Google Business review reply deleted', [
-            ['Message', result.message || 'Google Business review reply deleted successfully.'],
-        ]);
+        return result.message || 'Google Business review reply deleted successfully.';
     },
 };

package/dist/tools/delete-oauth-client.js

@@ -1,5 +1,4 @@
 import { z } from 'zod';
-import { code, mdSuccess } from '../lib/format.js';
 export const deleteOAuthClientTool = {
     name: 'delete_oauth_client',
     description: 'Delete a self-serve OAuth developer client. DESTRUCTIVE: prevents new authorizations for that client_id; existing access tokens remain revocable as API keys.',
@@ -9,8 +8,6 @@ export const deleteOAuthClientTool = {
     }),
     async execute(client, input) {
         const result = await client.deleteOAuthClient(input.client_id);
-        return mdSuccess('OAuth client deleted', [
-            ['Client ID', code(result.client_id)],
-        ]);
+        return `OAuth client deleted: ${result.client_id}`;
     },
 };

package/dist/tools/delete-post-group.js

@@ -1,5 +1,4 @@
 import { z } from 'zod';
-import { mdJson, mdTitle } from '../lib/format.js';
 export const deletePostGroupTool = {
     name: 'delete_post_group',
     description: 'Delete every draft/scheduled/failed/paused post matching a caller-defined group_id, post_group_id, api_group_id, or release_id. DESTRUCTIVE: inspect the group first, list the affected posts, and pass confirm=true only after explicit confirmation.',
@@ -9,9 +8,6 @@ export const deletePostGroupTool = {
     }),
     async execute(client, input) {
         const result = await client.deletePostGroup(input.group_id);
-        return [
-            mdTitle('✅ Post group delete completed', `Group: ${input.group_id}`),
-            mdJson('Result', result),
-        ].join('\n\n');
+        return JSON.stringify(result, null, 2);
     },
 };

package/dist/tools/delete-post.js

@@ -1,5 +1,4 @@
 import { z } from 'zod';
-import { code, mdSuccess } from '../lib/format.js';
 export const deletePostTool = {
     name: 'delete_post',
     description: 'Delete a scheduled or draft post. DESTRUCTIVE and IRREVERSIBLE — the post and its caption cannot be recovered. Cannot delete published or currently publishing posts.\n\n' +
@@ -9,8 +8,6 @@ export const deletePostTool = {
     }),
     async execute(client, input) {
         const result = await client.deletePost(input.post_id);
-        return mdSuccess('Post deleted', [
-            ['Post ID', code(result.id)],
-        ]);
+        return `Post #${result.id} deleted successfully.`;
     },
 };

package/dist/tools/delete-webhook.js

@@ -1,5 +1,4 @@
 import { z } from 'zod';
-import { code, mdSuccess } from '../lib/format.js';
 export const deleteWebhookTool = {
     name: 'delete_webhook',
     description: 'Delete a webhook subscription. DESTRUCTIVE: list the webhook first, show the user its URL/events/workspace, and get explicit confirmation before calling.',
@@ -9,8 +8,6 @@ export const deleteWebhookTool = {
     }),
     async execute(client, input) {
         const result = await client.deleteWebhook(input.webhook_id);
-        return mdSuccess('Webhook deleted', [
-            ['Webhook ID', code(result.id)],
-        ]);
+        return `Webhook deleted: ${result.id}`;
     },
 };

package/dist/tools/disconnect-account.js

@@ -1,5 +1,4 @@
 import { z } from 'zod';
-import { code, mdSuccess } from '../lib/format.js';
 export const disconnectAccountTool = {
     name: 'disconnect_account',
     description: 'Disconnect a connected social account from posterly. DESTRUCTIVE and IRREVERSIBLE: removes the account connection, emits account.disconnected webhooks, and may transfer Instagram scheduled posts to a replacement account.\n\n' +
@@ -14,11 +13,10 @@ export const disconnectAccountTool = {
         }
         const result = await client.disconnectAccount(input.account_id);
         const account = result.account || {};
-        return mdSuccess('Account disconnected', [
-            ['Account', `${account.platform || 'account'}${account.username ? ` @${account.username}` : ''}`],
-            ['Account ID', code(account.id || input.account_id)],
-            ['Transferred posts', result.transferred_post_count ?? 0],
-            ['Stamped posts', result.stamped_post_count ?? 0],
-        ]);
+        return [
+            `Disconnected ${account.platform || 'account'}${account.username ? ` @${account.username}` : ''} (ID: ${account.id || input.account_id}).`,
+            `Transferred posts: ${result.transferred_post_count ?? 0}.`,
+            `Stamped posts: ${result.stamped_post_count ?? 0}.`,
+        ].join('\n');
     },
 };

package/dist/tools/find-slot.js

@@ -1,5 +1,4 @@
 import { z } from 'zod';
-import { formatDate, mdEmpty, mdTable, mdTitle } from '../lib/format.js';
 export const findSlotTool = {
     name: 'find_available_slot',
     description: 'Find available time slots for posting. Respects a 1-hour gap between posts and preferred hours (8am–10pm in the given timezone). Returns up to 10 slots. IMPORTANT: pass a timezone explicitly — default is America/New_York and slots will be off if the user is elsewhere. Pass workspace_id to only avoid collisions with posts in that workspace.',
@@ -26,15 +25,9 @@ export const findSlotTool = {
     async execute(client, input) {
         const slots = await client.findAvailableSlots(input);
         if (slots.length === 0) {
-            return mdEmpty('available slots', 'No available posting slots were found in the next 14 days.');
+            return 'No available slots found in the next 14 days.';
         }
-        return [
-            mdTitle(`Available posting slots (${slots.length})`),
-            mdTable(['Option', 'Local time', 'Date'], slots.map((slot, index) => [
-                index + 1,
-                slot.local_time,
-                formatDate(slot.time),
-            ])),
-        ].join('\n\n');
+        const lines = slots.map((s, i) => `${i + 1}. ${s.local_time} — ${new Date(s.time).toLocaleDateString('en-US', { weekday: 'short', month: 'short', day: 'numeric' })}`);
+        return `Available posting slots:\n${lines.join('\n')}`;
     },
 };

package/dist/tools/generate-image.js

@@ -1,5 +1,4 @@
 import { z } from 'zod';
-import { mdBullets, mdKeyValue, mdSection, mdTable, mdTitle } from '../lib/format.js';
 export const generateImageTool = {
     name: 'generate_image',
     description: 'Generate an AI image via Posterly\'s Nano Banana (Gemini) integration. The image is saved to the user\'s media storage and the returned URL can be passed to `create_post` as `media_url`.\n\n' +
@@ -48,21 +47,24 @@ export const generateImageTool = {
     }),
     async execute(client, input) {
         const result = await client.generateImage(input);
-        return [
-            mdTitle(`✅ Generated ${result.images.length} image${result.images.length === 1 ? '' : 's'}`, `Model: ${result.model}`),
-            mdTable(['#', 'Image URL', 'Filename'], result.images.map((img, index) => [
-                index + 1,
-                img.url,
-                img.filename,
-            ])),
-            mdKeyValue([
-                ['Billed from', result.usage.billed_from],
-                ['Credits used', result.credits_used],
-                ['Plan usage', result.usage.limit != null ? `${result.usage.used ?? 0}/${result.usage.limit} this ${result.usage.period || 'period'}` : undefined],
-                ['Plan tier', result.usage.tier || undefined],
-            ]),
-            result.warnings?.length ? mdSection('Warnings', mdBullets(result.warnings)) : '',
-            '**Next step:** Pass any URL above to `create_post` as `media_url`, or use multiple as `media_urls` for a carousel.',
-        ].filter(Boolean).join('\n\n');
+        const lines = [];
+        lines.push(`Generated ${result.images.length} image${result.images.length === 1 ? '' : 's'} via ${result.model}.`);
+        lines.push('');
+        result.images.forEach((img, i) => {
+            lines.push(`${i + 1}. ${img.url}`);
+        });
+        lines.push('');
+        lines.push(`Billed from: ${result.usage.billed_from}${result.credits_used > 0 ? ` (${result.credits_used} credits)` : ''}`);
+        if (result.usage.limit != null) {
+            lines.push(`Plan usage: ${result.usage.used ?? 0}/${result.usage.limit} this ${result.usage.period || 'period'}${result.usage.tier ? ` (${result.usage.tier})` : ''}`);
+        }
+        if (result.warnings?.length) {
+            lines.push('');
+            lines.push('Warnings:');
+            result.warnings.forEach((w) => lines.push(`• ${w}`));
+        }
+        lines.push('');
+        lines.push('Pass any of these URLs to create_post as media_url (or media_urls for a carousel).');
+        return lines.join('\n');
     },
 };

package/dist/tools/generate-video.js

@@ -1,5 +1,4 @@
 import { z } from 'zod';
-import { code, mdJson, mdKeyValue, mdTitle, statusLabel } from '../lib/format.js';
 export const generateVideoTool = {
     name: 'generate_video',
     description: 'Queue a Veo AI video generation job. COSTS VEO CREDITS: confirm prompt, model, duration, resolution, aspect ratio, audio choice, and credit cost with the user before calling. Poll get_video_job for status and final video_url.',
@@ -22,15 +21,14 @@ export const generateVideoTool = {
     async execute(client, input) {
         const result = await client.generateVideo(input);
         return [
-            mdTitle('🎬 Video generation job queued'),
-            mdKeyValue([
-                ['Job ID', code(result.job_id)],
-                ['Status', statusLabel(result.status)],
-                ['Credit cost', `${result.credit_cost} (${result.included_credit_cost || 0} included, ${result.purchased_credit_cost || 0} purchased)`],
-                ['Message', result.message],
-            ]),
-            '**Next step:** Poll `get_video_job` with the job ID until the video URL is ready.',
-            mdJson('Raw response', result),
-        ].filter(Boolean).join('\n\n');
+            'Video generation job queued',
+            `Job ID: ${result.job_id}`,
+            `Status: ${result.status}`,
+            `Credit cost: ${result.credit_cost} (${result.included_credit_cost || 0} included, ${result.purchased_credit_cost || 0} purchased)`,
+            result.message,
+            '',
+            'Raw response:',
+            JSON.stringify(result, null, 2),
+        ].filter(Boolean).join('\n');
     },
 };

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

@@ -1,8 +1,7 @@
 import { z } from 'zod';
-import { formatDelta, formatNumber, formatPercent, mdBullets, mdKeyValue, mdSection, mdTable, mdTitle } from '../lib/format.js';
 export const getAccountAnalyticsTool = {
     name: 'get_account_analytics',
-    description: 'Get daily analytics snapshots and a period summary for a connected social account. Supports Instagram, Facebook, LinkedIn, Google Business Profile, Pinterest, and YouTube. Returns follower growth, reach, views, engagement rate, and platform-specific metrics.',
+    description: 'Get daily analytics snapshots and a period summary for a connected social account. Supports Instagram, Facebook, LinkedIn, Google Business Profile, Pinterest, and YouTube. Uses API-provided display_metrics for platform-native dashboard labels such as Google Business Profile Views, Search Views, Maps Views, Customer Actions, and Posts.',
     inputSchema: z.object({
         account_id: z
             .number()
@@ -19,72 +18,70 @@ export const getAccountAnalyticsTool = {
     async execute(client, input) {
         const result = await client.getAccountAnalytics(input);
         const { account, range, summary, snapshots } = result;
-        const metricRows = account.platform === 'google_business'
-            ? googleBusinessMetricRows(summary)
-            : genericMetricRows(summary, account.platform);
-        return [
-            mdTitle(`📊 Analytics for @${account.username}`, `${account.platform} · ${range.from} → ${range.to}`),
-            mdKeyValue([
-                ['Account ID', account.id],
-                ['Daily snapshots', snapshots.length],
-            ]),
-            mdSection('Summary', mdTable(['Metric', 'Value'], metricRows)),
-            mdSection('Quick read', mdBullets(buildInsights(summary, account.platform))),
-        ].filter(Boolean).join('\n\n');
+        const accountLabel = account.platform === 'google_business'
+            ? `${account.username} (Google Business, id ${account.id})`
+            : `@${account.username} (${account.platform}, id ${account.id})`;
+        const lines = [
+            `Analytics for ${accountLabel}`,
+            `Range: ${range.from} → ${range.to} (${snapshots.length} daily snapshots)`,
+            '',
+            'Summary:',
+        ];
+        const nativeRows = getNativeMetricRows(account.platform, summary);
+        if (nativeRows.length > 0) {
+            for (const [label, value] of nativeRows) {
+                pushMetric(lines, label, value);
+            }
+        }
+        else if (account.platform === 'pinterest') {
+            pushGenericSummary(lines, summary);
+            pushMetric(lines, 'Outbound clicks', summary.total_website_clicks);
+        }
+        else if (account.platform === 'youtube') {
+            pushGenericSummary(lines, summary);
+            pushMetric(lines, 'Watch minutes', summary.total_watch_minutes);
+            pushMetric(lines, 'Likes', summary.total_likes);
+        }
+        else {
+            pushGenericSummary(lines, summary);
+        }
+        return lines.join('\n');
     },
 };
-function genericMetricRows(summary, platform) {
-    const rows = [
-        ['Followers', `${formatNumber(summary.current_followers)} (${formatDelta(summary.followers_change)} in range)`],
-        ['Follows gained / lost', `+${formatNumber(summary.total_follows_gained)} / -${formatNumber(summary.total_follows_lost)}`],
-        ['Total reach', formatNumber(summary.total_reach)],
-        ['Total views', formatNumber(summary.total_views)],
-        ['Profile views', formatNumber(summary.total_profile_views)],
-        ['Accounts engaged', formatNumber(summary.total_accounts_engaged)],
-        ['Engagement rate by reach', formatPercent(summary.engagement_rate)],
-        ['Engagement rate by followers', formatPercent(summary.engagement_rate_by_followers)],
-    ];
-    if (platform === 'pinterest') {
-        rows.push(['Outbound clicks', formatNumber(summary.total_website_clicks)]);
-    }
-    if (platform === 'youtube') {
-        rows.push(['Watch minutes', formatNumber(summary.total_watch_minutes)]);
-        rows.push(['Likes', formatNumber(summary.total_likes)]);
+function getNativeMetricRows(platform, summary) {
+    // API-provided display_metrics is the contract for platform-native dashboards.
+    // Add future non-generic analytics platforms there so MCP output never guesses
+    // from internal storage field names.
+    const apiRows = (summary.display_metrics || [])
+        .filter((metric) => metric?.label)
+        .map((metric) => [metric.label, metric.value]);
+    if (apiRows.length > 0)
+        return apiRows;
+    if (platform === 'google_business') {
+        const metrics = summary.platform_metrics || {};
+        return [
+            ['Profile Views', metrics.profile_views ?? summary.total_views],
+            ['Search Views', metrics.search_views ?? summary.total_reach],
+            ['Maps Views', metrics.maps_views ?? summary.total_profile_views],
+            ['Customer Actions', metrics.customer_actions ?? summary.total_accounts_engaged],
+            ['Posts', metrics.posts ?? summary.current_media_count],
+        ];
     }
-    return rows;
+    return [];
 }
-function googleBusinessMetricRows(summary) {
-    const metrics = summary.platform_metrics || {};
-    return [
-        ['Profile views', formatNumber(metrics.profile_views ?? summary.total_views)],
-        ['Search views', formatNumber(metrics.search_views ?? summary.total_reach)],
-        ['Maps views', formatNumber(metrics.maps_views ?? summary.total_profile_views)],
-        ['Customer actions', formatNumber(metrics.customer_actions ?? summary.total_accounts_engaged)],
-        ['Posts', formatNumber(metrics.posts ?? summary.current_media_count)],
-        ['Engagement rate (actions / profile views)', formatPercent(summary.engagement_rate)],
-        ['Website clicks', formatNumber(metrics.website_clicks ?? summary.total_website_clicks)],
-        ['Call clicks', formatNumber(metrics.call_clicks ?? summary.total_call_clicks)],
-        ['Direction requests', formatNumber(metrics.direction_requests ?? summary.total_direction_requests)],
-        ['Conversations', formatNumber(metrics.conversations ?? summary.total_conversations)],
-        ['Bookings', formatNumber(metrics.bookings ?? summary.total_bookings)],
-    ];
+function formatDelta(n) {
+    return n >= 0 ? `+${n.toLocaleString()}` : n.toLocaleString();
 }
-function buildInsights(summary, platform) {
-    const insights = [];
-    if (summary.followers_change > 0) {
-        insights.push(`Audience grew by ${formatDelta(summary.followers_change)} followers in this range.`);
-    }
-    else if (summary.followers_change < 0) {
-        insights.push(`Audience dipped by ${formatDelta(summary.followers_change)} followers in this range.`);
-    }
-    if (summary.engagement_rate != null) {
-        insights.push(`Engagement by reach is ${formatPercent(summary.engagement_rate)}.`);
-    }
-    if (platform === 'google_business' && summary.total_website_clicks != null) {
-        insights.push(`${formatNumber(summary.total_website_clicks)} website clicks came from the profile.`);
-    }
-    if (platform === 'youtube' && summary.total_watch_minutes != null) {
-        insights.push(`${formatNumber(summary.total_watch_minutes)} total watch minutes were recorded.`);
+function pushGenericSummary(lines, summary) {
+    lines.push(`• Followers: ${summary.current_followers.toLocaleString()} (${formatDelta(summary.followers_change)} in range)`, `• Follows gained / lost: +${summary.total_follows_gained} / -${summary.total_follows_lost}`);
+    pushMetric(lines, 'Total reach', summary.total_reach);
+    pushMetric(lines, 'Total views', summary.total_views);
+    pushMetric(lines, 'Profile views', summary.total_profile_views);
+    pushMetric(lines, 'Total accounts engaged', summary.total_accounts_engaged);
+    lines.push(`• Engagement rate (by reach): ${summary.engagement_rate}%`, `• Engagement rate (by followers): ${summary.engagement_rate_by_followers}%`);
+}
+function pushMetric(lines, label, value) {
+    if (value != null) {
+        lines.push(`• ${label}: ${value.toLocaleString()}`);
     }
-    return insights.length > 0 ? insights : ['No standout movement detected in the returned period.'];
 }

package/dist/tools/get-brand-profile.js

@@ -1,5 +1,4 @@
 import { z } from 'zod';
-import { code, compactText, formatDateTime, mdKeyValue, mdSection, mdTitle } from '../lib/format.js';
 export const getBrandProfileTool = {
     name: 'get_brand_profile',
     description: 'Get the extended brand profile for a brand/client. Returns voice/tone guidance, audience, keywords, dos and don’ts, visual notes, and other saved brand context.',
@@ -9,41 +8,48 @@ export const getBrandProfileTool = {
     async execute(client, input) {
         const result = await client.getBrandProfile(input.brand_id);
         const profile = result.brand_profile;
-        const profileBody = [
-            mdKeyValue([
-                ['Source', profile.source],
-                ['Profile ID', profile.id ? code(profile.id) : undefined],
-                ['Workspace client ID', profile.workspace_client_id ? code(profile.workspace_client_id) : undefined],
-                ['Legacy brand group ID', profile.brand_group_id ? code(profile.brand_group_id) : undefined],
-                ['Logo', profile.logo_url],
-                ['Last refreshed', profile.last_context_refresh_at ? formatDateTime(profile.last_context_refresh_at) : undefined],
-            ]),
-            mdSection('Voice and audience', mdKeyValue([
-                ['Tone of voice', compactText(profile.tone_of_voice, 180)],
-                ['Audience', compactText(profile.audience, 180)],
-                ['Brand values', compactText(profile.brand_values, 180)],
-                ['Brand story', compactText(formatStructuredValue(profile.brand_story), 240)],
-            ])),
-            mdSection('Guidance', mdKeyValue([
-                ['Custom instructions', compactText(profile.custom_instructions, 240)],
-                ['Keywords', formatStructuredValue(profile.keywords)],
-                ['Competitors', formatStructuredValue(profile.competitors)],
-                ['Do / Don’ts', formatStructuredValue(profile.do_donts)],
-                ['Topics to cover', formatStructuredValue(profile.topics_to_cover)],
-                ['Topics to avoid', formatStructuredValue(profile.topics_to_avoid)],
-            ])),
-            mdSection('Creative references', mdKeyValue([
-                ['Visual guidelines', formatStructuredValue(profile.visual_guidelines)],
-                ['Example posts', formatStructuredValue(profile.example_posts)],
-                ['Voice examples', formatStructuredValue(profile.voice_examples)],
-            ])),
-        ].filter(Boolean).join('\n\n');
-        return [
-            mdTitle(`Brand profile: ${profile.brand_name}`),
-            profileBody || 'No extended brand profile fields have been saved yet.',
-        ].join('\n\n');
+        const lines = [
+            `Brand profile: ${profile.brand_name}`,
+            `• Source: ${profile.source}`,
+        ];
+        if (profile.workspace_client_id)
+            lines.push(`• Workspace client ID: ${profile.workspace_client_id}`);
+        if (profile.brand_group_id)
+            lines.push(`• Legacy brand group ID: ${profile.brand_group_id}`);
+        if (profile.tone_of_voice)
+            lines.push(`• Tone of voice: ${profile.tone_of_voice}`);
+        if (profile.audience)
+            lines.push(`• Audience: ${profile.audience}`);
+        if (profile.brand_values)
+            lines.push(`• Brand values: ${profile.brand_values}`);
+        if (profile.custom_instructions)
+            lines.push(`• Custom instructions: ${profile.custom_instructions}`);
+        if (profile.logo_url)
+            lines.push(`• Logo URL: ${profile.logo_url}`);
+        addStructuredLine(lines, 'Keywords', profile.keywords);
+        addStructuredLine(lines, 'Competitors', profile.competitors);
+        addStructuredLine(lines, 'Do / Don’ts', profile.do_donts);
+        addStructuredLine(lines, 'Visual guidelines', profile.visual_guidelines);
+        addStructuredLine(lines, 'Brand story', profile.brand_story);
+        addStructuredLine(lines, 'Example posts', profile.example_posts);
+        addStructuredLine(lines, 'Topics to cover', profile.topics_to_cover);
+        addStructuredLine(lines, 'Topics to avoid', profile.topics_to_avoid);
+        addStructuredLine(lines, 'Voice examples', profile.voice_examples);
+        if (profile.last_context_refresh_at) {
+            lines.push(`• Last refreshed: ${profile.last_context_refresh_at}`);
+        }
+        if (lines.length === 2) {
+            lines.push('• No extended brand profile fields have been saved yet.');
+        }
+        return lines.join('\n');
     },
 };
+function addStructuredLine(lines, label, value) {
+    const formatted = formatStructuredValue(value);
+    if (formatted) {
+        lines.push(`• ${label}: ${formatted}`);
+    }
+}
 function formatStructuredValue(value) {
     if (value == null)
         return null;

package/dist/tools/get-brand.js

@@ -1,5 +1,4 @@
 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.',
@@ -9,18 +8,21 @@ export const getBrandTool = {
     async execute(client, input) {
         const result = await client.getBrand(input.brand_id);
         const brand = result.brand;
-        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');
+        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');
     },
 };

package/dist/tools/get-connect-link.js

@@ -1,6 +1,5 @@
 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.',
@@ -24,18 +23,8 @@ export const getConnectLinkTool = {
             return formatConnectOption(result.connect, true);
         }
         const options = result.connect_options || [];
-        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');
+        const lines = options.map((option) => formatConnectOption(option, false));
+        return `Posterly connection options (${options.length}):\n${lines.join('\n\n')}`;
     },
 };
 function formatConnectOption(option, includeRaw) {
@@ -47,19 +36,11 @@ 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 ? mdJson('Raw connect option', option) : '';
+    const raw = includeRaw ? `\n\nRaw connect option:\n${JSON.stringify(option, null, 2)}` : '';
     return [
-        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')) : '',
+        `${option.label} (${option.platform})`,
+        `Status: ${option.status}; method: ${option.method}; ${missing}; connected accounts: ${accounts}`,
+        `Connection URL: ${option.connection_url || 'not available'}${fields}${scopes}`,
         raw,
-    ].filter(Boolean).join('\n\n');
+    ].join('\n');
 }