@cesteral/gads-mcp 1.0.0

package/dist/mcp-server/tools/definitions/list-accounts.tool.d.ts

@@ -0,0 +1,54 @@
+import { z } from "zod";
+import type { RequestContext, McpTextContent } from "@cesteral/shared";
+import type { SdkContext } from "@cesteral/shared";
+export declare const ListAccountsInputSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export declare const ListAccountsOutputSchema: z.ZodObject<{
+    resourceNames: z.ZodArray<z.ZodString, "many">;
+    customerIds: z.ZodArray<z.ZodString, "many">;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    resourceNames: string[];
+    timestamp: string;
+    customerIds: string[];
+}, {
+    resourceNames: string[];
+    timestamp: string;
+    customerIds: string[];
+}>;
+type ListAccountsInput = z.infer<typeof ListAccountsInputSchema>;
+type ListAccountsOutput = z.infer<typeof ListAccountsOutputSchema>;
+export declare function listAccountsLogic(_input: ListAccountsInput, context: RequestContext, sdkContext?: SdkContext): Promise<ListAccountsOutput>;
+export declare function listAccountsResponseFormatter(result: ListAccountsOutput): McpTextContent[];
+export declare const listAccountsTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+    outputSchema: z.ZodObject<{
+        resourceNames: z.ZodArray<z.ZodString, "many">;
+        customerIds: z.ZodArray<z.ZodString, "many">;
+        timestamp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        resourceNames: string[];
+        timestamp: string;
+        customerIds: string[];
+    }, {
+        resourceNames: string[];
+        timestamp: string;
+        customerIds: string[];
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+    };
+    inputExamples: {
+        label: string;
+        input: {};
+    }[];
+    logic: typeof listAccountsLogic;
+    responseFormatter: typeof listAccountsResponseFormatter;
+};
+export {};
+//# sourceMappingURL=list-accounts.tool.d.ts.map

package/dist/mcp-server/tools/definitions/list-accounts.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-accounts.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/list-accounts.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAQnD,eAAO,MAAM,uBAAuB,gDAEmC,CAAC;AAExE,eAAO,MAAM,wBAAwB;;;;;;;;;;;;EAME,CAAC;AAExC,KAAK,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACjE,KAAK,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAEnE,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,kBAAkB,CAAC,CAgB7B;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,EAAE,CAS1F;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoB5B,CAAC"}

package/dist/mcp-server/tools/definitions/list-accounts.tool.js

@@ -0,0 +1,61 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+const TOOL_NAME = "gads_list_accounts";
+const TOOL_TITLE = "List Google Ads Accounts";
+const TOOL_DESCRIPTION = `List all Google Ads customer accounts accessible to the authenticated user.
+
+Returns resource names in the format \`customers/{customerId}\`. Use the customer IDs from this list for all other Google Ads tools.`;
+export const ListAccountsInputSchema = z
+    .object({})
+    .describe("No parameters required — returns all accessible accounts");
+export const ListAccountsOutputSchema = z
+    .object({
+    resourceNames: z.array(z.string()).describe("Account resource names (customers/{id})"),
+    customerIds: z.array(z.string()).describe("Extracted customer IDs"),
+    timestamp: z.string().datetime(),
+})
+    .describe("Accessible accounts list");
+export async function listAccountsLogic(_input, context, sdkContext) {
+    const { gadsService } = resolveSessionServices(sdkContext);
+    const result = await gadsService.listAccessibleCustomers(context);
+    const customerIds = result.resourceNames.map((rn) => {
+        const parts = rn.split("/");
+        return parts[parts.length - 1];
+    });
+    return {
+        resourceNames: result.resourceNames,
+        customerIds,
+        timestamp: new Date().toISOString(),
+    };
+}
+export function listAccountsResponseFormatter(result) {
+    const lines = result.customerIds.map((id, i) => `  ${i + 1}. ${id} (${result.resourceNames[i]})`);
+    return [
+        {
+            type: "text",
+            text: `Found ${result.customerIds.length} accessible account(s):\n${lines.join("\n")}\n\nTimestamp: ${result.timestamp}`,
+        },
+    ];
+}
+export const listAccountsTool = {
+    name: TOOL_NAME,
+    title: TOOL_TITLE,
+    description: TOOL_DESCRIPTION,
+    inputSchema: ListAccountsInputSchema,
+    outputSchema: ListAccountsOutputSchema,
+    annotations: {
+        readOnlyHint: true,
+        openWorldHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+    },
+    inputExamples: [
+        {
+            label: "List all accessible accounts",
+            input: {},
+        },
+    ],
+    logic: listAccountsLogic,
+    responseFormatter: listAccountsResponseFormatter,
+};
+//# sourceMappingURL=list-accounts.tool.js.map

package/dist/mcp-server/tools/definitions/list-accounts.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-accounts.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/list-accounts.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAIrE,MAAM,SAAS,GAAG,oBAAoB,CAAC;AACvC,MAAM,UAAU,GAAG,0BAA0B,CAAC;AAC9C,MAAM,gBAAgB,GAAG;;qIAE4G,CAAC;AAEtI,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC;KACrC,MAAM,CAAC,EAAE,CAAC;KACV,QAAQ,CAAC,0DAA0D,CAAC,CAAC;AAExE,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC;KACtC,MAAM,CAAC;IACN,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,yCAAyC,CAAC;IACtF,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,wBAAwB,CAAC;IACnE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC;KACD,QAAQ,CAAC,0BAA0B,CAAC,CAAC;AAKxC,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAyB,EACzB,OAAuB,EACvB,UAAuB;IAEvB,MAAM,EAAE,WAAW,EAAE,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAE3D,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC;IAGlE,MAAM,WAAW,GAAG,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE;QAClD,MAAM,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC5B,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,WAAW;QACX,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,MAA0B;IACtE,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAElG,OAAO;QACL;YACE,IAAI,EAAE,MAAe;YACrB,IAAI,EAAE,SAAS,MAAM,CAAC,WAAW,CAAC,MAAM,4BAA4B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,kBAAkB,MAAM,CAAC,SAAS,EAAE;SACzH;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,UAAU;IACjB,WAAW,EAAE,gBAAgB;IAC7B,WAAW,EAAE,uBAAuB;IACpC,YAAY,EAAE,wBAAwB;IACtC,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;QAClB,aAAa,EAAE,KAAK;QACpB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,IAAI;KACrB;IACD,aAAa,EAAE;QACb;YACE,KAAK,EAAE,8BAA8B;YACrC,KAAK,EAAE,EAAE;SACV;KACF;IACD,KAAK,EAAE,iBAAiB;IACxB,iBAAiB,EAAE,6BAA6B;CACjD,CAAC"}

package/dist/mcp-server/tools/definitions/list-entities.tool.d.ts

@@ -0,0 +1,220 @@
+import { z } from "zod";
+import type { RequestContext, McpTextContent } from "@cesteral/shared";
+import type { SdkContext } from "@cesteral/shared";
+export declare const ListEntitiesInputSchema: z.ZodEffects<z.ZodObject<{
+    entityType: z.ZodEnum<[string, ...string[]]>;
+    customerId: z.ZodString;
+    filters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    pageSize: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    pageToken: z.ZodOptional<z.ZodString>;
+    orderBy: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    customerId: string;
+    pageSize: number;
+    entityType: string;
+    pageToken?: string | undefined;
+    filters?: Record<string, string> | undefined;
+    orderBy?: string | undefined;
+}, {
+    customerId: string;
+    entityType: string;
+    pageSize?: number | undefined;
+    pageToken?: string | undefined;
+    filters?: Record<string, string> | undefined;
+    orderBy?: string | undefined;
+}>, {
+    customerId: string;
+    pageSize: number;
+    entityType: string;
+    pageToken?: string | undefined;
+    filters?: Record<string, string> | undefined;
+    orderBy?: string | undefined;
+}, {
+    customerId: string;
+    entityType: string;
+    pageSize?: number | undefined;
+    pageToken?: string | undefined;
+    filters?: Record<string, string> | undefined;
+    orderBy?: string | undefined;
+}>;
+export declare const ListEntitiesOutputSchema: z.ZodObject<{
+    entities: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">;
+    pagination: z.ZodObject<{
+        nextCursor: z.ZodNullable<z.ZodString>;
+        hasMore: z.ZodBoolean;
+        pageSize: z.ZodNumber;
+        totalCount: z.ZodOptional<z.ZodNumber>;
+        nextPageInputKey: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        nextCursor: string | null;
+        hasMore: boolean;
+        pageSize: number;
+        nextPageInputKey: string;
+        totalCount?: number | undefined;
+    }, {
+        nextCursor: string | null;
+        hasMore: boolean;
+        pageSize: number;
+        nextPageInputKey: string;
+        totalCount?: number | undefined;
+    }>;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    entities: Record<string, any>[];
+    timestamp: string;
+    pagination: {
+        nextCursor: string | null;
+        hasMore: boolean;
+        pageSize: number;
+        nextPageInputKey: string;
+        totalCount?: number | undefined;
+    };
+}, {
+    entities: Record<string, any>[];
+    timestamp: string;
+    pagination: {
+        nextCursor: string | null;
+        hasMore: boolean;
+        pageSize: number;
+        nextPageInputKey: string;
+        totalCount?: number | undefined;
+    };
+}>;
+type ListEntitiesInput = z.infer<typeof ListEntitiesInputSchema>;
+type ListEntitiesOutput = z.infer<typeof ListEntitiesOutputSchema>;
+export declare function listEntitiesLogic(input: ListEntitiesInput, context: RequestContext, sdkContext?: SdkContext): Promise<ListEntitiesOutput>;
+export declare function listEntitiesResponseFormatter(result: ListEntitiesOutput): McpTextContent[];
+export declare const listEntitiesTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodEffects<z.ZodObject<{
+        entityType: z.ZodEnum<[string, ...string[]]>;
+        customerId: z.ZodString;
+        filters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        pageSize: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        pageToken: z.ZodOptional<z.ZodString>;
+        orderBy: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        customerId: string;
+        pageSize: number;
+        entityType: string;
+        pageToken?: string | undefined;
+        filters?: Record<string, string> | undefined;
+        orderBy?: string | undefined;
+    }, {
+        customerId: string;
+        entityType: string;
+        pageSize?: number | undefined;
+        pageToken?: string | undefined;
+        filters?: Record<string, string> | undefined;
+        orderBy?: string | undefined;
+    }>, {
+        customerId: string;
+        pageSize: number;
+        entityType: string;
+        pageToken?: string | undefined;
+        filters?: Record<string, string> | undefined;
+        orderBy?: string | undefined;
+    }, {
+        customerId: string;
+        entityType: string;
+        pageSize?: number | undefined;
+        pageToken?: string | undefined;
+        filters?: Record<string, string> | undefined;
+        orderBy?: string | undefined;
+    }>;
+    outputSchema: z.ZodObject<{
+        entities: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">;
+        pagination: z.ZodObject<{
+            nextCursor: z.ZodNullable<z.ZodString>;
+            hasMore: z.ZodBoolean;
+            pageSize: z.ZodNumber;
+            totalCount: z.ZodOptional<z.ZodNumber>;
+            nextPageInputKey: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            nextCursor: string | null;
+            hasMore: boolean;
+            pageSize: number;
+            nextPageInputKey: string;
+            totalCount?: number | undefined;
+        }, {
+            nextCursor: string | null;
+            hasMore: boolean;
+            pageSize: number;
+            nextPageInputKey: string;
+            totalCount?: number | undefined;
+        }>;
+        timestamp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        entities: Record<string, any>[];
+        timestamp: string;
+        pagination: {
+            nextCursor: string | null;
+            hasMore: boolean;
+            pageSize: number;
+            nextPageInputKey: string;
+            totalCount?: number | undefined;
+        };
+    }, {
+        entities: Record<string, any>[];
+        timestamp: string;
+        pagination: {
+            nextCursor: string | null;
+            hasMore: boolean;
+            pageSize: number;
+            nextPageInputKey: string;
+            totalCount?: number | undefined;
+        };
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+    };
+    inputExamples: ({
+        label: string;
+        input: {
+            entityType: string;
+            customerId: string;
+            filters: {
+                "campaign.status": string;
+                "ad_group.campaign"?: undefined;
+                "ad_group_criterion.status"?: undefined;
+            };
+            orderBy?: undefined;
+            pageSize?: undefined;
+        };
+    } | {
+        label: string;
+        input: {
+            entityType: string;
+            customerId: string;
+            filters: {
+                "ad_group.campaign": string;
+                "campaign.status"?: undefined;
+                "ad_group_criterion.status"?: undefined;
+            };
+            orderBy: string;
+            pageSize?: undefined;
+        };
+    } | {
+        label: string;
+        input: {
+            entityType: string;
+            customerId: string;
+            filters: {
+                "ad_group_criterion.status": string;
+                "campaign.status"?: undefined;
+                "ad_group.campaign"?: undefined;
+            };
+            pageSize: number;
+            orderBy?: undefined;
+        };
+    })[];
+    logic: typeof listEntitiesLogic;
+    responseFormatter: typeof listEntitiesResponseFormatter;
+};
+export {};
+//# sourceMappingURL=list-entities.tool.d.ts.map

package/dist/mcp-server/tools/definitions/list-entities.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-entities.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/list-entities.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAMnD,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2BqB,CAAC;AAE1D,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAMD,CAAC;AAErC,KAAK,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACjE,KAAK,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAEnE,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,kBAAkB,CAAC,CAwB7B;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,EAAE,CAY1F;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgD5B,CAAC"}

package/dist/mcp-server/tools/definitions/list-entities.tool.js

@@ -0,0 +1,112 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+import { getEntityTypeEnum } from "../utils/entity-mapping.js";
+import { addParentValidationIssue } from "../utils/parent-id-validation.js";
+import { PaginationOutputSchema, buildPaginationOutput, formatPaginationHint, } from "@cesteral/shared";
+const TOOL_NAME = "gads_list_entities";
+const TOOL_TITLE = "List Google Ads Entities";
+const TOOL_DESCRIPTION = `List Google Ads entities of a given type with optional GAQL filters. Filters are applied as GAQL WHERE conditions. For complex queries, use \`gads_gaql_search\` directly.`;
+export const ListEntitiesInputSchema = z
+    .object({
+    entityType: z.enum(getEntityTypeEnum()).describe("Type of entity to list"),
+    customerId: z.string().min(1).describe("Google Ads customer ID (no dashes)"),
+    filters: z
+        .record(z.string())
+        .optional()
+        .describe("GAQL filter conditions as field:value pairs (e.g., { 'campaign.status': '= \\'ENABLED\\'' })"),
+    pageSize: z
+        .number()
+        .min(1)
+        .max(10000)
+        .optional()
+        .default(100)
+        .describe("Number of results per page (default 100)"),
+    pageToken: z.string().optional().describe("Page token for pagination"),
+    orderBy: z.string().optional().describe("GAQL ORDER BY clause (e.g., 'campaign.name ASC')"),
+})
+    .superRefine((input, ctx) => {
+    addParentValidationIssue(ctx, input.entityType, input);
+})
+    .describe("Parameters for listing Google Ads entities");
+export const ListEntitiesOutputSchema = z
+    .object({
+    entities: z.array(z.record(z.any())).describe("List of entities"),
+    pagination: PaginationOutputSchema,
+    timestamp: z.string().datetime(),
+})
+    .describe("Entity listing result");
+export async function listEntitiesLogic(input, context, sdkContext) {
+    const { gadsService } = resolveSessionServices(sdkContext);
+    const result = await gadsService.listEntities(input.entityType, input.customerId, input.filters, input.pageSize, input.pageToken, input.orderBy, context);
+    const entities = result.entities;
+    return {
+        entities,
+        pagination: buildPaginationOutput({
+            nextCursor: result.nextPageToken,
+            pageSize: entities.length,
+            totalCount: result.totalResultsCount,
+            nextPageInputKey: "pageToken",
+        }),
+        timestamp: new Date().toISOString(),
+    };
+}
+export function listEntitiesResponseFormatter(result) {
+    const { pageSize, totalCount, hasMore } = result.pagination;
+    const summary = `Found ${pageSize} entities${totalCount !== undefined ? ` (${totalCount} total)` : ""}${hasMore ? " — more pages available" : ""}`;
+    return [
+        {
+            type: "text",
+            text: `${summary}\n\n${JSON.stringify(result.entities, null, 2)}${formatPaginationHint(result.pagination)}\n\nTimestamp: ${result.timestamp}`,
+        },
+    ];
+}
+export const listEntitiesTool = {
+    name: TOOL_NAME,
+    title: TOOL_TITLE,
+    description: TOOL_DESCRIPTION,
+    inputSchema: ListEntitiesInputSchema,
+    outputSchema: ListEntitiesOutputSchema,
+    annotations: {
+        readOnlyHint: true,
+        openWorldHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+    },
+    inputExamples: [
+        {
+            label: "List all enabled campaigns for a customer",
+            input: {
+                entityType: "campaign",
+                customerId: "1234567890",
+                filters: {
+                    "campaign.status": "= 'ENABLED'",
+                },
+            },
+        },
+        {
+            label: "List ad groups within a specific campaign",
+            input: {
+                entityType: "adGroup",
+                customerId: "1234567890",
+                filters: {
+                    "ad_group.campaign": "= 'customers/1234567890/campaigns/9876543210'",
+                },
+                orderBy: "ad_group.name ASC",
+            },
+        },
+        {
+            label: "List keywords with pagination",
+            input: {
+                entityType: "keyword",
+                customerId: "1234567890",
+                filters: {
+                    "ad_group_criterion.status": "= 'ENABLED'",
+                },
+                pageSize: 50,
+            },
+        },
+    ],
+    logic: listEntitiesLogic,
+    responseFormatter: listEntitiesResponseFormatter,
+};
+//# sourceMappingURL=list-entities.tool.js.map

package/dist/mcp-server/tools/definitions/list-entities.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-entities.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/list-entities.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAuB,MAAM,4BAA4B,CAAC;AACpF,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAI1B,MAAM,SAAS,GAAG,oBAAoB,CAAC;AACvC,MAAM,UAAU,GAAG,0BAA0B,CAAC;AAC9C,MAAM,gBAAgB,GAAG,4KAA4K,CAAC;AAEtM,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC;KACrC,MAAM,CAAC;IACN,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC,CAAC,QAAQ,CAAC,wBAAwB,CAAC;IAC1E,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,oCAAoC,CAAC;IAC5E,OAAO,EAAE,CAAC;SACP,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SAClB,QAAQ,EAAE;SACV,QAAQ,CACP,8FAA8F,CAC/F;IACH,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,KAAK,CAAC;SACV,QAAQ,EAAE;SACV,OAAO,CAAC,GAAG,CAAC;SACZ,QAAQ,CAAC,0CAA0C,CAAC;IACvD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;IACtE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;CAC5F,CAAC;KACD,WAAW,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;IAC1B,wBAAwB,CACtB,GAAG,EACH,KAAK,CAAC,UAA4B,EAClC,KAAgC,CACjC,CAAC;AACJ,CAAC,CAAC;KACD,QAAQ,CAAC,4CAA4C,CAAC,CAAC;AAE1D,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC;KACtC,MAAM,CAAC;IACN,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,kBAAkB,CAAC;IACjE,UAAU,EAAE,sBAAsB;IAClC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC;KACD,QAAQ,CAAC,uBAAuB,CAAC,CAAC;AAKrC,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,KAAwB,EACxB,OAAuB,EACvB,UAAuB;IAEvB,MAAM,EAAE,WAAW,EAAE,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAE3D,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,YAAY,CAC3C,KAAK,CAAC,UAA4B,EAClC,KAAK,CAAC,UAAU,EAChB,KAAK,CAAC,OAAO,EACb,KAAK,CAAC,QAAQ,EACd,KAAK,CAAC,SAAS,EACf,KAAK,CAAC,OAAO,EACb,OAAO,CACR,CAAC;IAEF,MAAM,QAAQ,GAAG,MAAM,CAAC,QAA4C,CAAC;IACrE,OAAO;QACL,QAAQ;QACR,UAAU,EAAE,qBAAqB,CAAC;YAChC,UAAU,EAAE,MAAM,CAAC,aAAa;YAChC,QAAQ,EAAE,QAAQ,CAAC,MAAM;YACzB,UAAU,EAAE,MAAM,CAAC,iBAAiB;YACpC,gBAAgB,EAAE,WAAW;SAC9B,CAAC;QACF,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,MAA0B;IACtE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC;IAC5D,MAAM,OAAO,GAAG,SAAS,QAAQ,YAC/B,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,UAAU,SAAS,CAAC,CAAC,CAAC,EACxD,GAAG,OAAO,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IAE9C,OAAO;QACL;YACE,IAAI,EAAE,MAAe;YACrB,IAAI,EAAE,GAAG,OAAO,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,oBAAoB,CAAC,MAAM,CAAC,UAAU,CAAC,kBAAkB,MAAM,CAAC,SAAS,EAAE;SAC9I;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,UAAU;IACjB,WAAW,EAAE,gBAAgB;IAC7B,WAAW,EAAE,uBAAuB;IACpC,YAAY,EAAE,wBAAwB;IACtC,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;QAClB,aAAa,EAAE,KAAK;QACpB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,IAAI;KACrB;IACD,aAAa,EAAE;QACb;YACE,KAAK,EAAE,2CAA2C;YAClD,KAAK,EAAE;gBACL,UAAU,EAAE,UAAU;gBACtB,UAAU,EAAE,YAAY;gBACxB,OAAO,EAAE;oBACP,iBAAiB,EAAE,aAAa;iBACjC;aACF;SACF;QACD;YACE,KAAK,EAAE,2CAA2C;YAClD,KAAK,EAAE;gBACL,UAAU,EAAE,SAAS;gBACrB,UAAU,EAAE,YAAY;gBACxB,OAAO,EAAE;oBACP,mBAAmB,EAAE,+CAA+C;iBACrE;gBACD,OAAO,EAAE,mBAAmB;aAC7B;SACF;QACD;YACE,KAAK,EAAE,+BAA+B;YACtC,KAAK,EAAE;gBACL,UAAU,EAAE,SAAS;gBACrB,UAAU,EAAE,YAAY;gBACxB,OAAO,EAAE;oBACP,2BAA2B,EAAE,aAAa;iBAC3C;gBACD,QAAQ,EAAE,EAAE;aACb;SACF;KACF;IACD,KAAK,EAAE,iBAAiB;IACxB,iBAAiB,EAAE,6BAA6B;CACjD,CAAC"}

package/dist/mcp-server/tools/definitions/remove-entity.tool.d.ts

@@ -0,0 +1,116 @@
+import { z } from "zod";
+import type { RequestContext, McpTextContent } from "@cesteral/shared";
+import type { SdkContext } from "@cesteral/shared";
+export declare const RemoveEntityInputSchema: z.ZodEffects<z.ZodObject<{
+    entityType: z.ZodEnum<[string, ...string[]]>;
+    customerId: z.ZodString;
+    entityId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    customerId: string;
+    entityType: string;
+    entityId: string;
+}, {
+    customerId: string;
+    entityType: string;
+    entityId: string;
+}>, {
+    customerId: string;
+    entityType: string;
+    entityId: string;
+}, {
+    customerId: string;
+    entityType: string;
+    entityId: string;
+}>;
+export declare const RemoveEntityOutputSchema: z.ZodObject<{
+    confirmed: z.ZodBoolean;
+    declineReason: z.ZodOptional<z.ZodString>;
+    mutateResult: z.ZodRecord<z.ZodString, z.ZodAny>;
+    entityType: z.ZodString;
+    entityId: z.ZodString;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    entityType: string;
+    entityId: string;
+    timestamp: string;
+    mutateResult: Record<string, any>;
+    confirmed: boolean;
+    declineReason?: string | undefined;
+}, {
+    entityType: string;
+    entityId: string;
+    timestamp: string;
+    mutateResult: Record<string, any>;
+    confirmed: boolean;
+    declineReason?: string | undefined;
+}>;
+type RemoveEntityInput = z.infer<typeof RemoveEntityInputSchema>;
+type RemoveEntityOutput = z.infer<typeof RemoveEntityOutputSchema>;
+export declare function removeEntityLogic(input: RemoveEntityInput, context: RequestContext, sdkContext?: SdkContext): Promise<RemoveEntityOutput>;
+export declare function removeEntityResponseFormatter(result: RemoveEntityOutput): McpTextContent[];
+export declare const removeEntityTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodEffects<z.ZodObject<{
+        entityType: z.ZodEnum<[string, ...string[]]>;
+        customerId: z.ZodString;
+        entityId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        customerId: string;
+        entityType: string;
+        entityId: string;
+    }, {
+        customerId: string;
+        entityType: string;
+        entityId: string;
+    }>, {
+        customerId: string;
+        entityType: string;
+        entityId: string;
+    }, {
+        customerId: string;
+        entityType: string;
+        entityId: string;
+    }>;
+    outputSchema: z.ZodObject<{
+        confirmed: z.ZodBoolean;
+        declineReason: z.ZodOptional<z.ZodString>;
+        mutateResult: z.ZodRecord<z.ZodString, z.ZodAny>;
+        entityType: z.ZodString;
+        entityId: z.ZodString;
+        timestamp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        entityType: string;
+        entityId: string;
+        timestamp: string;
+        mutateResult: Record<string, any>;
+        confirmed: boolean;
+        declineReason?: string | undefined;
+    }, {
+        entityType: string;
+        entityId: string;
+        timestamp: string;
+        mutateResult: Record<string, any>;
+        confirmed: boolean;
+        declineReason?: string | undefined;
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+    };
+    inputExamples: {
+        label: string;
+        input: {
+            entityType: string;
+            customerId: string;
+            entityId: string;
+        };
+    }[];
+    logic: typeof removeEntityLogic;
+    responseFormatter: typeof removeEntityResponseFormatter;
+};
+export {};
+//# sourceMappingURL=remove-entity.tool.d.ts.map

package/dist/mcp-server/tools/definitions/remove-entity.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove-entity.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/remove-entity.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAcnD,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;EAesB,CAAC;AAE3D,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;EASD,CAAC;AAErC,KAAK,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACjE,KAAK,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAEnE,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,kBAAkB,CAAC,CAiC7B;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,EAAE,CAe1F;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwC5B,CAAC"}