@cesteral/meta-mcp 1.0.0

package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts

@@ -0,0 +1,221 @@
+import { z } from "zod";
+import type { RequestContext, McpTextContent } from "@cesteral/shared";
+import type { SdkContext } from "@cesteral/shared";
+export declare const AdjustBidsInputSchema: z.ZodObject<{
+    adjustments: z.ZodArray<z.ZodObject<{
+        adSetId: z.ZodString;
+        bidAmount: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        adSetId: string;
+        bidAmount: number;
+    }, {
+        adSetId: string;
+        bidAmount: number;
+    }>, "many">;
+    reason: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    adjustments: {
+        adSetId: string;
+        bidAmount: number;
+    }[];
+    reason?: string | undefined;
+}, {
+    adjustments: {
+        adSetId: string;
+        bidAmount: number;
+    }[];
+    reason?: string | undefined;
+}>;
+export declare const AdjustBidsOutputSchema: z.ZodObject<{
+    confirmed: z.ZodBoolean;
+    declineReason: z.ZodOptional<z.ZodString>;
+    totalRequested: z.ZodNumber;
+    totalSucceeded: z.ZodNumber;
+    totalFailed: z.ZodNumber;
+    results: z.ZodArray<z.ZodObject<{
+        adSetId: z.ZodString;
+        success: z.ZodBoolean;
+        adSetName: z.ZodOptional<z.ZodString>;
+        previousBidAmount: z.ZodOptional<z.ZodNumber>;
+        newBidAmount: z.ZodOptional<z.ZodNumber>;
+        warning: z.ZodOptional<z.ZodString>;
+        error: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        success: boolean;
+        adSetId: string;
+        warning?: string | undefined;
+        error?: string | undefined;
+        adSetName?: string | undefined;
+        previousBidAmount?: number | undefined;
+        newBidAmount?: number | undefined;
+    }, {
+        success: boolean;
+        adSetId: string;
+        warning?: string | undefined;
+        error?: string | undefined;
+        adSetName?: string | undefined;
+        previousBidAmount?: number | undefined;
+        newBidAmount?: number | undefined;
+    }>, "many">;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    results: {
+        success: boolean;
+        adSetId: string;
+        warning?: string | undefined;
+        error?: string | undefined;
+        adSetName?: string | undefined;
+        previousBidAmount?: number | undefined;
+        newBidAmount?: number | undefined;
+    }[];
+    timestamp: string;
+    confirmed: boolean;
+    totalRequested: number;
+    totalSucceeded: number;
+    totalFailed: number;
+    declineReason?: string | undefined;
+}, {
+    results: {
+        success: boolean;
+        adSetId: string;
+        warning?: string | undefined;
+        error?: string | undefined;
+        adSetName?: string | undefined;
+        previousBidAmount?: number | undefined;
+        newBidAmount?: number | undefined;
+    }[];
+    timestamp: string;
+    confirmed: boolean;
+    totalRequested: number;
+    totalSucceeded: number;
+    totalFailed: number;
+    declineReason?: string | undefined;
+}>;
+type AdjustBidsInput = z.infer<typeof AdjustBidsInputSchema>;
+type AdjustBidsOutput = z.infer<typeof AdjustBidsOutputSchema>;
+export declare function adjustBidsLogic(input: AdjustBidsInput, context: RequestContext, sdkContext?: SdkContext): Promise<AdjustBidsOutput>;
+export declare function adjustBidsResponseFormatter(result: AdjustBidsOutput): McpTextContent[];
+export declare const adjustBidsTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        adjustments: z.ZodArray<z.ZodObject<{
+            adSetId: z.ZodString;
+            bidAmount: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            adSetId: string;
+            bidAmount: number;
+        }, {
+            adSetId: string;
+            bidAmount: number;
+        }>, "many">;
+        reason: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        adjustments: {
+            adSetId: string;
+            bidAmount: number;
+        }[];
+        reason?: string | undefined;
+    }, {
+        adjustments: {
+            adSetId: string;
+            bidAmount: number;
+        }[];
+        reason?: string | undefined;
+    }>;
+    outputSchema: z.ZodObject<{
+        confirmed: z.ZodBoolean;
+        declineReason: z.ZodOptional<z.ZodString>;
+        totalRequested: z.ZodNumber;
+        totalSucceeded: z.ZodNumber;
+        totalFailed: z.ZodNumber;
+        results: z.ZodArray<z.ZodObject<{
+            adSetId: z.ZodString;
+            success: z.ZodBoolean;
+            adSetName: z.ZodOptional<z.ZodString>;
+            previousBidAmount: z.ZodOptional<z.ZodNumber>;
+            newBidAmount: z.ZodOptional<z.ZodNumber>;
+            warning: z.ZodOptional<z.ZodString>;
+            error: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            success: boolean;
+            adSetId: string;
+            warning?: string | undefined;
+            error?: string | undefined;
+            adSetName?: string | undefined;
+            previousBidAmount?: number | undefined;
+            newBidAmount?: number | undefined;
+        }, {
+            success: boolean;
+            adSetId: string;
+            warning?: string | undefined;
+            error?: string | undefined;
+            adSetName?: string | undefined;
+            previousBidAmount?: number | undefined;
+            newBidAmount?: number | undefined;
+        }>, "many">;
+        timestamp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        results: {
+            success: boolean;
+            adSetId: string;
+            warning?: string | undefined;
+            error?: string | undefined;
+            adSetName?: string | undefined;
+            previousBidAmount?: number | undefined;
+            newBidAmount?: number | undefined;
+        }[];
+        timestamp: string;
+        confirmed: boolean;
+        totalRequested: number;
+        totalSucceeded: number;
+        totalFailed: number;
+        declineReason?: string | undefined;
+    }, {
+        results: {
+            success: boolean;
+            adSetId: string;
+            warning?: string | undefined;
+            error?: string | undefined;
+            adSetName?: string | undefined;
+            previousBidAmount?: number | undefined;
+            newBidAmount?: number | undefined;
+        }[];
+        timestamp: string;
+        confirmed: boolean;
+        totalRequested: number;
+        totalSucceeded: number;
+        totalFailed: number;
+        declineReason?: string | undefined;
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        idempotentHint: boolean;
+        destructiveHint: boolean;
+    };
+    inputExamples: ({
+        label: string;
+        input: {
+            adjustments: {
+                adSetId: string;
+                bidAmount: number;
+            }[];
+            reason?: undefined;
+        };
+    } | {
+        label: string;
+        input: {
+            adjustments: {
+                adSetId: string;
+                bidAmount: number;
+            }[];
+            reason: string;
+        };
+    })[];
+    logic: typeof adjustBidsLogic;
+    responseFormatter: typeof adjustBidsResponseFormatter;
+};
+export {};
+//# sourceMappingURL=adjust-bids.tool.d.ts.map

package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adjust-bids.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/adjust-bids.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAsBnD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;EAcgC,CAAC;AAInE,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoBE,CAAC;AAItC,KAAK,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAC7D,KAAK,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAc/D,wBAAsB,eAAe,CACnC,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,gBAAgB,CAAC,CA+E3B;AAID,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,gBAAgB,GAAG,cAAc,EAAE,CAuCtF;AAID,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgC1B,CAAC"}

package/dist/mcp-server/tools/definitions/adjust-bids.tool.js

@@ -0,0 +1,178 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+import { elicitBidChangeConfirmation } from "@cesteral/shared";
+const TOOL_NAME = "meta_adjust_bids";
+const TOOL_TITLE = "Meta Ads Bid Adjustment";
+const TOOL_DESCRIPTION = `Batch adjust ad set bid amounts with safe read-modify-write.
+
+Reads current bids, applies new values, and reports previous/new amounts.
+Amounts are in cents (100 = $1.00 USD).
+
+**Gotchas:**
+- Only applies to ad sets with manual bidding (bid_amount field).
+- Ad sets using auto-bidding strategies (e.g., LOWEST_COST_WITHOUT_CAP) may ignore bid_amount.
+- A warning is included in results for ad sets that appear to use auto-bidding.
+- Budget values are in cents (100 = $1.00 USD).
+- Each read + write pair consumes 4x rate limit tokens total.
+- Max 50 adjustments per call.`;
+const AUTO_BID_STRATEGIES = new Set(["LOWEST_COST_WITHOUT_CAP", "LOWEST_COST_WITH_MIN_ROAS"]);
+export const AdjustBidsInputSchema = z
+    .object({
+    adjustments: z
+        .array(z.object({
+        adSetId: z.string().min(1).describe("The ad set ID to adjust"),
+        bidAmount: z.number().int().min(1).describe("New bid amount in cents (100 = $1.00 USD)"),
+    }))
+        .min(1)
+        .max(50)
+        .describe("Bid adjustments to apply (max 50)"),
+    reason: z.string().optional().describe("Optional reason for the bid adjustment"),
+})
+    .describe("Parameters for batch bid adjustment on Meta ad sets");
+export const AdjustBidsOutputSchema = z
+    .object({
+    confirmed: z.boolean(),
+    declineReason: z.string().optional(),
+    totalRequested: z.number(),
+    totalSucceeded: z.number(),
+    totalFailed: z.number(),
+    results: z.array(z.object({
+        adSetId: z.string(),
+        success: z.boolean(),
+        adSetName: z.string().optional(),
+        previousBidAmount: z.number().optional(),
+        newBidAmount: z.number().optional(),
+        warning: z.string().optional(),
+        error: z.string().optional(),
+    })),
+    timestamp: z.string().datetime(),
+})
+    .describe("Bid adjustment results");
+export async function adjustBidsLogic(input, context, sdkContext) {
+    const confirmed = await elicitBidChangeConfirmation({
+        count: input.adjustments.length,
+        entityLabel: "ad set",
+        summary: input.reason ?? "Applying bid amount changes (manual-bid ad sets only).",
+        impactPreview: input.adjustments.map((a) => a.adSetId),
+        sdkContext,
+    });
+    if (!confirmed) {
+        return {
+            confirmed: false,
+            declineReason: "user_declined",
+            totalRequested: input.adjustments.length,
+            totalSucceeded: 0,
+            totalFailed: 0,
+            results: [],
+            timestamp: new Date().toISOString(),
+        };
+    }
+    const { metaService } = resolveSessionServices(sdkContext);
+    const results = [];
+    for (const adjustment of input.adjustments) {
+        try {
+            const entity = await metaService.getEntity("adSet", adjustment.adSetId, ["id", "name", "bid_amount", "bid_strategy"], context);
+            const adSetName = entity.name;
+            const previousBidAmount = entity.bid_amount != null ? entity.bid_amount : undefined;
+            const bidStrategy = entity.bid_strategy;
+            let warning;
+            if (bidStrategy && AUTO_BID_STRATEGIES.has(bidStrategy)) {
+                warning = `Ad set uses auto-bidding strategy "${bidStrategy}"; bid_amount may be ignored.`;
+            }
+            await metaService.updateEntity(adjustment.adSetId, { bid_amount: adjustment.bidAmount }, context);
+            results.push({
+                adSetId: adjustment.adSetId,
+                success: true,
+                adSetName,
+                previousBidAmount,
+                newBidAmount: adjustment.bidAmount,
+                warning,
+            });
+        }
+        catch (error) {
+            results.push({
+                adSetId: adjustment.adSetId,
+                success: false,
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    const totalSucceeded = results.filter((r) => r.success).length;
+    return {
+        confirmed: true,
+        totalRequested: input.adjustments.length,
+        totalSucceeded,
+        totalFailed: input.adjustments.length - totalSucceeded,
+        results,
+        timestamp: new Date().toISOString(),
+    };
+}
+export function adjustBidsResponseFormatter(result) {
+    if (!result.confirmed) {
+        return [
+            {
+                type: "text",
+                text: `Bid adjustments cancelled by user.\n\nTimestamp: ${result.timestamp}`,
+            },
+        ];
+    }
+    const lines = [];
+    lines.push(`Bid adjustments: ${result.totalSucceeded}/${result.totalRequested} succeeded, ${result.totalFailed} failed`);
+    lines.push("");
+    for (const r of result.results) {
+        if (r.success) {
+            const name = r.adSetName ? ` (${r.adSetName})` : "";
+            const prev = r.previousBidAmount ?? "unknown";
+            lines.push(`  ${r.adSetId}${name}: ${prev} -> ${r.newBidAmount} cents`);
+            if (r.warning) {
+                lines.push(`    WARNING: ${r.warning}`);
+            }
+        }
+        else {
+            lines.push(`  ${r.adSetId}: FAILED - ${r.error}`);
+        }
+    }
+    lines.push("");
+    lines.push("Amounts in cents (100 = $1.00 USD)");
+    lines.push(`Timestamp: ${result.timestamp}`);
+    return [
+        {
+            type: "text",
+            text: lines.join("\n"),
+        },
+    ];
+}
+export const adjustBidsTool = {
+    name: TOOL_NAME,
+    title: TOOL_TITLE,
+    description: TOOL_DESCRIPTION,
+    inputSchema: AdjustBidsInputSchema,
+    outputSchema: AdjustBidsOutputSchema,
+    annotations: {
+        readOnlyHint: false,
+        openWorldHint: true,
+        idempotentHint: true,
+        destructiveHint: true,
+    },
+    inputExamples: [
+        {
+            label: "Single bid adjustment",
+            input: {
+                adjustments: [{ adSetId: "23851234567890", bidAmount: 500 }],
+            },
+        },
+        {
+            label: "Multiple bid adjustments with reason",
+            input: {
+                adjustments: [
+                    { adSetId: "23851111", bidAmount: 350 },
+                    { adSetId: "23852222", bidAmount: 750 },
+                ],
+                reason: "Increase bids to improve delivery pacing",
+            },
+        },
+    ],
+    logic: adjustBidsLogic,
+    responseFormatter: adjustBidsResponseFormatter,
+};
+//# sourceMappingURL=adjust-bids.tool.js.map

package/dist/mcp-server/tools/definitions/adjust-bids.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adjust-bids.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/adjust-bids.tool.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,143 @@
+import { z } from "zod";
+import type { RequestContext, McpTextContent } from "@cesteral/shared";
+import type { SdkContext } from "@cesteral/shared";
+export declare const BulkCreateEntitiesInputSchema: z.ZodObject<{
+    entityType: z.ZodEnum<[string, ...string[]]>;
+    adAccountId: z.ZodString;
+    items: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">;
+}, "strip", z.ZodTypeAny, {
+    entityType: string;
+    adAccountId: string;
+    items: Record<string, any>[];
+}, {
+    entityType: string;
+    adAccountId: string;
+    items: Record<string, any>[];
+}>;
+export declare const BulkCreateEntitiesOutputSchema: z.ZodObject<{
+    results: z.ZodArray<z.ZodObject<{
+        success: z.ZodBoolean;
+        entity: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        error: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        success: boolean;
+        error?: string | undefined;
+        entity?: Record<string, any> | undefined;
+    }, {
+        success: boolean;
+        error?: string | undefined;
+        entity?: Record<string, any> | undefined;
+    }>, "many">;
+    successCount: z.ZodNumber;
+    failureCount: z.ZodNumber;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    results: {
+        success: boolean;
+        error?: string | undefined;
+        entity?: Record<string, any> | undefined;
+    }[];
+    timestamp: string;
+    successCount: number;
+    failureCount: number;
+}, {
+    results: {
+        success: boolean;
+        error?: string | undefined;
+        entity?: Record<string, any> | undefined;
+    }[];
+    timestamp: string;
+    successCount: number;
+    failureCount: number;
+}>;
+type BulkCreateEntitiesInput = z.infer<typeof BulkCreateEntitiesInputSchema>;
+type BulkCreateEntitiesOutput = z.infer<typeof BulkCreateEntitiesOutputSchema>;
+export declare function bulkCreateEntitiesLogic(input: BulkCreateEntitiesInput, context: RequestContext, sdkContext?: SdkContext): Promise<BulkCreateEntitiesOutput>;
+export declare function bulkCreateEntitiesResponseFormatter(result: BulkCreateEntitiesOutput): McpTextContent[];
+export declare const bulkCreateEntitiesTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        entityType: z.ZodEnum<[string, ...string[]]>;
+        adAccountId: z.ZodString;
+        items: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        entityType: string;
+        adAccountId: string;
+        items: Record<string, any>[];
+    }, {
+        entityType: string;
+        adAccountId: string;
+        items: Record<string, any>[];
+    }>;
+    outputSchema: z.ZodObject<{
+        results: z.ZodArray<z.ZodObject<{
+            success: z.ZodBoolean;
+            entity: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+            error: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            success: boolean;
+            error?: string | undefined;
+            entity?: Record<string, any> | undefined;
+        }, {
+            success: boolean;
+            error?: string | undefined;
+            entity?: Record<string, any> | undefined;
+        }>, "many">;
+        successCount: z.ZodNumber;
+        failureCount: z.ZodNumber;
+        timestamp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        results: {
+            success: boolean;
+            error?: string | undefined;
+            entity?: Record<string, any> | undefined;
+        }[];
+        timestamp: string;
+        successCount: number;
+        failureCount: number;
+    }, {
+        results: {
+            success: boolean;
+            error?: string | undefined;
+            entity?: Record<string, any> | undefined;
+        }[];
+        timestamp: string;
+        successCount: number;
+        failureCount: number;
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        idempotentHint: boolean;
+        destructiveHint: boolean;
+    };
+    inputExamples: {
+        label: string;
+        input: {
+            entityType: string;
+            adAccountId: string;
+            items: {
+                name: string;
+                campaign_id: string;
+                optimization_goal: string;
+                billing_event: string;
+                daily_budget: number;
+                targeting: {
+                    age_min: number;
+                    age_max: number;
+                    genders: number[];
+                    geo_locations: {
+                        countries: string[];
+                    };
+                };
+                status: string;
+            }[];
+        };
+    }[];
+    logic: typeof bulkCreateEntitiesLogic;
+    responseFormatter: typeof bulkCreateEntitiesResponseFormatter;
+};
+export {};
+//# sourceMappingURL=bulk-create-entities.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bulk-create-entities.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/bulk-create-entities.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAcnD,eAAO,MAAM,6BAA6B;;;;;;;;;;;;EAUQ,CAAC;AAEnD,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAOR,CAAC;AAEpC,KAAK,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAC7E,KAAK,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAE/E,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,uBAAuB,EAC9B,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,wBAAwB,CAAC,CAkBnC;AAED,wBAAgB,mCAAmC,CACjD,MAAM,EAAE,wBAAwB,GAC/B,cAAc,EAAE,CAOlB;AAED,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqDlC,CAAC"}

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

@@ -0,0 +1,108 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+import { getEntityTypeEnum } from "../utils/entity-mapping.js";
+import { BulkOperationResultSchema } from "@cesteral/shared";
+const TOOL_NAME = "meta_bulk_create_entities";
+const TOOL_TITLE = "Bulk Create Meta Ads Entities";
+const TOOL_DESCRIPTION = `Batch create multiple entities of the same type.
+
+**Supported entity types:** ${getEntityTypeEnum().join(", ")}
+
+**Gotchas:**
+- Max 50 items per call.
+- Each creation consumes 3x rate limit tokens.
+- Per-item failure reporting (partial success possible).
+- Items are executed with concurrency limit of 5.`;
+export const BulkCreateEntitiesInputSchema = z
+    .object({
+    entityType: z.enum(getEntityTypeEnum()).describe("Type of entities to create"),
+    adAccountId: z.string().describe("Ad Account ID"),
+    items: z
+        .array(z.record(z.any()))
+        .min(1)
+        .max(50)
+        .describe("Array of entity data objects (max 50)"),
+})
+    .describe("Parameters for bulk entity creation");
+export const BulkCreateEntitiesOutputSchema = z
+    .object({
+    results: z.array(BulkOperationResultSchema),
+    successCount: z.number(),
+    failureCount: z.number(),
+    timestamp: z.string().datetime(),
+})
+    .describe("Bulk creation result");
+export async function bulkCreateEntitiesLogic(input, context, sdkContext) {
+    const { metaService } = resolveSessionServices(sdkContext);
+    const result = await metaService.bulkCreateEntities(input.entityType, input.adAccountId, input.items, context);
+    const successCount = result.results.filter((r) => r.success).length;
+    return {
+        results: result.results,
+        successCount,
+        failureCount: result.results.length - successCount,
+        timestamp: new Date().toISOString(),
+    };
+}
+export function bulkCreateEntitiesResponseFormatter(result) {
+    return [
+        {
+            type: "text",
+            text: `Bulk create: ${result.successCount} succeeded, ${result.failureCount} failed\n\n${JSON.stringify(result.results, null, 2)}\n\nTimestamp: ${result.timestamp}`,
+        },
+    ];
+}
+export const bulkCreateEntitiesTool = {
+    name: TOOL_NAME,
+    title: TOOL_TITLE,
+    description: TOOL_DESCRIPTION,
+    inputSchema: BulkCreateEntitiesInputSchema,
+    outputSchema: BulkCreateEntitiesOutputSchema,
+    annotations: {
+        readOnlyHint: false,
+        openWorldHint: false,
+        idempotentHint: false,
+        destructiveHint: true,
+    },
+    inputExamples: [
+        {
+            label: "Create multiple ad sets for a campaign",
+            input: {
+                entityType: "adSet",
+                adAccountId: "act_123456789",
+                items: [
+                    {
+                        name: "US 25-34 Males",
+                        campaign_id: "23456789012345",
+                        optimization_goal: "LINK_CLICKS",
+                        billing_event: "IMPRESSIONS",
+                        daily_budget: 5000,
+                        targeting: {
+                            age_min: 25,
+                            age_max: 34,
+                            genders: [1],
+                            geo_locations: { countries: ["US"] },
+                        },
+                        status: "PAUSED",
+                    },
+                    {
+                        name: "US 25-34 Females",
+                        campaign_id: "23456789012345",
+                        optimization_goal: "LINK_CLICKS",
+                        billing_event: "IMPRESSIONS",
+                        daily_budget: 5000,
+                        targeting: {
+                            age_min: 25,
+                            age_max: 34,
+                            genders: [2],
+                            geo_locations: { countries: ["US"] },
+                        },
+                        status: "PAUSED",
+                    },
+                ],
+            },
+        },
+    ],
+    logic: bulkCreateEntitiesLogic,
+    responseFormatter: bulkCreateEntitiesResponseFormatter,
+};
+//# sourceMappingURL=bulk-create-entities.tool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bulk-create-entities.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/bulk-create-entities.tool.ts"],"names":[],"mappings":"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"}