posterly-mcp-server 0.22.0 → 0.23.0

package/README.md

@@ -108,7 +108,7 @@ Add the same server definition to your Cursor MCP settings:
 
 ## Available tools
 
-`posterly-mcp-server@0.20.8` exposes 59 tools.
+`posterly-mcp-server@0.23.0` exposes 62 tools.
 
 Public setup tools work before `POSTERLY_API_KEY` exists:
 
@@ -167,6 +167,9 @@ Authenticated tools require `POSTERLY_API_KEY`:
 - `suggest_google_business_review_reply`
 - `reply_google_business_review` (post/update a public GBP review reply after explicit confirmation)
 - `delete_google_business_review_reply` (delete a GBP review reply after explicit confirmation)
+- `list_google_business_media` (list the photos/videos on a GBP profile gallery)
+- `add_google_business_media` (add a photo/video to a GBP profile gallery from a public URL, after explicit confirmation)
+- `delete_google_business_media` (remove a photo/video from a GBP profile gallery after explicit confirmation)
 - `list_activity`
 - `list_webhooks`
 - `create_webhook` (create a webhook after explicit confirmation)

package/dist/index.js

@@ -41,6 +41,9 @@ import { auditGoogleBusinessProfileTool } from './tools/audit-google-business-pr
 import { suggestGoogleBusinessReviewReplyTool } from './tools/suggest-google-business-review-reply.js';
 import { replyGoogleBusinessReviewTool } from './tools/reply-google-business-review.js';
 import { deleteGoogleBusinessReviewReplyTool } from './tools/delete-google-business-review-reply.js';
+import { listGoogleBusinessMediaTool } from './tools/list-google-business-media.js';
+import { addGoogleBusinessMediaTool } from './tools/add-google-business-media.js';
+import { deleteGoogleBusinessMediaTool } from './tools/delete-google-business-media.js';
 import { listActivityTool } from './tools/list-activity.js';
 import { listWebhooksTool } from './tools/list-webhooks.js';
 import { createWebhookTool } from './tools/create-webhook.js';
@@ -536,6 +539,33 @@ server.tool(deleteGoogleBusinessReviewReplyTool.name, deleteGoogleBusinessReview
         return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
     }
 });
+server.tool(listGoogleBusinessMediaTool.name, listGoogleBusinessMediaTool.description, listGoogleBusinessMediaTool.inputSchema.shape, async (input) => {
+    try {
+        const text = await listGoogleBusinessMediaTool.execute(client, input);
+        return { content: [{ type: 'text', text }] };
+    }
+    catch (err) {
+        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+    }
+});
+server.tool(addGoogleBusinessMediaTool.name, addGoogleBusinessMediaTool.description, addGoogleBusinessMediaTool.inputSchema.shape, async (input) => {
+    try {
+        const text = await addGoogleBusinessMediaTool.execute(client, input);
+        return { content: [{ type: 'text', text }] };
+    }
+    catch (err) {
+        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+    }
+});
+server.tool(deleteGoogleBusinessMediaTool.name, deleteGoogleBusinessMediaTool.description, deleteGoogleBusinessMediaTool.inputSchema.shape, async (input) => {
+    try {
+        const text = await deleteGoogleBusinessMediaTool.execute(client, input);
+        return { content: [{ type: 'text', text }] };
+    }
+    catch (err) {
+        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+    }
+});
 server.tool(listActivityTool.name, listActivityTool.description, listActivityTool.inputSchema.shape, async (input) => {
     try {
         const text = await listActivityTool.execute(client, input);

package/dist/lib/api-client.d.ts

@@ -372,6 +372,28 @@ export interface GoogleBusinessReviewsResponse {
     total: number;
     locations: Array<Record<string, unknown>>;
 }
+export interface GoogleBusinessMediaItem {
+    name: string;
+    mediaFormat: 'PHOTO' | 'VIDEO' | 'MEDIA_FORMAT_UNSPECIFIED';
+    category: string | null;
+    googleUrl: string | null;
+    thumbnailUrl: string | null;
+    createTime: string | null;
+    widthPixels: number | null;
+    heightPixels: number | null;
+    attribution: {
+        profileName?: string;
+        profilePhotoUrl?: string;
+        profileUrl?: string;
+    } | null;
+    account_id?: number;
+    location_id?: string | null;
+}
+export interface GoogleBusinessMediaResponse {
+    media: GoogleBusinessMediaItem[];
+    total: number;
+    locations: Array<Record<string, unknown>>;
+}
 export interface GoogleBusinessReviewLinkResponse {
     reviewLink: string;
     placeId: string;
@@ -820,6 +842,25 @@ export declare class PosterlyClient {
         location_id?: string;
         review_name: string;
     }): Promise<Record<string, any>>;
+    listGoogleBusinessMedia(params?: {
+        workspace_id?: string;
+        account_id?: number;
+        location_id?: string;
+    }): Promise<GoogleBusinessMediaResponse>;
+    addGoogleBusinessMedia(data: {
+        workspace_id?: string;
+        account_id?: number;
+        location_id?: string;
+        source_url: string;
+        category: string;
+        media_format?: 'PHOTO' | 'VIDEO';
+    }): Promise<Record<string, any>>;
+    deleteGoogleBusinessMedia(data: {
+        workspace_id?: string;
+        account_id?: number;
+        location_id?: string;
+        media_name: string;
+    }): Promise<Record<string, any>>;
     listActivity(params?: {
         workspace_id?: string;
         post_id?: number;

package/dist/lib/api-client.js

@@ -333,6 +333,23 @@ export class PosterlyClient {
     async deleteGoogleBusinessReviewReply(data) {
         return this.request('DELETE', '/google-business/reviews/reply', data);
     }
+    async listGoogleBusinessMedia(params) {
+        const searchParams = new URLSearchParams();
+        if (params?.workspace_id)
+            searchParams.set('workspace_id', params.workspace_id);
+        if (params?.account_id)
+            searchParams.set('account_id', String(params.account_id));
+        if (params?.location_id)
+            searchParams.set('location_id', params.location_id);
+        const qs = searchParams.toString();
+        return this.request('GET', `/google-business/media${qs ? `?${qs}` : ''}`);
+    }
+    async addGoogleBusinessMedia(data) {
+        return this.request('POST', '/google-business/media', data);
+    }
+    async deleteGoogleBusinessMedia(data) {
+        return this.request('DELETE', '/google-business/media', data);
+    }
     async listActivity(params) {
         const searchParams = new URLSearchParams();
         if (params?.workspace_id)

package/dist/lib/version.d.ts

@@ -1 +1 @@
-export declare const POSTERLY_MCP_VERSION = "0.20.8";
+export declare const POSTERLY_MCP_VERSION = "0.23.0";

package/dist/lib/version.js

@@ -1 +1 @@
-export const POSTERLY_MCP_VERSION = '0.20.8';
+export const POSTERLY_MCP_VERSION = '0.23.0';

package/dist/tools/add-google-business-media.d.ts

@@ -0,0 +1,42 @@
+import { z } from 'zod';
+import type { PosterlyClient } from '../lib/api-client.js';
+declare const CATEGORIES: readonly ["COVER", "PROFILE", "LOGO", "EXTERIOR", "INTERIOR", "PRODUCT", "AT_WORK", "FOOD_AND_DRINK", "MENU", "COMMON_AREA", "ROOMS", "TEAMS", "ADDITIONAL"];
+export declare const addGoogleBusinessMediaTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        workspace_id: z.ZodOptional<z.ZodString>;
+        account_id: z.ZodOptional<z.ZodNumber>;
+        location_id: z.ZodOptional<z.ZodString>;
+        source_url: z.ZodString;
+        category: z.ZodEnum<["COVER", "PROFILE", "LOGO", "EXTERIOR", "INTERIOR", "PRODUCT", "AT_WORK", "FOOD_AND_DRINK", "MENU", "COMMON_AREA", "ROOMS", "TEAMS", "ADDITIONAL"]>;
+        media_format: z.ZodOptional<z.ZodEnum<["PHOTO", "VIDEO"]>>;
+        confirm: z.ZodLiteral<true>;
+    }, "strip", z.ZodTypeAny, {
+        confirm: true;
+        source_url: string;
+        category: "COVER" | "PROFILE" | "LOGO" | "EXTERIOR" | "INTERIOR" | "PRODUCT" | "AT_WORK" | "FOOD_AND_DRINK" | "MENU" | "COMMON_AREA" | "ROOMS" | "TEAMS" | "ADDITIONAL";
+        workspace_id?: string | undefined;
+        account_id?: number | undefined;
+        location_id?: string | undefined;
+        media_format?: "PHOTO" | "VIDEO" | undefined;
+    }, {
+        confirm: true;
+        source_url: string;
+        category: "COVER" | "PROFILE" | "LOGO" | "EXTERIOR" | "INTERIOR" | "PRODUCT" | "AT_WORK" | "FOOD_AND_DRINK" | "MENU" | "COMMON_AREA" | "ROOMS" | "TEAMS" | "ADDITIONAL";
+        workspace_id?: string | undefined;
+        account_id?: number | undefined;
+        location_id?: string | undefined;
+        media_format?: "PHOTO" | "VIDEO" | undefined;
+    }>;
+    execute(client: PosterlyClient, input: {
+        workspace_id?: string;
+        account_id?: number;
+        location_id?: string;
+        source_url: string;
+        category: (typeof CATEGORIES)[number];
+        media_format?: "PHOTO" | "VIDEO";
+        confirm: true;
+    }): Promise<any>;
+};
+export {};

package/dist/tools/add-google-business-media.js

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+const CATEGORIES = [
+    'COVER',
+    'PROFILE',
+    'LOGO',
+    'EXTERIOR',
+    'INTERIOR',
+    'PRODUCT',
+    'AT_WORK',
+    'FOOD_AND_DRINK',
+    'MENU',
+    'COMMON_AREA',
+    'ROOMS',
+    'TEAMS',
+    'ADDITIONAL',
+];
+export const addGoogleBusinessMediaTool = {
+    name: 'add_google_business_media',
+    description: 'Add a photo or video to a Google Business Profile gallery (the media shown on Maps and Search). Provide a public https source_url first by uploading via upload_media_from_url or upload_media. COVER and PROFILE are single-slot and replace the existing one. WRITE: show the location, category, and media URL 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 location/platform_user_id. Provide account_id or location_id.'),
+        source_url: z.string().url().describe('Public https URL of the photo or video (from upload_media / upload_media_from_url).'),
+        category: z.enum(CATEGORIES).describe('Which gallery category to add the media to.'),
+        media_format: z.enum(['PHOTO', 'VIDEO']).optional().describe('Defaults to PHOTO. Use VIDEO for videos (Google caps profile videos at 30s / 75MB).'),
+        confirm: z.literal(true).describe('Must be true after explicit user confirmation.'),
+    }),
+    async execute(client, input) {
+        const { confirm: _confirm, ...payload } = input;
+        const result = await client.addGoogleBusinessMedia(payload);
+        return result.message || 'Media added to the Google Business profile.';
+    },
+};

package/dist/tools/delete-google-business-media.d.ts

@@ -0,0 +1,32 @@
+import { z } from 'zod';
+import type { PosterlyClient } from '../lib/api-client.js';
+export declare const deleteGoogleBusinessMediaTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        workspace_id: z.ZodOptional<z.ZodString>;
+        account_id: z.ZodOptional<z.ZodNumber>;
+        location_id: z.ZodOptional<z.ZodString>;
+        media_name: z.ZodString;
+        confirm: z.ZodLiteral<true>;
+    }, "strip", z.ZodTypeAny, {
+        confirm: true;
+        media_name: string;
+        workspace_id?: string | undefined;
+        account_id?: number | undefined;
+        location_id?: string | undefined;
+    }, {
+        confirm: true;
+        media_name: string;
+        workspace_id?: string | undefined;
+        account_id?: number | undefined;
+        location_id?: string | undefined;
+    }>;
+    execute(client: PosterlyClient, input: {
+        workspace_id?: string;
+        account_id?: number;
+        location_id?: string;
+        media_name: string;
+        confirm: true;
+    }): Promise<any>;
+};

package/dist/tools/delete-google-business-media.js

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+export const deleteGoogleBusinessMediaTool = {
+    name: 'delete_google_business_media',
+    description: 'Remove a photo or video from a Google Business Profile gallery. Get media_name from list_google_business_media. This permanently deletes the item from the public profile. WRITE: show the exact media item and location 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 location/platform_user_id. Provide account_id or location_id.'),
+        media_name: z.string().min(1).describe('Full media resource name from list_google_business_media (accounts/.../locations/.../media/...).'),
+        confirm: z.literal(true).describe('Must be true after explicit user confirmation.'),
+    }),
+    async execute(client, input) {
+        const { confirm: _confirm, ...payload } = input;
+        const result = await client.deleteGoogleBusinessMedia(payload);
+        return result.message || 'Media removed from the Google Business profile.';
+    },
+};

package/dist/tools/list-google-business-media.d.ts

@@ -0,0 +1,24 @@
+import { z } from 'zod';
+import type { PosterlyClient } from '../lib/api-client.js';
+export declare const listGoogleBusinessMediaTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        workspace_id: z.ZodOptional<z.ZodString>;
+        account_id: z.ZodOptional<z.ZodNumber>;
+        location_id: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        workspace_id?: string | undefined;
+        account_id?: number | undefined;
+        location_id?: string | undefined;
+    }, {
+        workspace_id?: string | undefined;
+        account_id?: number | undefined;
+        location_id?: string | undefined;
+    }>;
+    execute(client: PosterlyClient, input: {
+        workspace_id?: string;
+        account_id?: number;
+        location_id?: string;
+    }): Promise<string>;
+};

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

@@ -0,0 +1,25 @@
+import { z } from 'zod';
+export const listGoogleBusinessMediaTool = {
+    name: 'list_google_business_media',
+    description: 'List the photos and videos on a Google Business Profile gallery (the media shown on Maps and Search) for one location/account or every accessible GBP location. This is separate from media attached to a post. Returns each item\'s resource name, category, format, and URLs.',
+    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 location/platform_user_id.'),
+    }),
+    async execute(client, input) {
+        const result = await client.listGoogleBusinessMedia(input);
+        if (result.media.length === 0) {
+            return 'No photos or videos found on the Google Business profile for your filters.';
+        }
+        const lines = [`Google Business profile media (${result.media.length}):`];
+        for (const item of result.media.slice(0, 50)) {
+            const kind = item.mediaFormat === 'VIDEO' ? 'video' : 'photo';
+            const category = item.category || 'uncategorised';
+            const attribution = item.attribution?.profileName ? ` by ${item.attribution.profileName}` : '';
+            lines.push(`- [${kind}] ${category}${attribution} :: ${item.name}`);
+        }
+        lines.push('', 'Use the resource name (after ::) as media_name to delete an item.');
+        return lines.join('\n');
+    },
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "posterly-mcp-server",
-  "version": "0.22.0",
+  "version": "0.23.0",
   "description": "MCP server for posterly: schedule and publish social media posts across 11 platforms from any MCP client (Claude, ChatGPT, Cursor, Windsurf, Cline, and more)",
   "license": "MIT",
   "homepage": "https://www.poster.ly/mcp",

package/src/index.ts

@@ -42,6 +42,9 @@ import { auditGoogleBusinessProfileTool } from './tools/audit-google-business-pr
 import { suggestGoogleBusinessReviewReplyTool } from './tools/suggest-google-business-review-reply.js';
 import { replyGoogleBusinessReviewTool } from './tools/reply-google-business-review.js';
 import { deleteGoogleBusinessReviewReplyTool } from './tools/delete-google-business-review-reply.js';
+import { listGoogleBusinessMediaTool } from './tools/list-google-business-media.js';
+import { addGoogleBusinessMediaTool } from './tools/add-google-business-media.js';
+import { deleteGoogleBusinessMediaTool } from './tools/delete-google-business-media.js';
 import { listActivityTool } from './tools/list-activity.js';
 import { listWebhooksTool } from './tools/list-webhooks.js';
 import { createWebhookTool } from './tools/create-webhook.js';
@@ -800,6 +803,48 @@ server.tool(
   }
 );
 
+server.tool(
+  listGoogleBusinessMediaTool.name,
+  listGoogleBusinessMediaTool.description,
+  listGoogleBusinessMediaTool.inputSchema.shape,
+  async (input) => {
+    try {
+      const text = await listGoogleBusinessMediaTool.execute(client, input as any);
+      return { content: [{ type: 'text' as const, text }] };
+    } catch (err: any) {
+      return { content: [{ type: 'text' as const, text: `Error: ${err.message}` }], isError: true };
+    }
+  }
+);
+
+server.tool(
+  addGoogleBusinessMediaTool.name,
+  addGoogleBusinessMediaTool.description,
+  addGoogleBusinessMediaTool.inputSchema.shape,
+  async (input) => {
+    try {
+      const text = await addGoogleBusinessMediaTool.execute(client, input as any);
+      return { content: [{ type: 'text' as const, text }] };
+    } catch (err: any) {
+      return { content: [{ type: 'text' as const, text: `Error: ${err.message}` }], isError: true };
+    }
+  }
+);
+
+server.tool(
+  deleteGoogleBusinessMediaTool.name,
+  deleteGoogleBusinessMediaTool.description,
+  deleteGoogleBusinessMediaTool.inputSchema.shape,
+  async (input) => {
+    try {
+      const text = await deleteGoogleBusinessMediaTool.execute(client, input as any);
+      return { content: [{ type: 'text' as const, text }] };
+    } catch (err: any) {
+      return { content: [{ type: 'text' as const, text: `Error: ${err.message}` }], isError: true };
+    }
+  }
+);
+
 server.tool(
   listActivityTool.name,
   listActivityTool.description,

package/src/lib/api-client.ts

@@ -369,6 +369,26 @@ export interface GoogleBusinessReviewsResponse {
   locations: Array<Record<string, unknown>>;
 }
 
+export interface GoogleBusinessMediaItem {
+  name: string;
+  mediaFormat: 'PHOTO' | 'VIDEO' | 'MEDIA_FORMAT_UNSPECIFIED';
+  category: string | null;
+  googleUrl: string | null;
+  thumbnailUrl: string | null;
+  createTime: string | null;
+  widthPixels: number | null;
+  heightPixels: number | null;
+  attribution: { profileName?: string; profilePhotoUrl?: string; profileUrl?: string } | null;
+  account_id?: number;
+  location_id?: string | null;
+}
+
+export interface GoogleBusinessMediaResponse {
+  media: GoogleBusinessMediaItem[];
+  total: number;
+  locations: Array<Record<string, unknown>>;
+}
+
 export interface GoogleBusinessReviewLinkResponse {
   reviewLink: string;
   placeId: string;
@@ -1117,6 +1137,39 @@ export class PosterlyClient {
     return this.request('DELETE', '/google-business/reviews/reply', data);
   }
 
+  async listGoogleBusinessMedia(params?: {
+    workspace_id?: string;
+    account_id?: number;
+    location_id?: string;
+  }): Promise<GoogleBusinessMediaResponse> {
+    const searchParams = new URLSearchParams();
+    if (params?.workspace_id) searchParams.set('workspace_id', params.workspace_id);
+    if (params?.account_id) searchParams.set('account_id', String(params.account_id));
+    if (params?.location_id) searchParams.set('location_id', params.location_id);
+    const qs = searchParams.toString();
+    return this.request('GET', `/google-business/media${qs ? `?${qs}` : ''}`);
+  }
+
+  async addGoogleBusinessMedia(data: {
+    workspace_id?: string;
+    account_id?: number;
+    location_id?: string;
+    source_url: string;
+    category: string;
+    media_format?: 'PHOTO' | 'VIDEO';
+  }): Promise<Record<string, any>> {
+    return this.request('POST', '/google-business/media', data);
+  }
+
+  async deleteGoogleBusinessMedia(data: {
+    workspace_id?: string;
+    account_id?: number;
+    location_id?: string;
+    media_name: string;
+  }): Promise<Record<string, any>> {
+    return this.request('DELETE', '/google-business/media', data);
+  }
+
   async listActivity(params?: {
     workspace_id?: string;
     post_id?: number;

package/src/lib/version.ts

@@ -1 +1 @@
-export const POSTERLY_MCP_VERSION = '0.20.8';
+export const POSTERLY_MCP_VERSION = '0.23.0';

package/src/tools/add-google-business-media.ts

@@ -0,0 +1,50 @@
+import { z } from 'zod';
+import type { PosterlyClient } from '../lib/api-client.js';
+
+const CATEGORIES = [
+  'COVER',
+  'PROFILE',
+  'LOGO',
+  'EXTERIOR',
+  'INTERIOR',
+  'PRODUCT',
+  'AT_WORK',
+  'FOOD_AND_DRINK',
+  'MENU',
+  'COMMON_AREA',
+  'ROOMS',
+  'TEAMS',
+  'ADDITIONAL',
+] as const;
+
+export const addGoogleBusinessMediaTool = {
+  name: 'add_google_business_media',
+  description:
+    'Add a photo or video to a Google Business Profile gallery (the media shown on Maps and Search). Provide a public https source_url first by uploading via upload_media_from_url or upload_media. COVER and PROFILE are single-slot and replace the existing one. WRITE: show the location, category, and media URL 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 location/platform_user_id. Provide account_id or location_id.'),
+    source_url: z.string().url().describe('Public https URL of the photo or video (from upload_media / upload_media_from_url).'),
+    category: z.enum(CATEGORIES).describe('Which gallery category to add the media to.'),
+    media_format: z.enum(['PHOTO', 'VIDEO']).optional().describe('Defaults to PHOTO. Use VIDEO for videos (Google caps profile videos at 30s / 75MB).'),
+    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;
+      source_url: string;
+      category: (typeof CATEGORIES)[number];
+      media_format?: 'PHOTO' | 'VIDEO';
+      confirm: true;
+    },
+  ) {
+    const { confirm: _confirm, ...payload } = input;
+    const result = await client.addGoogleBusinessMedia(payload);
+    return result.message || 'Media added to the Google Business profile.';
+  },
+};

package/src/tools/delete-google-business-media.ts

@@ -0,0 +1,30 @@
+import { z } from 'zod';
+import type { PosterlyClient } from '../lib/api-client.js';
+
+export const deleteGoogleBusinessMediaTool = {
+  name: 'delete_google_business_media',
+  description:
+    'Remove a photo or video from a Google Business Profile gallery. Get media_name from list_google_business_media. This permanently deletes the item from the public profile. WRITE: show the exact media item and location 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 location/platform_user_id. Provide account_id or location_id.'),
+    media_name: z.string().min(1).describe('Full media resource name from list_google_business_media (accounts/.../locations/.../media/...).'),
+    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;
+      media_name: string;
+      confirm: true;
+    },
+  ) {
+    const { confirm: _confirm, ...payload } = input;
+    const result = await client.deleteGoogleBusinessMedia(payload);
+    return result.message || 'Media removed from the Google Business profile.';
+  },
+};

package/src/tools/list-google-business-media.ts

@@ -0,0 +1,33 @@
+import { z } from 'zod';
+import type { PosterlyClient } from '../lib/api-client.js';
+
+export const listGoogleBusinessMediaTool = {
+  name: 'list_google_business_media',
+  description:
+    'List the photos and videos on a Google Business Profile gallery (the media shown on Maps and Search) for one location/account or every accessible GBP location. This is separate from media attached to a post. Returns each item\'s resource name, category, format, and URLs.',
+  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 location/platform_user_id.'),
+  }),
+
+  async execute(
+    client: PosterlyClient,
+    input: { workspace_id?: string; account_id?: number; location_id?: string },
+  ) {
+    const result = await client.listGoogleBusinessMedia(input);
+    if (result.media.length === 0) {
+      return 'No photos or videos found on the Google Business profile for your filters.';
+    }
+
+    const lines = [`Google Business profile media (${result.media.length}):`];
+    for (const item of result.media.slice(0, 50)) {
+      const kind = item.mediaFormat === 'VIDEO' ? 'video' : 'photo';
+      const category = item.category || 'uncategorised';
+      const attribution = item.attribution?.profileName ? ` by ${item.attribution.profileName}` : '';
+      lines.push(`- [${kind}] ${category}${attribution} :: ${item.name}`);
+    }
+    lines.push('', 'Use the resource name (after ::) as media_name to delete an item.');
+    return lines.join('\n');
+  },
+};