posterly-mcp-server 0.19.1 → 0.19.2

package/dist/tools/list-brands.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { code, mdEmpty, mdTable, mdTitle } from '../lib/format.js';
 export const listBrandsTool = {
     name: 'list_brands',
     description: 'List brands/clients the caller can access. Returns each brand ID, name, workspace ID, source, and how many social accounts are currently assigned to it.',
@@ -12,18 +13,18 @@ export const listBrandsTool = {
         const brands = await client.listBrands({ workspace_id: input.workspace_id });
         if (brands.length === 0) {
             return input.workspace_id
-                ? 'No brands found in this workspace.'
-                : 'No brands found. Create brands in the posterly dashboard first.';
+                ? mdEmpty('brands', 'This workspace does not have any brands or clients yet.')
+                : mdEmpty('brands', 'No brands or clients were found for this API key.', 'Create a brand in the Posterly dashboard, then run this again.');
         }
-        const lines = brands.map((brand) => {
-            const suffix = [
-                `ID: ${brand.id}`,
-                brand.workspace_id ? `ws: ${brand.workspace_id}` : null,
-                `accounts: ${brand.account_count}`,
+        return [
+            mdTitle(`Brands (${brands.length})`),
+            mdTable(['Brand', 'Brand ID', 'Accounts', 'Source', 'Workspace'], brands.map((brand) => [
+                brand.name,
+                code(brand.id),
+                brand.account_count,
                 brand.source,
-            ].filter(Boolean).join(', ');
-            return `• ${brand.name} (${suffix})`;
-        });
-        return `Brands (${brands.length}):\n${lines.join('\n')}`;
+                brand.workspace_id ? code(brand.workspace_id) : 'default',
+            ])),
+        ].join('\n\n');
     },
 };

package/dist/tools/list-google-business-reviews.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { compactText, formatDateTime, mdEmpty, mdTable, mdTitle, statusLabel } from '../lib/format.js';
 export const listGoogleBusinessReviewsTool = {
     name: 'list_google_business_reviews',
     description: 'List Google Business Profile reviews for one location/account or every accessible GBP location. Supports rating and unanswered-only filters.',
@@ -12,17 +13,18 @@ export const listGoogleBusinessReviewsTool = {
     async execute(client, input) {
         const result = await client.listGoogleBusinessReviews(input);
         if (result.reviews.length === 0) {
-            return 'No Google Business reviews found matching your filters.';
+            return mdEmpty('Google Business reviews', 'No reviews matched those filters.');
         }
-        const lines = [`Google Business reviews (${result.reviews.length} of ${result.total}):`];
-        for (const review of result.reviews.slice(0, 25)) {
-            const name = review.reviewer?.displayName || 'Anonymous';
-            const rating = review.starRating ? `${review.starRating} stars` : 'unrated';
-            const location = review.businessName || review.locationName || review.locationId || 'location';
-            const text = review.comment ? ` - ${review.comment.replace(/\s+/g, ' ').slice(0, 180)}` : '';
-            const replied = review.reviewReply ? ' replied' : ' unanswered';
-            lines.push(`- ${name} (${rating}, ${location},${replied})${text}`);
-        }
-        return lines.join('\n');
+        return [
+            mdTitle(`Google Business reviews (${result.reviews.length} of ${result.total})`),
+            mdTable(['Reviewer', 'Rating', 'Location', 'Reply', 'Updated', 'Comment'], result.reviews.slice(0, 25).map((review) => [
+                review.reviewer?.displayName || 'Anonymous',
+                review.starRating ? `${review.starRating} stars` : 'unrated',
+                review.businessName || review.locationName || review.locationId || 'location',
+                statusLabel(review.reviewReply ? 'replied' : 'unanswered'),
+                formatDateTime(review.updateTime || review.createTime),
+                compactText(review.comment, 140) || '(rating only)',
+            ])),
+        ].join('\n\n');
     },
 };

package/dist/tools/list-oauth-clients.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { code, mdEmpty, mdTable, mdTitle, statusLabel } from '../lib/format.js';
 export const listOAuthClientsTool = {
     name: 'list_oauth_clients',
     description: 'List self-serve OAuth developer clients owned by the user. These are public PKCE clients for third-party app integrations.',
@@ -6,10 +7,15 @@ export const listOAuthClientsTool = {
     async execute(client) {
         const result = await client.listOAuthClients();
         if (result.clients.length === 0)
-            return 'No OAuth developer clients found.';
+            return mdEmpty('OAuth developer clients', 'No OAuth developer clients were found.');
         return [
-            `OAuth developer clients (${result.clients.length}):`,
-            ...result.clients.map((item) => `- ${item.client_name} (${item.client_id}) scopes=${item.default_scopes.join(', ')} active=${item.is_active}`),
-        ].join('\n');
+            mdTitle(`OAuth developer clients (${result.clients.length})`),
+            mdTable(['Client', 'Client ID', 'Scopes', 'State'], result.clients.map((item) => [
+                item.client_name,
+                code(item.client_id),
+                item.default_scopes.join(', '),
+                statusLabel(item.is_active ? 'active' : 'inactive'),
+            ])),
+        ].join('\n\n');
     },
 };

package/dist/tools/list-platforms.js

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import { PLANNED_PLATFORM_IDS } from '../generated/platform-manifest.js';
+import { code, mdTable, mdTitle, statusLabel } from '../lib/format.js';
 export const listPlatformsTool = {
     name: 'list_platforms',
     description: 'List posterly platform integrations, posting capabilities, content/media limits, settings schemas, helper tools, and analytics support. Use include_planned to show future integration possibilities from the Postiz parity audit.',
@@ -11,10 +12,16 @@ export const listPlatformsTool = {
     }),
     async execute(client, input) {
         const result = await client.listPlatforms(input);
-        const lines = result.platforms.map((platform) => {
-            const helperCount = platform.helper_tools?.length || 0;
-            return `• ${platform.label} (${platform.id}) — ${platform.status}; post types: ${platform.post_types.join(', ') || 'n/a'}; helpers: ${helperCount}; analytics: ${platform.analytics_supported ? 'yes' : 'no'}`;
-        });
-        return `Posterly platforms (${result.platforms.length}):\n${lines.join('\n')}`;
+        return [
+            mdTitle(`Posterly platforms (${result.platforms.length})`),
+            mdTable(['Platform', 'ID', 'Status', 'Post types', 'Helpers', 'Analytics'], result.platforms.map((platform) => [
+                platform.label,
+                code(platform.id),
+                statusLabel(platform.status),
+                platform.post_types.join(', ') || 'n/a',
+                platform.helper_tools?.length || 0,
+                platform.analytics_supported,
+            ])),
+        ].join('\n\n');
     },
 };

package/dist/tools/list-posts.js

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import { SUPPORTED_PLATFORM_INPUTS, SUPPORTED_PLATFORM_IDS } from '../generated/platform-manifest.js';
+import { code, compactText, formatDateTime, mdEmpty, mdTable, mdTitle, statusLabel } from '../lib/format.js';
 export const listPostsTool = {
     name: 'list_posts',
     description: 'List upcoming or recent posts. Filter by status (scheduled, published, failed, draft), platform, account_id, or workspace_id. If workspace_id is omitted, posts across every workspace the caller is a member of are returned.',
@@ -33,13 +34,17 @@ export const listPostsTool = {
             limit: input.limit || 20,
         });
         if (posts.length === 0) {
-            return 'No posts found matching your criteria.';
+            return mdEmpty('posts', 'No posts matched those filters.');
         }
-        const lines = posts.map((p) => {
-            const date = new Date(p.scheduled_at).toLocaleString();
-            const caption = p.content.length > 60 ? p.content.slice(0, 60) + '…' : p.content;
-            return `• [${p.status}] #${p.id} — ${caption} (${date})`;
-        });
-        return `Posts (${posts.length} of ${total}):\n${lines.join('\n')}`;
+        return [
+            mdTitle(`Posts (${posts.length} of ${total})`),
+            mdTable(['Status', 'Post ID', 'Caption', 'Scheduled', 'Type'], posts.map((post) => [
+                statusLabel(post.status),
+                code(post.id),
+                compactText(post.content, 80) || '(empty)',
+                formatDateTime(post.scheduled_at),
+                post.post_type || 'post',
+            ])),
+        ].join('\n\n');
     },
 };

package/dist/tools/list-webhooks.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { code, compactText, formatDateTime, mdEmpty, mdTable, mdTitle, statusLabel } from '../lib/format.js';
 export const listWebhooksTool = {
     name: 'list_webhooks',
     description: 'List API webhook subscriptions, their event filters, active state, and most recent delivery status.',
@@ -8,17 +9,18 @@ export const listWebhooksTool = {
     async execute(client, input) {
         const { webhooks } = await client.listWebhooks(input);
         if (webhooks.length === 0) {
-            return 'No webhooks found.';
+            return mdEmpty('webhooks', 'No webhook subscriptions were found.');
         }
-        const lines = [`Webhooks (${webhooks.length}):`];
-        for (const webhook of webhooks) {
-            const active = webhook.is_active ? 'active' : 'inactive';
-            const events = webhook.events?.length ? webhook.events.join(', ') : 'default events';
-            const last = webhook.last_delivery_at
-                ? ` last ${webhook.last_delivery_status || 'n/a'} at ${new Date(webhook.last_delivery_at).toLocaleString()}`
-                : '';
-            lines.push(`- ${webhook.id} [${active}] ${webhook.url} (${events})${last}`);
-        }
-        return lines.join('\n');
+        return [
+            mdTitle(`Webhooks (${webhooks.length})`),
+            mdTable(['Webhook ID', 'State', 'URL', 'Events', 'Last delivery', 'Last error'], webhooks.map((webhook) => [
+                code(webhook.id),
+                statusLabel(webhook.is_active ? 'active' : 'inactive'),
+                webhook.url,
+                webhook.events?.length ? webhook.events.join(', ') : 'default events',
+                webhook.last_delivery_at ? `${webhook.last_delivery_status || 'n/a'} at ${formatDateTime(webhook.last_delivery_at)}` : 'n/a',
+                compactText(webhook.last_error, 80) || 'n/a',
+            ])),
+        ].join('\n\n');
     },
 };

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

@@ -32,5 +32,5 @@ export declare const replyGoogleBusinessReviewTool: {
         review_name: string;
         comment: string;
         confirm: true;
-    }): Promise<any>;
+    }): Promise<string>;
 };

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

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { mdSuccess } from '../lib/format.js';
 export const replyGoogleBusinessReviewTool = {
     name: 'reply_google_business_review',
     description: 'Post or update the owner reply on a Google Business Profile review. WRITE: show the review, location, and exact reply text to the user, then pass confirm=true only after explicit confirmation.',
@@ -13,6 +14,8 @@ export const replyGoogleBusinessReviewTool = {
     async execute(client, input) {
         const { confirm: _confirm, ...payload } = input;
         const result = await client.replyGoogleBusinessReview(payload);
-        return result.message || 'Google Business review reply posted successfully.';
+        return mdSuccess('Google Business review reply posted', [
+            ['Message', result.message || 'Google Business review reply posted successfully.'],
+        ]);
     },
 };

package/dist/tools/run-video-function.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { code, mdJson, mdTitle } from '../lib/format.js';
 export const runVideoFunctionTool = {
     name: 'run_video_function',
     description: 'Run a read-only Veo helper function before generation: list_input_modes, estimate_cost, or validate_request. This does not generate video or spend credits.',
@@ -17,9 +18,8 @@ export const runVideoFunctionTool = {
     async execute(client, input) {
         const result = await client.runVideoFunction(input);
         return [
-            `Video function ${input.functionName} completed`,
-            '',
-            JSON.stringify(result, null, 2),
-        ].join('\n');
+            mdTitle(`Video function ${code(input.functionName)} completed`),
+            mdJson('Result', result),
+        ].join('\n\n');
     },
 };

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

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { mdEmpty, mdQuote, mdSection, mdTitle } from '../lib/format.js';
 export const suggestGoogleBusinessReviewReplyTool = {
     name: 'suggest_google_business_review_reply',
     description: 'Generate short, brand-aware AI reply suggestions for a Google review. Uses the AI Caption Assist allowance; does not post the reply.',
@@ -17,11 +18,11 @@ export const suggestGoogleBusinessReviewReplyTool = {
         const result = await client.suggestGoogleBusinessReviewReply(input);
         const suggestions = Array.isArray(result.suggestions) ? result.suggestions : [];
         if (suggestions.length === 0) {
-            return 'No reply suggestions were generated.';
+            return mdEmpty('reply suggestions', 'No Google Business reply suggestions were generated.');
         }
         return [
-            `Suggested replies (${result.tone || 'professional'}, ${result.rating || input.star_rating} stars):`,
-            ...suggestions.map((text, index) => `${index + 1}. ${text}`),
-        ].join('\n');
+            mdTitle(`Suggested replies`, `${result.tone || 'professional'} tone · ${result.rating || input.star_rating} stars`),
+            ...suggestions.map((text, index) => mdSection(`Option ${index + 1}`, mdQuote(text))),
+        ].join('\n\n');
     },
 };

package/dist/tools/test-webhook.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { mdJson, mdSuccess } from '../lib/format.js';
 export const testWebhookTool = {
     name: 'test_webhook',
     description: 'Send a signed webhook.test delivery to a webhook URL. OUTBOUND SIDE EFFECT: get explicit confirmation before sending a test request.',
@@ -9,6 +10,11 @@ export const testWebhookTool = {
     async execute(client, input) {
         const result = await client.testWebhook(input.webhook_id);
         const delivery = result.delivery || {};
-        return `Webhook test sent.\nDelivery: ${JSON.stringify(delivery, null, 2)}`;
+        return [
+            mdSuccess('Webhook test sent', [
+                ['Webhook ID', input.webhook_id],
+            ]),
+            mdJson('Delivery', delivery),
+        ].join('\n\n');
     },
 };

package/dist/tools/trigger-platform-helper.js

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import { PLATFORM_HELPER_NAMES, SUPPORTED_PLATFORM_INPUTS, SUPPORTED_PLATFORM_IDS } from '../generated/platform-manifest.js';
+import { code, mdJson, mdTitle } from '../lib/format.js';
 export const triggerPlatformHelperTool = {
     name: 'trigger_platform_helper',
     description: `Run account-specific platform helper discovery. Available helpers: ${PLATFORM_HELPER_NAMES.join(', ')}.`,
@@ -17,6 +18,9 @@ export const triggerPlatformHelperTool = {
     }),
     async execute(client, input) {
         const result = await client.triggerPlatformHelper(input);
-        return JSON.stringify(result, null, 2);
+        return [
+            mdTitle(`Platform helper ${code(input.helper)} completed`),
+            mdJson('Result', result),
+        ].join('\n\n');
     },
 };

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

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { code, mdSuccess, statusLabel } from '../lib/format.js';
 const scopeSchema = z.enum(['accounts:read', 'accounts:write', 'posts:read', 'posts:write', 'media:write', 'analytics:read']);
 export const updateOAuthClientTool = {
     name: 'update_oauth_client',
@@ -16,6 +17,12 @@ export const updateOAuthClientTool = {
     async execute(client, input) {
         const { client_id, confirm: _confirm, ...payload } = input;
         const result = await client.updateOAuthClient(client_id, payload);
-        return `OAuth client updated: ${result.client.client_name} (${result.client.client_id}) active=${result.client.is_active}`;
+        return mdSuccess('OAuth client updated', [
+            ['Client', result.client.client_name],
+            ['Client ID', code(result.client.client_id)],
+            ['State', statusLabel(result.client.is_active ? 'active' : 'inactive')],
+            ['Redirect URIs', result.client.allowed_redirect_uris.join(', ')],
+            ['Default scopes', result.client.default_scopes.join(', ')],
+        ]);
     },
 };

package/dist/tools/update-post-release-id.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { code, mdJson, mdTitle } from '../lib/format.js';
 export const updatePostReleaseIdTool = {
     name: 'update_post_release_id',
     description: 'Set or repair an external release_id and optional group_id on a post. WRITE: call get_post first, show the target post and release/group IDs, then pass confirm=true only after explicit confirmation.',
@@ -13,6 +14,9 @@ export const updatePostReleaseIdTool = {
             release_id: input.release_id,
             group_id: input.group_id,
         });
-        return JSON.stringify(result, null, 2);
+        return [
+            mdTitle(`✅ Release ID updated for post ${code(input.post_id)}`),
+            mdJson('Result', result),
+        ].join('\n\n');
     },
 };

package/dist/tools/update-post-status.d.ts

@@ -9,12 +9,12 @@ export declare const updatePostStatusTool: {
         scheduled_at: z.ZodOptional<z.ZodString>;
         confirm: z.ZodBoolean;
     }, "strip", z.ZodTypeAny, {
-        status: "scheduled" | "paused" | "draft";
+        status: "scheduled" | "draft" | "paused";
         post_id: number;
         confirm: boolean;
         scheduled_at?: string | undefined;
     }, {
-        status: "scheduled" | "paused" | "draft";
+        status: "scheduled" | "draft" | "paused";
         post_id: number;
         confirm: boolean;
         scheduled_at?: string | undefined;

package/dist/tools/update-post-status.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { code, mdSuccess, statusLabel } from '../lib/format.js';
 export const updatePostStatusTool = {
     name: 'update_post_status',
     description: 'Pause, resume/schedule, or move a post back to draft. DESTRUCTIVE WRITE: changes whether content will publish.\n\n' +
@@ -18,6 +19,11 @@ export const updatePostStatusTool = {
             scheduled_at: input.scheduled_at,
         });
         const transition = result.transition || {};
-        return `Post #${input.post_id} status changed from ${transition.old_status || 'unknown'} to ${transition.new_status || input.status}.`;
+        return mdSuccess('Post status updated', [
+            ['Post ID', code(input.post_id)],
+            ['From', statusLabel(transition.old_status || 'unknown')],
+            ['To', statusLabel(transition.new_status || input.status)],
+            ['Scheduled', input.scheduled_at || undefined],
+        ]);
     },
 };

package/dist/tools/update-post.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { code, formatDateTime, mdKeyValue, mdQuote, mdSection, mdTitle, statusLabel } from '../lib/format.js';
 const instagramSettingsSchema = z.object({
     __type: z.enum(['instagram', 'instagram-standalone']).optional(),
     post_type: z.enum(['post', 'feed', 'story', 'reel', 'carousel']).optional(),
@@ -89,9 +90,14 @@ export const updatePostTool = {
         };
         const result = await client.updatePost(post_id, payload);
         const p = result.post;
-        const when = p.scheduled_at
-            ? new Date(p.scheduled_at).toLocaleString()
-            : 'N/A';
-        return `Post #${p.id} updated successfully!\n• Status: ${p.status}\n• Caption: ${p.content || '(empty)'}\n• Scheduled: ${when}`;
+        return [
+            mdTitle(`✅ Post ${code(p.id)} updated`),
+            mdKeyValue([
+                ['Status', statusLabel(p.status)],
+                ['Scheduled', formatDateTime(p.scheduled_at)],
+                ['Type', p.post_type || 'unknown'],
+            ]),
+            mdSection('Caption', p.content ? mdQuote(p.content) : '_(empty)_'),
+        ].join('\n\n');
     },
 };

package/dist/tools/update-webhook.js

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import { webhookEventSchema } from './webhook-events.js';
+import { code, mdSuccess, statusLabel } from '../lib/format.js';
 export const updateWebhookTool = {
     name: 'update_webhook',
     description: 'Update a webhook URL, events, workspace, description, or active state. WRITE WITH OUTBOUND SIDE EFFECTS: list the current webhook first and get explicit confirmation before calling.',
@@ -16,6 +17,11 @@ export const updateWebhookTool = {
         const { webhook_id, confirm: _confirm, ...payload } = input;
         const result = await client.updateWebhook(webhook_id, payload);
         const active = result.webhook.is_active ? 'active' : 'inactive';
-        return `Webhook updated: ${result.webhook.id}\nURL: ${result.webhook.url}\nState: ${active}\nEvents: ${result.webhook.events.join(', ')}`;
+        return mdSuccess('Webhook updated', [
+            ['Webhook ID', code(result.webhook.id)],
+            ['URL', result.webhook.url],
+            ['State', statusLabel(active)],
+            ['Events', result.webhook.events.join(', ')],
+        ]);
     },
 };

package/dist/tools/upload-media-from-url.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { formatBytes, mdSuccess } from '../lib/format.js';
 export const uploadMediaFromUrlTool = {
     name: 'upload_media_from_url',
     description: 'Fetch an image or video from a public HTTPS URL into posterly storage. Returns a URL that can be used with create_post.',
@@ -13,14 +14,11 @@ export const uploadMediaFromUrlTool = {
             filename: input.filename,
             contentType: input.content_type,
         });
-        return [
-            'Remote media uploaded successfully.',
-            `• URL: ${result.url}`,
-            `• Source URL: ${result.source_url}`,
-            `• Content type: ${result.content_type}`,
-            `• Size: ${result.size} bytes`,
-            '',
-            'Use this URL as media_url when creating a post.',
-        ].join('\n');
+        return mdSuccess('Remote media uploaded', [
+            ['URL', result.url],
+            ['Source URL', result.source_url],
+            ['Content type', result.content_type],
+            ['Size', formatBytes(result.size)],
+        ], 'Use this URL as `media_url` when creating a post.');
     },
 };

package/dist/tools/upload-media.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { mdError, mdSuccess } from '../lib/format.js';
 export const uploadMediaTool = {
     name: 'upload_media',
     description: 'Upload an image or video file to posterly storage. Returns a URL that can be used with create_post. Supports JPEG, PNG, GIF, WebP, MP4, MOV, WebM. Images up to 10MB, videos up to 50MB.\n\n' +
@@ -23,7 +24,7 @@ export const uploadMediaTool = {
     }),
     async execute(client, input) {
         if (!input.file_path && !input.base64_data) {
-            return 'Error: Provide either file_path or base64_data.';
+            return mdError('Provide either `file_path` or `base64_data`.');
         }
         const result = await client.uploadMedia({
             filePath: input.file_path,
@@ -31,6 +32,9 @@ export const uploadMediaTool = {
             filename: input.filename,
             contentType: input.content_type,
         });
-        return `Media uploaded successfully!\n• URL: ${result.url}\n\nUse this URL as media_url when creating a post.`;
+        return mdSuccess('Media uploaded', [
+            ['URL', result.url],
+            ['Storage path', result.path],
+        ], 'Use this URL as `media_url` when creating a post.');
     },
 };

package/dist/tools/whoami.js

@@ -1,26 +1,27 @@
 import { z } from 'zod';
+import { code, mdKeyValue, mdTable, mdTitle } from '../lib/format.js';
 export const whoamiTool = {
     name: 'whoami',
     description: 'Return the authenticated user, API key scopes, the default (personal) workspace, and every workspace the caller can post in. ALWAYS call this at the start of a session before creating, listing, or scheduling posts — posts created without an explicit workspace_id land in the default workspace shown here, and confirming with the user first prevents posts from appearing in the wrong workspace.',
     inputSchema: z.object({}),
     async execute(client) {
         const info = await client.whoami();
-        const lines = [];
-        lines.push(`User: ${info.user.email || info.user.id}`);
-        lines.push(`API scopes: ${info.api_key.scopes.join(', ') || 'none'}`);
-        lines.push('');
-        lines.push(`Default workspace: ${info.default_workspace.name} (${info.default_workspace.id})` +
-            (info.default_workspace.timezone ? ` — tz: ${info.default_workspace.timezone}` : ''));
-        lines.push('');
-        lines.push(`All workspaces (${info.workspaces.length}):`);
-        for (const ws of info.workspaces) {
-            const marker = ws.id === info.default_workspace.id ? ' [default]' : '';
-            const personal = ws.is_personal ? ' [personal]' : '';
-            const tz = ws.timezone ? ` — tz: ${ws.timezone}` : '';
-            lines.push(`• ${ws.name} — ${ws.id} (role: ${ws.role || 'member'})${personal}${marker}${tz}`);
-        }
-        lines.push('');
-        lines.push('Tip: pass workspace_id to create_post / list_posts / list_accounts / find_available_slot to scope actions to a specific workspace. Omit it to use the default.');
-        return lines.join('\n');
+        return [
+            mdTitle('Posterly identity'),
+            mdKeyValue([
+                ['User', info.user.email || code(info.user.id)],
+                ['API scopes', info.api_key.scopes.join(', ') || 'none'],
+                ['Default workspace', `${info.default_workspace.name} (${code(info.default_workspace.id)})`],
+                ['Default timezone', info.default_workspace.timezone || 'n/a'],
+            ]),
+            mdTable(['Workspace', 'Workspace ID', 'Role', 'Timezone', 'Default'], info.workspaces.map((workspace) => [
+                `${workspace.name}${workspace.is_personal ? ' (personal)' : ''}`,
+                code(workspace.id),
+                workspace.role || 'member',
+                workspace.timezone || 'n/a',
+                workspace.id === info.default_workspace.id,
+            ])),
+            '**Tip:** Pass `workspace_id` to `create_post`, `list_posts`, `list_accounts`, and `find_available_slot` when you want the assistant to stay inside one workspace.',
+        ].join('\n\n');
     },
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "posterly-mcp-server",
-  "version": "0.19.1",
+  "version": "0.19.2",
   "description": "MCP server for posterly — schedule social media posts from Claude Desktop",
   "license": "MIT",
   "homepage": "https://www.poster.ly/mcp",