@cesteral/cm360-mcp 1.0.0

package/dist/mcp-server/resources/definitions/reporting-reference.resource.js

@@ -0,0 +1,62 @@
+export const reportingReferenceResource = {
+    uri: "reporting-reference://all",
+    name: "CM360 Reporting Reference",
+    description: "Report types, dimensions, metrics, and filters for CM360 async reporting",
+    mimeType: "text/markdown",
+    getContent: () => `# CM360 Reporting Reference
+
+## Report Types
+
+| Type | Description |
+|------|-------------|
+| STANDARD | Standard delivery metrics |
+| REACH | Reach and frequency reporting |
+| FLOODLIGHT | Conversion (Floodlight) reporting |
+| PATH_TO_CONVERSION | Multi-touch attribution paths |
+| CROSS_DIMENSION_REACH | Cross-dimension reach analysis |
+
+## Common Dimensions
+
+| Dimension | Description |
+|-----------|-------------|
+| campaign | Campaign name/ID |
+| placement | Placement name/ID |
+| ad | Ad name/ID |
+| creative | Creative name/ID |
+| site | Site name/ID |
+| advertiser | Advertiser name/ID |
+| date | Date (daily granularity) |
+| week | Week |
+| month | Month |
+
+## Common Metrics
+
+| Metric | Description |
+|--------|-------------|
+| impressions | Total ad impressions served |
+| clicks | Total clicks |
+| totalConversions | All Floodlight conversions |
+| totalConversionsRevenue | Conversion revenue |
+| richMediaVideoViews | Video view count |
+| richMediaVideoCompletions | Video completions |
+| activeViewViewableImpressions | Viewable impressions (Active View) |
+| activeViewMeasurableImpressions | Measurable impressions |
+
+## Async Report Flow
+
+1. **Submit**: \`cm360_submit_report\` or \`cm360_get_report\` (blocking)
+2. **Poll**: \`cm360_check_report_status\` (for non-blocking flow)
+3. **Download**: \`cm360_download_report\` (parse CSV results)
+
+## Date Format
+
+Use \`YYYY-MM-DD\` format for startDate and endDate.
+
+## Gotchas
+
+- Reports are async — processing can take minutes for large date ranges
+- Use \`cm360_get_report\` for simplicity (handles poll + download)
+- Large reports may need non-blocking flow to avoid timeouts
+`,
+};
+//# sourceMappingURL=reporting-reference.resource.js.map

package/dist/mcp-server/resources/definitions/reporting-reference.resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporting-reference.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/reporting-reference.resource.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,0BAA0B,GAAa;IAClD,GAAG,EAAE,2BAA2B;IAChC,IAAI,EAAE,2BAA2B;IACjC,WAAW,EAAE,0EAA0E;IACvF,QAAQ,EAAE,eAAe;IACzB,UAAU,EAAE,GAAG,EAAE,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsDnB;CACA,CAAC"}

package/dist/mcp-server/resources/definitions/targeting-reference.resource.d.ts

@@ -0,0 +1,3 @@
+import type { Resource } from "../types.js";
+export declare const targetingReferenceResource: Resource;
+//# sourceMappingURL=targeting-reference.resource.d.ts.map

package/dist/mcp-server/resources/definitions/targeting-reference.resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"targeting-reference.resource.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/targeting-reference.resource.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,eAAO,MAAM,0BAA0B,EAAE,QA4CxC,CAAC"}

package/dist/mcp-server/resources/definitions/targeting-reference.resource.js

@@ -0,0 +1,46 @@
+export const targetingReferenceResource = {
+    uri: "targeting-reference://all",
+    name: "CM360 Targeting Reference",
+    description: "Targeting option types and patterns for CM360 ad serving",
+    mimeType: "text/markdown",
+    getContent: () => `# CM360 Targeting Reference
+
+## Targeting Categories
+
+| Category | Description |
+|----------|-------------|
+| Geographic | Countries, regions, cities, DMAs, postal codes |
+| Content | Content categories, verticals |
+| Technology | Browsers, operating systems, connection types, device types |
+| Audience | First-party and third-party audience segments |
+| Language | Language targeting |
+| Day/Time | Day parting and time-based scheduling |
+
+## Targeting Scope
+
+CM360 targeting is applied at:
+- **Placement level** — most common for site-level targeting
+- **Ad level** — for more granular creative-level targeting
+
+## Discovery
+
+Use \`cm360_list_targeting_options\` to browse available targeting options:
+\`\`\`json
+{
+  "tool": "cm360_list_targeting_options",
+  "params": {
+    "profileId": "PROFILE_ID",
+    "targetingType": "all"
+  }
+}
+\`\`\`
+
+## Notes
+
+- CM360 is primarily an ad server, not a self-serve buying platform
+- Targeting options are simpler than DSP platforms (DV360, TTD, Meta)
+- Most advanced targeting is configured in the buying platforms
+- CM360 targeting focuses on ad serving rules and content safety
+`,
+};
+//# sourceMappingURL=targeting-reference.resource.js.map

package/dist/mcp-server/resources/definitions/targeting-reference.resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"targeting-reference.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/targeting-reference.resource.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,0BAA0B,GAAa;IAClD,GAAG,EAAE,2BAA2B;IAChC,IAAI,EAAE,2BAA2B;IACjC,WAAW,EAAE,0DAA0D;IACvE,QAAQ,EAAE,eAAe;IACzB,UAAU,EAAE,GAAG,EAAE,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsCnB;CACA,CAAC"}

package/dist/mcp-server/resources/index.d.ts

@@ -0,0 +1,3 @@
+export type { Resource } from "./types.js";
+export { allResources } from "./definitions/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp-server/resources/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/resources/index.ts"],"names":[],"mappings":"AAOA,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/mcp-server/resources/index.js

@@ -0,0 +1,2 @@
+export { allResources } from "./definitions/index.js";
+//# sourceMappingURL=index.js.map

package/dist/mcp-server/resources/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mcp-server/resources/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/mcp-server/resources/types.d.ts

@@ -0,0 +1,8 @@
+export interface Resource {
+    uri: string;
+    name: string;
+    description: string;
+    mimeType: string;
+    getContent: () => string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/mcp-server/resources/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/resources/types.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,QAAQ;IAEvB,GAAG,EAAE,MAAM,CAAC;IAEZ,IAAI,EAAE,MAAM,CAAC;IAEb,WAAW,EAAE,MAAM,CAAC;IAEpB,QAAQ,EAAE,MAAM,CAAC;IAEjB,UAAU,EAAE,MAAM,MAAM,CAAC;CAC1B"}

package/dist/mcp-server/resources/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/mcp-server/resources/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/mcp-server/resources/types.ts"],"names":[],"mappings":""}

package/dist/mcp-server/server.d.ts

@@ -0,0 +1,5 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { Logger } from "pino";
+export declare function createMcpServer(logger: Logger, sessionId?: string, gcsBucket?: string): Promise<McpServer>;
+export declare function runStdioServer(server: McpServer, logger: Logger): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/mcp-server/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp-server/server.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAkBpE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAgCnC,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,SAAS,CAAC,CAyHpB;AAKD,wBAAsB,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKrF"}

package/dist/mcp-server/server.js

@@ -0,0 +1,124 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { allTools } from "./tools/index.js";
+import { allResources } from "./resources/index.js";
+import { promptRegistry } from "./prompts/index.js";
+import { createOperationContext } from "@cesteral/shared";
+import { sessionServiceStore } from "../services/session-services.js";
+import { extractZodShape, registerToolsFromDefinitions, registerPromptsFromDefinitions, registerStaticResourcesFromDefinitions, InteractionLogger, isConformanceFixturesEnabled, } from "@cesteral/shared";
+import packageJson from "../../package.json" with { type: "json" };
+const CM360_PACKAGE_NAME = "cm360-mcp";
+const CM360_PLATFORM = "cm360-management";
+const cm360WorkflowIdByToolName = {
+    cm360_list_user_profiles: "mcp.execute.cm360_entity_read",
+    cm360_get_entity: "mcp.execute.cm360_entity_read",
+    cm360_list_entities: "mcp.execute.cm360_entity_read",
+    cm360_validate_entity: "mcp.execute.cm360_entity_read",
+    cm360_get_ad_preview: "mcp.execute.cm360_entity_read",
+    cm360_list_targeting_options: "mcp.execute.cm360_targeting",
+    cm360_create_entity: "mcp.execute.cm360_entity_update",
+    cm360_update_entity: "mcp.execute.cm360_entity_update",
+    cm360_delete_entity: "mcp.execute.cm360_entity_update",
+    cm360_bulk_update_status: "mcp.execute.cm360_bulk",
+    cm360_bulk_create_entities: "mcp.execute.cm360_bulk",
+    cm360_bulk_update_entities: "mcp.execute.cm360_bulk",
+    cm360_get_report: "mcp.execute.cm360_reporting",
+    cm360_submit_report: "mcp.execute.cm360_reporting",
+    cm360_check_report_status: "mcp.execute.cm360_reporting",
+    cm360_download_report: "mcp.execute.cm360_reporting",
+};
+export async function createMcpServer(logger, sessionId, gcsBucket) {
+    const server = new McpServer({
+        name: "cm360-mcp",
+        version: packageJson.version,
+        description: "Campaign Manager 360 ad serving and trafficking management via CM360 API v5. Supports CRUD operations on campaigns, placements, ads, creatives, floodlight activities, and async reporting.",
+    }, {
+        capabilities: {
+            logging: {},
+        },
+        instructions: "CM360 campaign management and reporting server. Use cm360_list_user_profiles to discover your profileId first. " +
+            "Supports CRUD for campaigns, placements, ads, creatives, sites, advertisers, and floodlight activities via CM360 API v5. " +
+            "Async reporting via cm360_get_report (blocking) or cm360_submit_report + cm360_check_report_status + cm360_download_report (non-blocking).",
+    });
+    const interactionLogger = new InteractionLogger({
+        serverName: CM360_PACKAGE_NAME,
+        logger,
+        gcsBucket,
+    });
+    registerToolsFromDefinitions({
+        server,
+        tools: allTools,
+        logger,
+        sessionId,
+        transformSchema: (schema) => extractZodShape(schema),
+        createRequestContext: (params) => createOperationContext({
+            operation: params.operation,
+            additionalContext: params.additionalContext,
+        }),
+        defaultTextFormat: "compact",
+        packageName: CM360_PACKAGE_NAME,
+        platform: CM360_PLATFORM,
+        workflowIdByToolName: cm360WorkflowIdByToolName,
+        interactionLogger,
+        authContextResolver: sessionId
+            ? () => sessionServiceStore.getAuthContext(sessionId)
+            : undefined,
+    });
+    registerStaticResourcesFromDefinitions({
+        server,
+        resources: allResources,
+        logger,
+    });
+    if (isConformanceFixturesEnabled()) {
+        const { conformanceResources, conformanceResourceTemplate, conformancePrompts, registerStaticResourcesFromDefinitions, } = await import("@cesteral/shared");
+        const { ResourceTemplate: McpResourceTemplate } = await import("@modelcontextprotocol/sdk/server/mcp.js");
+        registerStaticResourcesFromDefinitions({
+            server,
+            resources: conformanceResources,
+            logger,
+        });
+        const template = new McpResourceTemplate(conformanceResourceTemplate.uriTemplate, {
+            list: undefined,
+        });
+        server.registerResource("conformance_template", template, {
+            description: conformanceResourceTemplate.description,
+            mimeType: conformanceResourceTemplate.mimeType,
+        }, async (uri, variables) => {
+            const id = variables.id || "unknown";
+            const content = conformanceResourceTemplate.getContent(id);
+            return {
+                contents: [
+                    {
+                        uri: uri.href,
+                        mimeType: conformanceResourceTemplate.mimeType,
+                        text: content,
+                    },
+                ],
+            };
+        });
+        registerPromptsFromDefinitions({
+            server: server,
+            prompts: conformancePrompts,
+            logger,
+        });
+    }
+    const allPrompts = Array.from(promptRegistry.values()).map((def) => ({
+        name: def.prompt.name,
+        description: def.prompt.description ?? "",
+        arguments: def.prompt.arguments,
+        generateMessage: def.generateMessage,
+    }));
+    registerPromptsFromDefinitions({
+        server: server,
+        prompts: allPrompts,
+        logger,
+    });
+    return server;
+}
+export async function runStdioServer(server, logger) {
+    logger.info("Starting MCP server with stdio transport");
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    logger.info("MCP server connected via stdio");
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp-server/server.js.map

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

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

@@ -0,0 +1,147 @@
+import { z } from "zod";
+import type { RequestContext, McpTextContent } from "@cesteral/shared";
+import type { SdkContext } from "@cesteral/shared";
+export declare const BulkCreateEntitiesInputSchema: z.ZodObject<{
+    profileId: z.ZodString;
+    entityType: z.ZodEnum<[string, ...string[]]>;
+    items: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">;
+}, "strip", z.ZodTypeAny, {
+    entityType: string;
+    items: Record<string, any>[];
+    profileId: string;
+}, {
+    entityType: string;
+    items: Record<string, any>[];
+    profileId: string;
+}>;
+export declare const BulkCreateEntitiesOutputSchema: z.ZodObject<{
+    created: z.ZodNumber;
+    failed: z.ZodNumber;
+    results: z.ZodArray<z.ZodObject<{
+        index: z.ZodNumber;
+        success: z.ZodBoolean;
+        entity: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        error: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        success: boolean;
+        index: number;
+        error?: string | undefined;
+        entity?: Record<string, any> | undefined;
+    }, {
+        success: boolean;
+        index: number;
+        error?: string | undefined;
+        entity?: Record<string, any> | undefined;
+    }>, "many">;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    timestamp: string;
+    failed: number;
+    results: {
+        success: boolean;
+        index: number;
+        error?: string | undefined;
+        entity?: Record<string, any> | undefined;
+    }[];
+    created: number;
+}, {
+    timestamp: string;
+    failed: number;
+    results: {
+        success: boolean;
+        index: number;
+        error?: string | undefined;
+        entity?: Record<string, any> | undefined;
+    }[];
+    created: 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<{
+        profileId: z.ZodString;
+        entityType: z.ZodEnum<[string, ...string[]]>;
+        items: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        entityType: string;
+        items: Record<string, any>[];
+        profileId: string;
+    }, {
+        entityType: string;
+        items: Record<string, any>[];
+        profileId: string;
+    }>;
+    outputSchema: z.ZodObject<{
+        created: z.ZodNumber;
+        failed: z.ZodNumber;
+        results: z.ZodArray<z.ZodObject<{
+            index: z.ZodNumber;
+            success: z.ZodBoolean;
+            entity: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+            error: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            success: boolean;
+            index: number;
+            error?: string | undefined;
+            entity?: Record<string, any> | undefined;
+        }, {
+            success: boolean;
+            index: number;
+            error?: string | undefined;
+            entity?: Record<string, any> | undefined;
+        }>, "many">;
+        timestamp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        timestamp: string;
+        failed: number;
+        results: {
+            success: boolean;
+            index: number;
+            error?: string | undefined;
+            entity?: Record<string, any> | undefined;
+        }[];
+        created: number;
+    }, {
+        timestamp: string;
+        failed: number;
+        results: {
+            success: boolean;
+            index: number;
+            error?: string | undefined;
+            entity?: Record<string, any> | undefined;
+        }[];
+        created: number;
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+    };
+    inputExamples: {
+        label: string;
+        input: {
+            profileId: string;
+            entityType: string;
+            items: {
+                name: string;
+                campaignId: string;
+                siteId: string;
+                compatibility: string;
+                size: {
+                    width: number;
+                    height: number;
+                };
+            }[];
+        };
+    }[];
+    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;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAQnD,eAAO,MAAM,6BAA6B;;;;;;;;;;;;EAUQ,CAAC;AAEnD,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgBR,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,CA2BnC;AAED,wBAAgB,mCAAmC,CACjD,MAAM,EAAE,wBAAwB,GAC/B,cAAc,EAAE,CAclB;AAED,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuClC,CAAC"}

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

@@ -0,0 +1,109 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+import { getEntityTypeEnum } from "../utils/entity-mapping.js";
+const TOOL_NAME = "cm360_bulk_create_entities";
+const TOOL_TITLE = "Bulk Create CM360 Entities";
+const TOOL_DESCRIPTION = `Batch create multiple CM360 entities of the same type.
+
+Loops individual create calls with rate limiting. At ~1 QPS, 50 items takes ~50 seconds. Max 50 items per call.`;
+export const BulkCreateEntitiesInputSchema = z
+    .object({
+    profileId: z.string().min(1).describe("CM360 User Profile ID"),
+    entityType: z.enum(getEntityTypeEnum()).describe("Type of entities to create"),
+    items: z
+        .array(z.record(z.any()))
+        .min(1)
+        .max(50)
+        .describe("Array of entity data objects to create (max 50)"),
+})
+    .describe("Parameters for bulk entity creation");
+export const BulkCreateEntitiesOutputSchema = z
+    .object({
+    created: z.number().describe("Number of entities created"),
+    failed: z.number().describe("Number that failed"),
+    results: z
+        .array(z.object({
+        index: z.number(),
+        success: z.boolean(),
+        entity: z.record(z.any()).optional(),
+        error: z.string().optional(),
+    }))
+        .describe("Per-item results"),
+    timestamp: z.string().datetime(),
+})
+    .describe("Bulk creation result");
+export async function bulkCreateEntitiesLogic(input, context, sdkContext) {
+    const { cm360Service } = resolveSessionServices(sdkContext);
+    const bulkResults = await cm360Service.bulkCreateEntities(input.entityType, input.profileId, input.items, context);
+    let created = 0;
+    let failed = 0;
+    const results = bulkResults.map((r, i) => {
+        if (r.success) {
+            created++;
+            return { index: i, success: true, entity: r.entity };
+        }
+        failed++;
+        return { index: i, success: false, error: r.error };
+    });
+    return {
+        created,
+        failed,
+        results,
+        timestamp: new Date().toISOString(),
+    };
+}
+export function bulkCreateEntitiesResponseFormatter(result) {
+    const summary = `Bulk create: ${result.created} succeeded, ${result.failed} failed`;
+    const failures = result.results
+        .filter((r) => !r.success)
+        .map((r) => `  - Item ${r.index}: ${r.error}`)
+        .join("\n");
+    const failureDetails = failures ? `\n\nFailures:\n${failures}` : "";
+    return [
+        {
+            type: "text",
+            text: `${summary}${failureDetails}\n\nTimestamp: ${result.timestamp}`,
+        },
+    ];
+}
+export const bulkCreateEntitiesTool = {
+    name: TOOL_NAME,
+    title: TOOL_TITLE,
+    description: TOOL_DESCRIPTION,
+    inputSchema: BulkCreateEntitiesInputSchema,
+    outputSchema: BulkCreateEntitiesOutputSchema,
+    annotations: {
+        readOnlyHint: false,
+        openWorldHint: true,
+        destructiveHint: true,
+        idempotentHint: false,
+    },
+    inputExamples: [
+        {
+            label: "Create multiple placements",
+            input: {
+                profileId: "123456",
+                entityType: "placement",
+                items: [
+                    {
+                        name: "Homepage Banner 728x90",
+                        campaignId: "789012",
+                        siteId: "456789",
+                        compatibility: "DISPLAY",
+                        size: { width: 728, height: 90 },
+                    },
+                    {
+                        name: "Sidebar 300x250",
+                        campaignId: "789012",
+                        siteId: "456789",
+                        compatibility: "DISPLAY",
+                        size: { width: 300, height: 250 },
+                    },
+                ],
+            },
+        },
+    ],
+    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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"}