posterly-mcp-server 0.44.0 → 0.45.1

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

@@ -1,79 +1,104 @@
 import { z } from 'zod';
 import { formatDate } from '../lib/format.js';
+import { validateArgs } from '../lib/tool-runtime.js';
 /** Matches GOOGLE_BUSINESS_REVIEWS_MAX_LIMIT in lib/api-v1-google-business.ts. */
 const MAX_LIMIT = 1000;
 export const listGoogleBusinessReviewsTool = {
     name: 'list_google_business_reviews',
-    description: 'List Google Business Profile reviews for one location/account or every accessible GBP location. Pages through all reviews Google has (not just the first 50), returns the full untruncated review text with its date, and reports each location\'s total review count. Supports rating and unanswered-only filters plus limit/offset paging.',
+    description: 'Google Business Profile reviews. view=reviews (default): reviews for one location/account or every accessible GBP location, paging through all reviews Google has (not just the first 50) with the full untruncated review text, its date, and each location\'s total review count; filter by rating or unanswered, page with limit/offset. view=review_link (account_id or location_id): the direct public Google review link plus the Google Place ID (ChIJ...); that Place ID is output only and must NOT be passed back as location_id.',
     inputSchema: z.object({
+        view: z.enum(['reviews', 'review_link']).optional().describe('reviews (default) or review_link.'),
         workspace_id: z.string().optional().describe('Filter to a workspace ID from whoami.'),
         account_id: z.number().int().positive().optional().describe('Google Business account ID from list_accounts.'),
-        location_id: z.string().optional().describe('Google Business numeric location id (the location_id/platform_user_id from list_accounts, e.g. "197940849675145390"). NOT the ChIJ... Place ID returned by get_google_business_review_link. Prefer account_id.'),
-        rating: z.number().int().min(1).max(5).optional().describe('Filter to a 1-5 star rating.'),
-        unanswered: z.boolean().optional().describe('Only return reviews without owner replies.'),
+        location_id: z.string().optional().describe('Google Business numeric location id (the location_id/platform_user_id from list_accounts, e.g. "197940849675145390"). NOT the ChIJ... Place ID from view=review_link. Prefer account_id.'),
+        rating: z.number().int().min(1).max(5).optional().describe('reviews: filter to a 1-5 star rating.'),
+        unanswered: z.boolean().optional().describe('reviews: only return reviews without owner replies.'),
         limit: z
             .number()
             .int()
             .min(1)
             .max(MAX_LIMIT)
             .optional()
-            .describe(`Maximum reviews to return in this call (default 200, max ${MAX_LIMIT}). Every returned review is listed in full.`),
+            .describe(`reviews: maximum reviews to return in this call (default 200, max ${MAX_LIMIT}). Every returned review is listed in full.`),
         offset: z
             .number()
             .int()
             .min(0)
             .optional()
-            .describe('Skip this many reviews before returning results. Use with limit to page through a location with more reviews than one call returns.'),
+            .describe('reviews: skip this many reviews before returning results. Use with limit to page through a location with more reviews than one call returns.'),
     }),
-    async execute(client, input) {
-        const result = await client.listGoogleBusinessReviews(input);
-        const locations = (result.locations || []);
-        const offset = result.offset ?? 0;
-        if (result.reviews.length === 0) {
-            // Distinguish "no reviews exist" from "we couldn't read them" — a silent
-            // zero used to be indistinguishable from a broken connection.
-            const lines = ['No Google Business reviews found matching your filters.'];
-            const locationLines = locations.map((location) => formatLocationLine(location));
-            if (locationLines.length > 0) {
-                lines.push('', 'Locations checked:', ...locationLines);
-            }
-            return lines.join('\n');
-        }
-        const header = [`Google Business reviews (showing ${result.reviews.length} of ${result.total} matching`];
-        if (offset > 0)
-            header.push(`, from offset ${offset}`);
-        if (typeof result.total_review_count === 'number') {
-            header.push(`; ${result.total_review_count} total on Google`);
-        }
-        header.push('):');
-        const lines = [header.join('')];
-        for (const location of locations) {
-            if (location.error) {
-                lines.push(`! ${location.business_name || location.name || location.location_id || 'location'}: ${location.error}`);
-            }
+    /** The old tools' exact input schemas, for alias calls (see alias-transport.ts). */
+    legacySchemas: {
+        get_google_business_review_link: z.object({
+            workspace_id: z.string().optional(),
+            account_id: z.number().int().positive().optional(),
+            location_id: z.string().optional(),
+        }),
+    },
+    async execute(client, input, ctx) {
+        const { mode, args } = validateArgs(ctx, 'list_google_business_reviews', input);
+        if (mode === 'review_link')
+            return reviewLink(client, args);
+        return reviews(client, args);
+    },
+};
+async function reviews(client, input) {
+    const result = await client.listGoogleBusinessReviews(input);
+    const locations = (result.locations || []);
+    const offset = result.offset ?? 0;
+    if (result.reviews.length === 0) {
+        // Distinguish "no reviews exist" from "we couldn't read them": a silent
+        // zero used to be indistinguishable from a broken connection.
+        const lines = ['No Google Business reviews found matching your filters.'];
+        const locationLines = locations.map((location) => formatLocationLine(location));
+        if (locationLines.length > 0) {
+            lines.push('', 'Locations checked:', ...locationLines);
         }
-        lines.push('');
-        for (const review of result.reviews) {
-            const name = review.reviewer?.displayName || 'Anonymous';
-            const rating = review.starRating ? `${review.starRating} stars` : 'unrated';
-            const location = review.businessName || review.locationName || review.locationId || 'location';
-            const date = formatReviewDate(review);
-            const replied = review.reviewReply ? 'replied' : 'unanswered';
-            lines.push(`- ${name} (${rating}, ${date}, ${location}, ${replied})`);
-            // Full review text, no truncation — collapse whitespace only so the
-            // bullet list stays readable for multi-paragraph reviews.
-            if (review.comment) {
-                lines.push(`  ${review.comment.replace(/\s+/g, ' ').trim()}`);
-            }
+        return lines.join('\n');
+    }
+    const header = [`Google Business reviews (showing ${result.reviews.length} of ${result.total} matching`];
+    if (offset > 0)
+        header.push(`, from offset ${offset}`);
+    if (typeof result.total_review_count === 'number') {
+        header.push(`; ${result.total_review_count} total on Google`);
+    }
+    header.push('):');
+    const lines = [header.join('')];
+    for (const location of locations) {
+        if (location.error) {
+            lines.push(`! ${location.business_name || location.name || location.location_id || 'location'}: ${location.error}`);
         }
-        if (result.has_more) {
-            const nextOffset = offset + result.reviews.length;
-            lines.push('', `More reviews available — call again with offset: ${nextOffset} to continue.`);
+    }
+    lines.push('');
+    for (const review of result.reviews) {
+        const name = review.reviewer?.displayName || 'Anonymous';
+        const rating = review.starRating ? `${review.starRating} stars` : 'unrated';
+        const location = review.businessName || review.locationName || review.locationId || 'location';
+        const date = formatReviewDate(review);
+        const replied = review.reviewReply ? 'replied' : 'unanswered';
+        lines.push(`- ${name} (${rating}, ${date}, ${location}, ${replied})`);
+        // Full review text, no truncation; collapse whitespace only so the
+        // bullet list stays readable for multi-paragraph reviews.
+        if (review.comment) {
+            lines.push(`  ${review.comment.replace(/\s+/g, ' ').trim()}`);
         }
-        lines.push('', 'Locations:', ...locations.map((location) => formatLocationLine(location)));
-        return lines.join('\n');
-    },
-};
+    }
+    if (result.has_more) {
+        const nextOffset = offset + result.reviews.length;
+        lines.push('', `More reviews available. Call again with offset: ${nextOffset} to continue.`);
+    }
+    lines.push('', 'Locations:', ...locations.map((location) => formatLocationLine(location)));
+    return lines.join('\n');
+}
+async function reviewLink(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');
+}
 /**
  * When a review was written, plus when it was last edited if that differs.
  * The list is ordered by last activity (updateTime), so showing only the

package/dist/tools/list-jobs.d.ts

@@ -0,0 +1,60 @@
+import { z } from 'zod';
+import type { PosterlyClient } from '../lib/api-client.js';
+import { type ToolContext } from '../lib/tool-runtime.js';
+type JobsInput = {
+    type: 'image' | 'video';
+    job_id?: string;
+    status?: string;
+    limit?: number;
+};
+export declare const listJobsTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        type: z.ZodEnum<["image", "video"]>;
+        job_id: z.ZodOptional<z.ZodString>;
+        status: z.ZodOptional<z.ZodEnum<["pending", "processing", "completed", "failed", "dismissed"]>>;
+        limit: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    }, "strip", z.ZodTypeAny, {
+        type: "image" | "video";
+        status?: "failed" | "pending" | "dismissed" | "completed" | "processing" | undefined;
+        limit?: number | undefined;
+        job_id?: string | undefined;
+    }, {
+        type: "image" | "video";
+        status?: "failed" | "pending" | "dismissed" | "completed" | "processing" | undefined;
+        limit?: number | undefined;
+        job_id?: string | undefined;
+    }>;
+    /** The old tools' exact input schemas, for alias calls (see alias-transport.ts). */
+    legacySchemas: {
+        get_image_job: z.ZodObject<{
+            job_id: z.ZodOptional<z.ZodString>;
+            status: z.ZodOptional<z.ZodEnum<["pending", "processing", "completed", "failed"]>>;
+            limit: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+        }, "strip", z.ZodTypeAny, {
+            status?: "failed" | "pending" | "completed" | "processing" | undefined;
+            limit?: number | undefined;
+            job_id?: string | undefined;
+        }, {
+            status?: "failed" | "pending" | "completed" | "processing" | undefined;
+            limit?: number | undefined;
+            job_id?: string | undefined;
+        }>;
+        get_video_job: z.ZodObject<{
+            job_id: z.ZodOptional<z.ZodString>;
+            status: z.ZodOptional<z.ZodEnum<["pending", "processing", "completed", "failed", "dismissed"]>>;
+            limit: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+        }, "strip", z.ZodTypeAny, {
+            status?: "failed" | "pending" | "dismissed" | "completed" | "processing" | undefined;
+            limit?: number | undefined;
+            job_id?: string | undefined;
+        }, {
+            status?: "failed" | "pending" | "dismissed" | "completed" | "processing" | undefined;
+            limit?: number | undefined;
+            job_id?: string | undefined;
+        }>;
+    };
+    execute(client: PosterlyClient, input: JobsInput, ctx: ToolContext): Promise<string>;
+};
+export {};

package/dist/tools/list-jobs.js

@@ -0,0 +1,81 @@
+import { z } from 'zod';
+import { validateArgs } from '../lib/tool-runtime.js';
+export const listJobsTool = {
+    name: 'list_jobs',
+    description: 'AI generation jobs. type=image: one image job by job_id, or recent image jobs when job_id is omitted (filter by status, limit); poll it after generate_image for the finished urls. type=video: one Veo or Grok video job by job_id, or recent video jobs (status includes dismissed, limit); poll it after generate_video for the finished video_url.',
+    inputSchema: z.object({
+        type: z.enum(['image', 'video']).describe('image or video.'),
+        job_id: z.string().optional().describe('One job. Leave out to list recent jobs.'),
+        status: z
+            .enum(['pending', 'processing', 'completed', 'failed', 'dismissed'])
+            .optional()
+            .describe('Filter a job list. dismissed is video only.'),
+        limit: z.number().int().min(1).max(50).default(10).optional(),
+    }),
+    /** The old tools' exact input schemas, for alias calls (see alias-transport.ts). */
+    legacySchemas: {
+        get_image_job: z.object({
+            job_id: z.string().optional(),
+            status: z.enum(['pending', 'processing', 'completed', 'failed']).optional(),
+            limit: z.number().int().min(1).max(50).default(10).optional(),
+        }),
+        get_video_job: z.object({
+            job_id: z.string().optional(),
+            status: z.enum(['pending', 'processing', 'completed', 'failed', 'dismissed']).optional(),
+            limit: z.number().int().min(1).max(50).default(10).optional(),
+        }),
+    },
+    async execute(client, input, ctx) {
+        const { mode, args } = validateArgs(ctx, 'list_jobs', input);
+        if (args.job_id) {
+            const extra = ['status', 'limit'].filter((key) => args[key] !== undefined);
+            if (extra.length) {
+                throw new Error(`${extra.join(' and ')} cannot be combined with job_id. Pass job_id alone for one job, or leave it out to list recent jobs.`);
+            }
+        }
+        const params = { job_id: args.job_id, status: args.status, limit: args.limit };
+        return mode === 'video' ? videoJobs(client, params) : imageJobs(client, params);
+    },
+};
+async function imageJobs(client, input) {
+    const result = await client.getImageJob(input);
+    if (result.job)
+        return formatImageJob(result.job, true);
+    const jobs = result.jobs || [];
+    return [
+        `Image jobs (${jobs.length})`,
+        jobs.map((job) => formatImageJob(job, false)).join('\n\n'),
+    ].filter(Boolean).join('\n');
+}
+async function videoJobs(client, input) {
+    const result = await client.getVideoJob(input);
+    if (result.job)
+        return formatVideoJob(result.job, true);
+    const jobs = result.jobs || [];
+    return [
+        `Video jobs (${jobs.length})`,
+        jobs.map((job) => formatVideoJob(job, false)).join('\n\n'),
+    ].filter(Boolean).join('\n');
+}
+function formatImageJob(job, includeRaw) {
+    const lines = [
+        `${job.id}: ${job.status}`,
+        `Prompt: ${job.prompt}`,
+        `Model: ${job.model}; resolution: ${job.resolution}; thinking: ${job.thinking_level || 'n/a'}; cost: ${job.credit_cost}`,
+        job.urls?.length ? `URLs: ${job.urls.join(', ')}` : 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');
+}
+function formatVideoJob(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');
+}

package/dist/tools/list-platforms.d.ts

@@ -1,16 +1,75 @@
 import { z } from 'zod';
 import type { PosterlyClient } from '../lib/api-client.js';
+import { type ToolContext } from '../lib/tool-runtime.js';
+type ListPlatformsInput = {
+    view?: 'platforms' | 'schema' | 'connect_link';
+    include_planned?: boolean;
+    account_id?: string;
+    platform?: string;
+    target?: string;
+    workspace_id?: string;
+    debug?: boolean;
+};
 export declare const listPlatformsTool: {
     name: string;
     description: string;
     inputSchema: z.ZodObject<{
+        view: z.ZodOptional<z.ZodEnum<["platforms", "schema", "connect_link"]>>;
+        account_id: z.ZodOptional<z.ZodString>;
+        platform: z.ZodOptional<z.ZodEnum<["bluesky", "devto", "discord", "facebook", "gmb", "google-business", "google_business", "google_business_profile", "hashnode", "instagram", "instagram-standalone", "lemmy", "linkedin", "mastodon", "medium", "pinterest", "reddit", "skool", "slack", "telegram", "threads", "tiktok", "twitter", "whop", "wordpress", "x", "youtube"]>>;
+        target: z.ZodOptional<z.ZodEnum<["bluesky", "devto", "discord", "facebook", "facebook_instagram", "facebook_pages", "gmb", "google-business", "google_business", "google_business_profile", "hashnode", "instagram", "instagram-standalone", "instagram_direct", "lemmy", "linkedin", "linkedin-company", "linkedin-page", "linkedin_company", "linkedin_page", "linkedin_personal", "mastodon", "medium", "meta", "meta_business", "pinterest", "reddit", "skool", "slack", "telegram", "threads", "tiktok", "twitter", "whop", "wordpress", "x", "x_twitter", "youtube"]>>;
+        workspace_id: z.ZodOptional<z.ZodString>;
         include_planned: z.ZodOptional<z.ZodBoolean>;
+        debug: z.ZodOptional<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
+        platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "medium" | "x" | "telegram" | "bluesky" | "discord" | "wordpress" | "devto" | "hashnode" | "lemmy" | "slack" | "mastodon" | "reddit" | "skool" | "whop" | "gmb" | "google-business" | "google_business_profile" | undefined;
+        workspace_id?: string | undefined;
         include_planned?: boolean | undefined;
+        account_id?: string | undefined;
+        view?: "platforms" | "schema" | "connect_link" | undefined;
+        debug?: boolean | undefined;
+        target?: "meta" | "instagram_direct" | "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "medium" | "x" | "telegram" | "bluesky" | "discord" | "wordpress" | "devto" | "hashnode" | "lemmy" | "slack" | "mastodon" | "reddit" | "skool" | "whop" | "gmb" | "google-business" | "google_business_profile" | "linkedin_page" | "facebook_instagram" | "facebook_pages" | "linkedin-company" | "linkedin-page" | "linkedin_company" | "linkedin_personal" | "meta_business" | "x_twitter" | undefined;
     }, {
+        platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "medium" | "x" | "telegram" | "bluesky" | "discord" | "wordpress" | "devto" | "hashnode" | "lemmy" | "slack" | "mastodon" | "reddit" | "skool" | "whop" | "gmb" | "google-business" | "google_business_profile" | undefined;
+        workspace_id?: string | undefined;
         include_planned?: boolean | undefined;
+        account_id?: string | undefined;
+        view?: "platforms" | "schema" | "connect_link" | undefined;
+        debug?: boolean | undefined;
+        target?: "meta" | "instagram_direct" | "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "medium" | "x" | "telegram" | "bluesky" | "discord" | "wordpress" | "devto" | "hashnode" | "lemmy" | "slack" | "mastodon" | "reddit" | "skool" | "whop" | "gmb" | "google-business" | "google_business_profile" | "linkedin_page" | "facebook_instagram" | "facebook_pages" | "linkedin-company" | "linkedin-page" | "linkedin_company" | "linkedin_personal" | "meta_business" | "x_twitter" | undefined;
     }>;
-    execute(client: PosterlyClient, input: {
-        include_planned?: boolean;
-    }): Promise<string>;
+    /** The old tools' exact input schemas, for alias calls (see alias-transport.ts). */
+    legacySchemas: {
+        get_platform_schema: z.ZodObject<{
+            account_id: z.ZodOptional<z.ZodString>;
+            platform: z.ZodOptional<z.ZodEnum<["bluesky", "devto", "discord", "facebook", "gmb", "google-business", "google_business", "google_business_profile", "hashnode", "instagram", "instagram-standalone", "lemmy", "linkedin", "mastodon", "medium", "pinterest", "reddit", "skool", "slack", "telegram", "threads", "tiktok", "twitter", "whop", "wordpress", "x", "youtube"]>>;
+            include_planned: z.ZodOptional<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "medium" | "x" | "telegram" | "bluesky" | "discord" | "wordpress" | "devto" | "hashnode" | "lemmy" | "slack" | "mastodon" | "reddit" | "skool" | "whop" | "gmb" | "google-business" | "google_business_profile" | undefined;
+            include_planned?: boolean | undefined;
+            account_id?: string | undefined;
+        }, {
+            platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "medium" | "x" | "telegram" | "bluesky" | "discord" | "wordpress" | "devto" | "hashnode" | "lemmy" | "slack" | "mastodon" | "reddit" | "skool" | "whop" | "gmb" | "google-business" | "google_business_profile" | undefined;
+            include_planned?: boolean | undefined;
+            account_id?: string | undefined;
+        }>;
+        get_connect_link: z.ZodObject<{
+            platform: z.ZodOptional<z.ZodEnum<["bluesky", "devto", "discord", "facebook", "facebook_instagram", "facebook_pages", "gmb", "google-business", "google_business", "google_business_profile", "hashnode", "instagram", "instagram-standalone", "instagram_direct", "lemmy", "linkedin", "linkedin-company", "linkedin-page", "linkedin_company", "linkedin_page", "linkedin_personal", "mastodon", "medium", "meta", "meta_business", "pinterest", "reddit", "skool", "slack", "telegram", "threads", "tiktok", "twitter", "whop", "wordpress", "x", "x_twitter", "youtube"]>>;
+            workspace_id: z.ZodOptional<z.ZodString>;
+            include_planned: z.ZodOptional<z.ZodBoolean>;
+            debug: z.ZodOptional<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            platform?: "meta" | "instagram_direct" | "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "medium" | "x" | "telegram" | "bluesky" | "discord" | "wordpress" | "devto" | "hashnode" | "lemmy" | "slack" | "mastodon" | "reddit" | "skool" | "whop" | "gmb" | "google-business" | "google_business_profile" | "linkedin_page" | "facebook_instagram" | "facebook_pages" | "linkedin-company" | "linkedin-page" | "linkedin_company" | "linkedin_personal" | "meta_business" | "x_twitter" | undefined;
+            workspace_id?: string | undefined;
+            include_planned?: boolean | undefined;
+            debug?: boolean | undefined;
+        }, {
+            platform?: "meta" | "instagram_direct" | "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "medium" | "x" | "telegram" | "bluesky" | "discord" | "wordpress" | "devto" | "hashnode" | "lemmy" | "slack" | "mastodon" | "reddit" | "skool" | "whop" | "gmb" | "google-business" | "google_business_profile" | "linkedin_page" | "facebook_instagram" | "facebook_pages" | "linkedin-company" | "linkedin-page" | "linkedin_company" | "linkedin_personal" | "meta_business" | "x_twitter" | undefined;
+            workspace_id?: string | undefined;
+            include_planned?: boolean | undefined;
+            debug?: boolean | undefined;
+        }>;
+    };
+    execute(client: PosterlyClient, input: ListPlatformsInput, ctx: ToolContext): Promise<string>;
 };
+export {};

package/dist/tools/list-platforms.js

@@ -1,20 +1,129 @@
 import { z } from 'zod';
-import { PLANNED_PLATFORM_IDS } from '../generated/platform-manifest.js';
+import { ALL_PLATFORM_INPUTS, CONNECT_INPUTS, PLANNED_PLATFORM_IDS, SUPPORTED_PLATFORM_IDS } from '../generated/platform-manifest.js';
+import { validateArgs } from '../lib/tool-runtime.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.',
+    description: 'Platforms, settings schemas, and connection links. view=platforms (default): posterly platform integrations, posting capabilities, content/media limits, settings schemas, helper tools, and analytics support (include_planned shows future integration possibilities). view=schema: the settings schema for one connected account_id (preferred: returns connection-specific capabilities, needed before Instagram native tags/collaborators) or one platform; account_id wins if both are given. view=connect_link: dashboard handoff links and readiness for every target, or one target (instagram, meta, linkedin_page, twitter, telegram, reddit, wordpress, ...); use connection_url in a logged-in browser (direct OAuth URLs are intentionally not exposed); credential platforms show the credential_fields that connect_account needs.',
     inputSchema: z.object({
+        view: z
+            .enum(['platforms', 'schema', 'connect_link'])
+            .optional()
+            .describe('platforms (default), schema, or connect_link.'),
+        account_id: z
+            .string()
+            .optional()
+            .describe('view=schema: connected account ID from list_accounts. Preferred because it returns account context.'),
+        platform: z
+            .enum(ALL_PLATFORM_INPUTS)
+            .optional()
+            .describe(`view=schema: platform ID such as ${SUPPORTED_PLATFORM_IDS.join(', ')}. Set include_planned to inspect planned providers.`),
+        target: z
+            .enum(CONNECT_INPUTS)
+            .optional()
+            .describe('view=connect_link: connection target such as instagram, meta, linkedin_page, twitter, x, google_business, telegram, reddit, or wordpress. Omit to list live connection targets.'),
+        workspace_id: z
+            .string()
+            .optional()
+            .describe('view=connect_link: filter connected account counts to a workspace.'),
         include_planned: z
             .boolean()
             .optional()
             .describe(`Include planned integrations such as ${PLANNED_PLATFORM_IDS.join(', ')}.`),
+        debug: z
+            .boolean()
+            .optional()
+            .describe('view=connect_link: when true, include the raw connect option JSON for debugging. Keep false for normal user-facing agent flows.'),
     }),
-    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')}`;
+    /** The old tools' exact input schemas, for alias calls (see alias-transport.ts). */
+    legacySchemas: {
+        get_platform_schema: z.object({
+            account_id: z.string().optional(),
+            platform: z.enum(ALL_PLATFORM_INPUTS).optional(),
+            include_planned: z.boolean().optional(),
+        }),
+        get_connect_link: z.object({
+            platform: z.enum(CONNECT_INPUTS).optional(),
+            workspace_id: z.string().optional(),
+            include_planned: z.boolean().optional(),
+            debug: z.boolean().optional(),
+        }),
+    },
+    async execute(client, input, ctx) {
+        const { mode, args } = validateArgs(ctx, 'list_platforms', input);
+        if (mode === 'schema')
+            return platformSchema(client, args);
+        if (mode === 'connect_link')
+            return connectLink(client, args);
+        return platforms(client, args);
     },
 };
+async function platforms(client, input) {
+    const result = await client.listPlatforms({ include_planned: input.include_planned });
+    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')}`;
+}
+async function platformSchema(client, input) {
+    const result = await client.getPlatformSchema({ account_id: input.account_id, platform: input.platform, include_planned: input.include_planned });
+    const schema = result.schema || result.platform || result.platforms?.[0];
+    if (!schema)
+        return JSON.stringify(result, null, 2);
+    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`
+        : '';
+    const instagramTaggingLine = result.account?.instagram_tagging
+        ? `Instagram tagging capabilities: ${JSON.stringify(result.account.instagram_tagging)}`
+        : '';
+    return [
+        `${schema.label} (${schema.id}) schema`,
+        accountLine.trim(),
+        instagramTaggingLine,
+        `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'}`,
+        fields.length
+            ? `Settings:\n${fields.map((field) => `• ${field.key}${field.required ? ' (required)' : ''}: ${field.description}`).join('\n')}`
+            : '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 || {})}`,
+    ].filter(Boolean).join('\n');
+}
+async function connectLink(client, input) {
+    const { debug } = input;
+    const result = await client.getConnectLink({
+        platform: input.target,
+        workspace_id: input.workspace_id,
+        include_planned: input.include_planned,
+    });
+    if (result.connect) {
+        return formatConnectOption(result.connect, Boolean(debug));
+    }
+    const options = result.connect_options || [];
+    const lines = options.map((option) => formatConnectOption(option, false));
+    return `posterly connection options (${options.length}):\n${lines.join('\n\n')}`;
+}
+function formatConnectOption(option, includeRaw) {
+    const missing = option.missing_env?.length
+        ? `missing env: ${option.missing_env.map((group) => group.join(' or ')).join(', ')}`
+        : 'configured';
+    const accounts = option.connected_count ?? option.connected_accounts?.length ?? 0;
+    const fields = option.credential_fields?.length
+        ? `; 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)}` : '';
+    return [
+        `${option.label} (${option.platform})`,
+        `Status: ${option.status}; method: ${option.method}; ${missing}; connected accounts: ${accounts}`,
+        `Connection URL: ${option.connection_url || 'not available'}${fields}${scopes}`,
+        raw,
+    ].join('\n');
+}

package/dist/tools/list-posts.d.ts

@@ -12,7 +12,7 @@ export declare const listPostsTool: {
         approval_status: z.ZodOptional<z.ZodEnum<["none", "pending_client", "approved", "changes_requested", "rejected"]>>;
         brand_id: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "x" | "telegram" | "bluesky" | "discord" | "slack" | "mastodon" | "devto" | "hashnode" | "wordpress" | "lemmy" | "gmb" | "google-business" | "google_business_profile" | undefined;
+        platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "x" | "telegram" | "bluesky" | "discord" | "wordpress" | "devto" | "hashnode" | "lemmy" | "slack" | "mastodon" | "gmb" | "google-business" | "google_business_profile" | undefined;
         status?: string | undefined;
         workspace_id?: string | undefined;
         account_id?: string | undefined;
@@ -20,7 +20,7 @@ export declare const listPostsTool: {
         approval_status?: "none" | "pending_client" | "approved" | "changes_requested" | "rejected" | undefined;
         brand_id?: string | undefined;
     }, {
-        platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "x" | "telegram" | "bluesky" | "discord" | "slack" | "mastodon" | "devto" | "hashnode" | "wordpress" | "lemmy" | "gmb" | "google-business" | "google_business_profile" | undefined;
+        platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "x" | "telegram" | "bluesky" | "discord" | "wordpress" | "devto" | "hashnode" | "lemmy" | "slack" | "mastodon" | "gmb" | "google-business" | "google_business_profile" | undefined;
         status?: string | undefined;
         workspace_id?: string | undefined;
         account_id?: string | undefined;