posterly-mcp-server 0.44.0 → 0.45.1

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

@@ -1,243 +0,0 @@
-import { z } from 'zod';
-import type { PostAnalyticsResponse, PostAnalyticsRow, PosterlyClient } from '../lib/api-client.js';
-
-const presentationSchema = z.enum(['compact', 'table', 'json']).optional();
-type AnalyticsPresentation = z.infer<typeof presentationSchema>;
-
-export const getPostAnalyticsTool = {
-  name: 'get_post_analytics',
-  description:
-    'Get per-post engagement metrics (likes, comments/replies, reach, impressions/views, saves, shares, reposts, quotes, plays, clicks, watch time) for a connected social account. Supports Instagram, Facebook, LinkedIn, Google Business Profile, Pinterest, YouTube, and Threads. Returns the most recent posts first. presentation controls output: compact for Telegram/mobile, table for Markdown clients, json for custom chart/card renderers.',
-  inputSchema: z.object({
-    account_id: z
-      .number()
-      .describe('The social account ID (from list_accounts)'),
-    from: z
-      .string()
-      .optional()
-      .describe('Start date (ISO date, e.g. 2026-03-19). Defaults to 30 days ago.'),
-    to: z
-      .string()
-      .optional()
-      .describe('End date (ISO date). Defaults to today.'),
-    limit: z
-      .number()
-      .min(1)
-      .max(200)
-      .optional()
-      .describe('Number of posts to return (default 50, max 200)'),
-    offset: z.number().min(0).optional().describe('Pagination offset'),
-    presentation: presentationSchema.describe('Output style: compact bullets, Markdown table, or raw JSON for client-side chart/card rendering.'),
-  }),
-
-  async execute(
-    client: PosterlyClient,
-    input: {
-      account_id: number;
-      from?: string;
-      to?: string;
-      limit?: number;
-      offset?: number;
-      presentation?: AnalyticsPresentation;
-    }
-  ) {
-    const result = await client.getPostAnalytics(input);
-    return formatPostAnalytics(result, input.presentation || 'compact');
-  },
-};
-
-function formatPostAnalytics(result: PostAnalyticsResponse, presentation: Exclude<AnalyticsPresentation, undefined>): string {
-  const { account, range, posts, total } = result;
-
-  if (posts.length === 0) {
-    return `No analytics found for ${accountLabel(account.username)} (${account.platform}) between ${range.from} and ${range.to}.`;
-  }
-
-  const totals = posts.reduce((acc, post) => {
-    acc.likes += post.likes || 0;
-    acc.comments += post.comments || 0;
-    acc.reach += post.reach || 0;
-    acc.impressions += post.impressions || 0;
-    acc.shares += post.shares || 0;
-    acc.reposts += post.reposts || 0;
-    acc.quotes += post.quotes || 0;
-    acc.saves += post.saved || 0;
-    return acc;
-  }, { likes: 0, comments: 0, reach: 0, impressions: 0, shares: 0, reposts: 0, quotes: 0, saves: 0 });
-  const isThreads = account.platform === 'threads';
-
-  if (presentation === 'json') {
-    return JSON.stringify({
-      type: 'post_analytics',
-      account,
-      range,
-      returned: {
-        count: posts.length,
-        total,
-      },
-      totals,
-      posts,
-    }, null, 2);
-  }
-
-  if (presentation === 'table') {
-    if (isThreads) {
-      return [
-        `**📈 Post analytics for ${accountLabel(account.username)} (${account.id})**`,
-        `_Threads · ${range.from} → ${range.to} · showing ${posts.length} of ${total}_`,
-        '',
-        '**Returned totals**',
-        markdownTable(['Views', 'Likes', 'Replies', 'Reposts', 'Quotes', 'Shares'], [[
-          formatNumber(totals.impressions),
-          formatNumber(totals.likes),
-          formatNumber(totals.comments),
-          formatNumber(totals.reposts),
-          formatNumber(totals.quotes),
-          formatNumber(totals.shares),
-        ]]),
-        '',
-        '**Posts**',
-        markdownTable(['Posted', 'Post', 'Caption', 'Views', 'Likes', 'Replies', 'Reposts', 'Quotes', 'Shares'], posts.map((post) => [
-          dateTime(post.posted_at),
-          post.id ? String(post.id) : post.platform_media_id,
-          compact(post.caption_snippet, 70) || '(no caption)',
-          formatNumber(post.impressions),
-          formatNumber(post.likes),
-          formatNumber(post.comments),
-          formatNumber(post.reposts),
-          formatNumber(post.quotes),
-          formatNumber(post.shares),
-        ])),
-      ].join('\n');
-    }
-
-    return [
-      `**📈 Post analytics for ${accountLabel(account.username)} (${account.id})**`,
-      `_${account.platform} · ${range.from} → ${range.to} · showing ${posts.length} of ${total}_`,
-      '',
-      '**Returned totals**',
-      markdownTable(['Likes', 'Comments', 'Reach', 'Impressions', 'Shares', 'Saves'], [[
-        formatNumber(totals.likes),
-        formatNumber(totals.comments),
-        formatNumber(totals.reach),
-        formatNumber(totals.impressions),
-        formatNumber(totals.shares),
-        formatNumber(totals.saves),
-      ]]),
-      '',
-      '**Posts**',
-      markdownTable(['Posted', 'Post', 'Caption', 'Reach', 'Likes', 'Comments', 'Extras'], posts.map((post) => [
-        dateTime(post.posted_at),
-        post.id ? String(post.id) : post.platform_media_id,
-        compact(post.caption_snippet, 70) || '(no caption)',
-        formatNumber(post.reach),
-        formatNumber(post.likes),
-        formatNumber(post.comments),
-        postExtras(account.platform, post),
-      ])),
-    ].join('\n');
-  }
-
-  const lines: string[] = [
-    `**📈 Post analytics for ${accountLabel(account.username)} (${account.id})**`,
-    `_${account.platform} · ${range.from} → ${range.to} · showing ${posts.length} of ${total}_`,
-    '',
-    '**Returned totals**',
-    `- **Likes:** ${formatNumber(totals.likes)}`,
-    `- **Comments:** ${formatNumber(totals.comments)}`,
-    `- **Reach:** ${formatNumber(totals.reach)}`,
-    `- **Impressions:** ${formatNumber(totals.impressions)}`,
-    `- **Shares:** ${formatNumber(totals.shares)}`,
-    `- **Saves:** ${formatNumber(totals.saves)}`,
-    '',
-    '**Posts**',
-  ];
-
-  if (isThreads) {
-    const threadLines: string[] = [
-      `**📈 Post analytics for ${accountLabel(account.username)} (${account.id})**`,
-      `_Threads · ${range.from} → ${range.to} · showing ${posts.length} of ${total}_`,
-      '',
-      '**Returned totals**',
-      `- **Views:** ${formatNumber(totals.impressions)}`,
-      `- **Likes:** ${formatNumber(totals.likes)}`,
-      `- **Replies:** ${formatNumber(totals.comments)}`,
-      `- **Reposts:** ${formatNumber(totals.reposts)}`,
-      `- **Quotes:** ${formatNumber(totals.quotes)}`,
-      `- **Shares:** ${formatNumber(totals.shares)}`,
-      '',
-      '**Posts**',
-    ];
-    posts.forEach((post, index) => {
-      threadLines.push(`${index + 1}. **${compact(post.caption_snippet, 70) || '(no caption)'}**`);
-      threadLines.push(`   Posted: ${dateTime(post.posted_at)}`);
-      threadLines.push(`   Post ID: ${post.id ? String(post.id) : post.platform_media_id}`);
-      threadLines.push(`   Views: ${formatNumber(post.impressions)}`);
-      threadLines.push(`   Likes: ${formatNumber(post.likes)}`);
-      threadLines.push(`   Replies: ${formatNumber(post.comments)}`);
-      threadLines.push(`   Reposts: ${formatNumber(post.reposts)}`);
-      threadLines.push(`   Quotes: ${formatNumber(post.quotes)}`);
-      threadLines.push(`   Shares: ${formatNumber(post.shares)}`);
-      if (post.permalink) threadLines.push(`   Permalink: ${post.permalink}`);
-    });
-    return threadLines.join('\n');
-  }
-
-  posts.forEach((post, index) => {
-    lines.push(`${index + 1}. **${compact(post.caption_snippet, 70) || '(no caption)'}**`);
-    lines.push(`   Posted: ${dateTime(post.posted_at)}`);
-    lines.push(`   Post ID: ${post.id ? String(post.id) : post.platform_media_id}`);
-    lines.push(`   Reach: ${formatNumber(post.reach)}`);
-    lines.push(`   Likes: ${formatNumber(post.likes)}`);
-    lines.push(`   Comments: ${formatNumber(post.comments)}`);
-    lines.push(`   Extras: ${postExtras(account.platform, post)}`);
-  });
-
-  return lines.join('\n');
-}
-
-function postExtras(platform: string, post: PostAnalyticsRow): string {
-  const metrics: string[] = [];
-  if (post.impressions) metrics.push(`${formatNumber(post.impressions)} impressions`);
-  if (post.saved) metrics.push(`${formatNumber(post.saved)} saved`);
-  if (platform !== 'threads' && post.shares) metrics.push(`${formatNumber(post.shares)} shares`);
-  if (post.plays) metrics.push(`${formatNumber(post.plays)} plays`);
-  if (platform === 'youtube' && post.total_watch_time_ms) metrics.push(`${formatNumber(Math.round(post.total_watch_time_ms / 60000))} watch minutes`);
-  if (platform === 'youtube' && post.avg_watch_time_ms) metrics.push(`${formatNumber(Math.round(post.avg_watch_time_ms / 1000))}s avg view`);
-  if (post.url_link_clicks) metrics.push(platform === 'pinterest' ? `${formatNumber(post.url_link_clicks)} outbound clicks` : `${formatNumber(post.url_link_clicks)} link clicks`);
-  if (post.user_profile_clicks) metrics.push(platform === 'pinterest' ? `${formatNumber(post.user_profile_clicks)} pin clicks` : `${formatNumber(post.user_profile_clicks)} profile clicks`);
-  if (post.permalink) metrics.push(post.permalink);
-  return metrics.join(' · ') || 'n/a';
-}
-
-function accountLabel(username: string): string {
-  if (!username) return 'account';
-  return username.startsWith('@') || /\s/.test(username) ? username : `@${username}`;
-}
-
-function dateTime(value: string | null): string {
-  if (!value) return 'n/a';
-  const date = new Date(value);
-  return Number.isNaN(date.getTime()) ? value : date.toLocaleString();
-}
-
-function compact(value: string | null, maxLength: number): string {
-  const text = String(value || '').replace(/\s+/g, ' ').trim();
-  return text.length > maxLength ? `${text.slice(0, Math.max(0, maxLength - 1))}…` : text;
-}
-
-function formatNumber(value: number | null | undefined): string {
-  return value == null ? 'n/a' : value.toLocaleString();
-}
-
-function markdownTable(headers: string[], rows: string[][]): string {
-  return [
-    `| ${headers.map(escapeCell).join(' | ')} |`,
-    `| ${headers.map(() => '---').join(' | ')} |`,
-    ...rows.map((row) => `| ${row.map(escapeCell).join(' | ')} |`),
-  ].join('\n');
-}
-
-function escapeCell(value: string): string {
-  return String(value).replace(/\|/g, '\\|').replace(/\r?\n/g, '<br>');
-}

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

@@ -1,60 +0,0 @@
-import { z } from 'zod';
-import type { PosterlyClient } from '../lib/api-client.js';
-import { mdTitle, mdSection, mdKeyValue, mdEmpty, truncateText, formatDateTime } from '../lib/format.js';
-
-export const getPostInsightsTool = {
-  name: 'get_post_insights',
-  description:
-    'List per-post feedback insights from the posterly performance feedback loop: for recently published posts, the performance tier (great/good/mixed/poor), a diagnosis, a suggested next action, metrics, and the baseline it was compared against. Filter by account_id, post_id, and checkpoint (1h, 6h, 24h, 72h, 7d). Read-only; requires a Pro plan or higher.',
-  inputSchema: z.object({
-    account_id: z
-      .union([z.string(), z.number()])
-      .optional()
-      .describe('Filter to one social account ID (from list_accounts).'),
-    post_id: z.number().int().positive().optional().describe('Filter to one post ID.'),
-    checkpoint: z
-      .enum(['1h', '6h', '24h', '72h', '7d'])
-      .optional()
-      .describe('Filter to one checkpoint after publish.'),
-    limit: z.number().int().min(1).max(100).optional().describe('Max insights to return (default 20).'),
-  }),
-
-  async execute(
-    client: PosterlyClient,
-    input: {
-      account_id?: string | number;
-      post_id?: number;
-      checkpoint?: '1h' | '6h' | '24h' | '72h' | '7d';
-      limit?: number;
-    },
-  ) {
-    const { insights } = await client.getPostInsights(input);
-
-    if (!insights.length) {
-      return mdEmpty(
-        'feedback insights',
-        'No per-post feedback insights are available for these filters yet. Insights appear as posts hit their 1h, 6h, 24h, 72h, and 7d checkpoints.',
-      );
-    }
-
-    const blocks = insights.map((insight) => {
-      const heading = `${insight.title || 'Insight'} (${insight.performance_tier}, ${insight.checkpoint})`;
-      return mdSection(
-        heading,
-        mdKeyValue([
-          ['Post ID', insight.post_id],
-          ['Platform', insight.platform],
-          ['Account', insight.username ? `@${insight.username}` : String(insight.social_account_id)],
-          ['Diagnosis', truncateText(insight.diagnosis, 220)],
-          ['Next action', truncateText(insight.next_action, 220)],
-          ['Impact score', insight.impact_score],
-          ['Confidence', insight.confidence],
-          ['Published', formatDateTime(insight.published_at)],
-          ['Permalink', insight.permalink || undefined],
-        ]),
-      );
-    });
-
-    return [mdTitle(`Post feedback insights (${insights.length})`), ...blocks].join('\n\n');
-  },
-};

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

@@ -1,16 +0,0 @@
-import { z } from 'zod';
-import type { PosterlyClient } from '../lib/api-client.js';
-
-export const getPostMissingTool = {
-  name: 'get_post_missing',
-  description:
-    'Inspect whether a post is missing required content, media, account, platform settings, or metadata before it can publish. Use this to repair failed or imported posts.',
-  inputSchema: z.object({
-    post_id: z.number().int().positive().describe('The post ID to inspect.'),
-  }),
-
-  async execute(client: PosterlyClient, input: { post_id: number }) {
-    const result = await client.getPostMissing(input.post_id);
-    return JSON.stringify(result, null, 2);
-  },
-};

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

@@ -1,36 +0,0 @@
-import { z } from 'zod';
-import type { PosterlyClient, VideoJob } from '../lib/api-client.js';
-
-export const getVideoJobTool = {
-  name: 'get_video_job',
-  description:
-    'Get one Veo video generation job by ID, or list recent video jobs when job_id is omitted. Use after generate_video to poll for completed video_url.',
-  inputSchema: 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: PosterlyClient, input: { job_id?: string; status?: string; limit?: number }) {
-    const result = await client.getVideoJob(input);
-    if (result.job) return formatJob(result.job, true);
-
-    const jobs = result.jobs || [];
-    return [
-      `Video jobs (${jobs.length})`,
-      jobs.map((job) => formatJob(job, false)).join('\n\n'),
-    ].filter(Boolean).join('\n');
-  },
-};
-
-function formatJob(job: VideoJob, includeRaw: boolean): string {
-  const lines = [
-    `${job.id}: ${job.status}`,
-    `Prompt: ${job.prompt}`,
-    `Model: ${job.model}; duration: ${job.duration_seconds}s; resolution: ${job.resolution || 'n/a'}; cost: ${job.credit_cost}`,
-    job.video_url ? `Video URL: ${job.video_url}` : null,
-    job.error_message ? `Error: ${job.error_message}` : null,
-    includeRaw ? `\nRaw job:\n${JSON.stringify(job, null, 2)}` : null,
-  ];
-  return lines.filter(Boolean).join('\n');
-}

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

@@ -1,36 +0,0 @@
-import { z } from 'zod';
-import type { PosterlyClient } from '../lib/api-client.js';
-import { code, mdEmpty, mdTable, mdTitle } from '../lib/format.js';
-
-export const listBrandAccountsTool = {
-  name: 'list_brand_accounts',
-  description:
-    'List the connected social accounts assigned to a brand/client. Use this when a user refers to a brand name rather than a raw account handle.',
-  inputSchema: z.object({
-    brand_id: z.string().describe('The brand ID to inspect (from list_brands).'),
-  }),
-
-  async execute(
-    client: PosterlyClient,
-    input: { brand_id: string },
-  ) {
-    const accounts = await client.listBrandAccounts(input.brand_id);
-
-    if (accounts.length === 0) {
-      return mdEmpty('brand accounts', 'No social accounts are currently assigned to this brand.');
-    }
-
-    return [
-      mdTitle(`Brand accounts (${accounts.length})`),
-      mdTable(
-        ['Platform', 'Account', 'Account ID', 'Workspace'],
-        accounts.map((account) => [
-          account.platform,
-          `@${account.username}`,
-          code(account.id),
-          account.workspace_id ? code(account.workspace_id) : 'default',
-        ]),
-      ),
-    ].join('\n\n');
-  },
-};

package/src/tools/reply-google-business-review.ts

@@ -1,32 +0,0 @@
-import { z } from 'zod';
-import type { PosterlyClient } from '../lib/api-client.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.',
-  inputSchema: z.object({
-    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.'),
-    review_name: z.string().min(1).describe('Full Google review resource name.'),
-    comment: z.string().min(1).max(4096).describe('Exact owner reply text to post.'),
-    confirm: z.literal(true).describe('Must be true after explicit user confirmation.'),
-  }),
-
-  async execute(
-    client: PosterlyClient,
-    input: {
-      workspace_id?: string;
-      account_id?: number;
-      location_id?: string;
-      review_name: string;
-      comment: string;
-      confirm: true;
-    },
-  ) {
-    const { confirm: _confirm, ...payload } = input;
-    const result = await client.replyGoogleBusinessReview(payload);
-    return result.message || 'Google Business review reply posted successfully.';
-  },
-};

package/src/tools/reply-to-comment.ts

@@ -1,30 +0,0 @@
-import { z } from 'zod';
-import type { PosterlyClient } from '../lib/api-client.js';
-
-export const replyToCommentTool = {
-  name: 'reply_to_comment',
-  description:
-    'Reply to an Instagram, Facebook Page, Threads, or LinkedIn Page inbox comment. WRITE: posts to the social network. Facebook has no private comment replies. Threads has no DMs, so only public replies. Instagram supports public or private. LinkedIn Page comments are public replies only. Requires a Pro plan or higher plus posts:write. Pass confirm=true only after explicit user confirmation.',
-  inputSchema: z.object({
-    comment_id: z.string().min(1).describe('Comment ID from list_comments.'),
-    content: z.string().min(1).describe('Reply text to post.'),
-    type: z.enum(['public', 'private']).optional().describe('public (default) or private. Private is Instagram only.'),
-    workspace_id: z.string().optional().describe('Optional. Omit to search every workspace you belong to; pass a workspace ID from whoami to limit to one.'),
-    confirm: z.literal(true).describe('Must be true after explicit user confirmation.'),
-  }),
-
-  async execute(
-    client: PosterlyClient,
-    input: {
-      comment_id: string;
-      content: string;
-      type?: 'public' | 'private';
-      workspace_id?: string;
-      confirm: true;
-    },
-  ) {
-    const { confirm: _confirm, ...payload } = input;
-    const result = await client.replyToComment(payload);
-    return `Comment reply sent (${result.reply_type}, reply_id ${result.reply_id}).`;
-  },
-};

package/src/tools/send-message.ts

@@ -1,28 +0,0 @@
-import { z } from 'zod';
-import type { PosterlyClient } from '../lib/api-client.js';
-
-export const sendMessageTool = {
-  name: 'send_message',
-  description:
-    'Send a DM reply in an Instagram or Facebook Page inbox conversation. WRITE: posts to the social network. Honor the 24-hour messaging window. Threads has no DMs. Requires a Pro plan or higher plus posts:write. Pass confirm=true only after explicit user confirmation.',
-  inputSchema: z.object({
-    conversation_id: z.string().min(1).describe('Conversation ID from list_conversations.'),
-    content: z.string().min(1).describe('Message text to send.'),
-    workspace_id: z.string().optional().describe('Optional. Omit to search every workspace you belong to; pass a workspace ID from whoami to limit to one.'),
-    confirm: z.literal(true).describe('Must be true after explicit user confirmation.'),
-  }),
-
-  async execute(
-    client: PosterlyClient,
-    input: {
-      conversation_id: string;
-      content: string;
-      workspace_id?: string;
-      confirm: true;
-    },
-  ) {
-    const { confirm: _confirm, ...payload } = input;
-    const result = await client.sendMessage(payload);
-    return `Message sent (message_id ${result.message_id}).`;
-  },
-};

package/src/tools/suggest-google-business-review-reply.ts

@@ -1,44 +0,0 @@
-import { z } from 'zod';
-import type { PosterlyClient } from '../lib/api-client.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.',
-  inputSchema: z.object({
-    workspace_id: z.string().optional().describe('Filter to a workspace ID from whoami.'),
-    account_id: z.number().int().positive().optional().describe('Optional Google Business account ID for brand voice context.'),
-    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.'),
-    review_text: z.string().optional().describe('Review text. Leave empty for rating-only reviews.'),
-    star_rating: z.number().min(1).max(5).describe('Review rating from 1 to 5.'),
-    reviewer_name: z.string().optional(),
-    business_name: z.string().optional(),
-    tone: z.enum(['professional', 'friendly', 'apologetic']).optional(),
-    count: z.number().int().min(1).max(5).optional(),
-  }),
-
-  async execute(
-    client: PosterlyClient,
-    input: {
-      workspace_id?: string;
-      account_id?: number;
-      location_id?: string;
-      review_text?: string;
-      star_rating: number;
-      reviewer_name?: string;
-      business_name?: string;
-      tone?: 'professional' | 'friendly' | 'apologetic';
-      count?: number;
-    },
-  ) {
-    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 [
-      `Suggested replies (${result.tone || 'professional'}, ${result.rating || input.star_rating} stars):`,
-      ...suggestions.map((text: string, index: number) => `${index + 1}. ${text}`),
-    ].join('\n');
-  },
-};

package/src/tools/sync-inbox.ts

@@ -1,28 +0,0 @@
-import { z } from 'zod';
-import type { PosterlyClient } from '../lib/api-client.js';
-
-export const syncInboxTool = {
-  name: 'sync_inbox',
-  description:
-    'Pull the latest Instagram, Facebook Page, Threads, or LinkedIn inbox data for one connected account. Honors a 30-second cooldown (60 seconds for LinkedIn). Threads and LinkedIn sync comments only (no DMs). Requires a Pro plan or higher plus posts:write.',
-  inputSchema: z.object({
-    account_id: z.number().int().positive().describe('Social account ID from list_accounts.'),
-    sync_type: z.enum(['all', 'dm', 'comments']).optional().describe('What to sync. Defaults to all. Threads and LinkedIn are comments-only.'),
-    workspace_id: z.string().optional().describe('Optional. Omit to use the connected account\'s own workspace; pass a workspace ID from whoami to require that specific workspace.'),
-  }),
-
-  async execute(
-    client: PosterlyClient,
-    input: {
-      account_id: number;
-      sync_type?: 'all' | 'dm' | 'comments';
-      workspace_id?: string;
-    },
-  ) {
-    const result = await client.syncInbox(input);
-    const parts = ['Inbox sync completed.'];
-    const keys = Object.keys(result.results || {});
-    if (keys.length > 0) parts.push(`Synced: ${keys.join(', ')}.`);
-    return parts.join(' ');
-  },
-};

package/src/tools/test-webhook.ts

@@ -1,18 +0,0 @@
-import { z } from 'zod';
-import type { PosterlyClient } from '../lib/api-client.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.',
-  inputSchema: z.object({
-    webhook_id: z.string().describe('Webhook ID from list_webhooks.'),
-    confirm: z.literal(true).describe('Must be true after the user explicitly confirms the test delivery.'),
-  }),
-
-  async execute(client: PosterlyClient, input: { webhook_id: string; confirm: true }) {
-    const result = await client.testWebhook(input.webhook_id);
-    const delivery = result.delivery || {};
-    return `Webhook test sent.\nDelivery: ${JSON.stringify(delivery, null, 2)}`;
-  },
-};

package/src/tools/update-comment.ts

@@ -1,31 +0,0 @@
-import { z } from 'zod';
-import type { PosterlyClient } from '../lib/api-client.js';
-
-export const updateCommentTool = {
-  name: 'update_comment',
-  description:
-    'Update an inbox comment: hide/unhide it on the platform, or mark it read/unread. Hide is reversible and does not delete the comment. Requires a Pro plan or higher plus posts:write.',
-  inputSchema: z.object({
-    comment_id: z.string().min(1).describe('Comment ID from list_comments.'),
-    is_hidden: z.boolean().optional().describe('Hide or unhide the comment on Instagram, Facebook, or Threads.'),
-    is_read: z.boolean().optional().describe('Mark the comment read or unread in posterly.'),
-    workspace_id: z.string().optional().describe('Optional. Omit to search every workspace you belong to; pass a workspace ID from whoami to limit to one.'),
-  }),
-
-  async execute(
-    client: PosterlyClient,
-    input: {
-      comment_id: string;
-      is_hidden?: boolean;
-      is_read?: boolean;
-      workspace_id?: string;
-    },
-  ) {
-    const result = await client.updateComment(input);
-    const comment = result.comment;
-    const parts = [`Comment ${String(comment.id)} updated.`];
-    if (typeof comment.is_hidden === 'boolean') parts.push(`Hidden: ${comment.is_hidden ? 'yes' : 'no'}.`);
-    if (typeof comment.is_read === 'boolean') parts.push(`Read: ${comment.is_read ? 'yes' : 'no'}.`);
-    return parts.join(' ');
-  },
-};

package/src/tools/update-oauth-client.ts

@@ -1,38 +0,0 @@
-import { z } from 'zod';
-import type { PosterlyClient } from '../lib/api-client.js';
-
-const scopeSchema = z.enum(['accounts:read', 'accounts:write', 'posts:read', 'posts:write', 'media:write', 'analytics:read']);
-
-export const updateOAuthClientTool = {
-  name: 'update_oauth_client',
-  description:
-    'Update a self-serve OAuth developer client. WRITE: confirm changed redirect URIs, scopes, and active state before calling.',
-  inputSchema: z.object({
-    client_id: z.string().min(1),
-    client_name: z.string().min(1).max(120).optional(),
-    description: z.string().max(500).optional(),
-    homepage: z.string().url().optional(),
-    allowed_redirect_uris: z.array(z.string().url()).min(1).max(10).optional(),
-    default_scopes: z.array(scopeSchema).min(1).optional(),
-    is_active: z.boolean().optional(),
-    confirm: z.literal(true).describe('Must be true after explicit user confirmation.'),
-  }),
-
-  async execute(
-    client: PosterlyClient,
-    input: {
-      client_id: string;
-      client_name?: string;
-      description?: string;
-      homepage?: string;
-      allowed_redirect_uris?: string[];
-      default_scopes?: string[];
-      is_active?: boolean;
-      confirm: true;
-    },
-  ) {
-    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}`;
-  },
-};