posterly-mcp-server 0.21.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.';
+    },
+};