@cesteral/linkedin-mcp 1.0.0

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

@@ -0,0 +1,122 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+import { getEntityTypeEnum } from "../utils/entity-mapping.js";
+import { BulkOperationResultSchema, elicitBulkMutationConfirmation, hasSensitiveBulkField, } from "@cesteral/shared";
+const TOOL_NAME = "linkedin_bulk_update_entities";
+const TOOL_TITLE = "Bulk Update LinkedIn Ads Entities";
+const TOOL_DESCRIPTION = `Batch update multiple LinkedIn Ads entities with arbitrary data.
+
+**Supported entity types:** ${getEntityTypeEnum().join(", ")}
+
+Each item must include \`entityUrn\` and \`data\` to update.
+Updates are applied individually with concurrency (max 5 concurrent).
+
+**Gotchas:**
+- Max 50 items per call.
+- Partial failures are allowed — check results for individual errors.`;
+export const BulkUpdateEntitiesInputSchema = z
+    .object({
+    entityType: z.enum(getEntityTypeEnum()).describe("Type of entities to update"),
+    items: z
+        .array(z.object({
+        entityUrn: z.string().describe("Entity URN to update"),
+        data: z.record(z.any()).describe("Fields to update"),
+    }))
+        .min(1)
+        .max(50)
+        .describe("Update items (max 50)"),
+})
+    .describe("Parameters for bulk entity updates");
+export const BulkUpdateEntitiesOutputSchema = z
+    .object({
+    confirmed: z.boolean(),
+    declineReason: z.string().optional(),
+    results: z.array(BulkOperationResultSchema.extend({
+        entityUrn: z.string(),
+    })),
+    successCount: z.number(),
+    failureCount: z.number(),
+    timestamp: z.string().datetime(),
+})
+    .describe("Bulk update result");
+export async function bulkUpdateEntitiesLogic(input, context, sdkContext) {
+    const payloads = input.items.map((it) => it.data ?? {});
+    const confirmed = await elicitBulkMutationConfirmation({
+        count: input.items.length,
+        entityLabel: input.entityType,
+        summary: "Applying field updates across multiple LinkedIn Ads entities.",
+        hasSensitiveFieldChange: hasSensitiveBulkField(payloads),
+        impactPreview: input.items.map((it) => it.entityUrn),
+        sdkContext,
+    });
+    if (!confirmed) {
+        return {
+            confirmed: false,
+            declineReason: "user_declined",
+            results: [],
+            successCount: 0,
+            failureCount: 0,
+            timestamp: new Date().toISOString(),
+        };
+    }
+    const { linkedInService } = resolveSessionServices(sdkContext);
+    const result = await linkedInService.bulkUpdateEntities(input.entityType, input.items, context);
+    const successCount = result.results.filter((r) => r.success).length;
+    return {
+        confirmed: true,
+        results: result.results,
+        successCount,
+        failureCount: result.results.length - successCount,
+        timestamp: new Date().toISOString(),
+    };
+}
+export function bulkUpdateEntitiesResponseFormatter(result) {
+    if (!result.confirmed) {
+        return [
+            {
+                type: "text",
+                text: `Bulk update cancelled by user.\n\nTimestamp: ${result.timestamp}`,
+            },
+        ];
+    }
+    return [
+        {
+            type: "text",
+            text: `Bulk update: ${result.successCount} succeeded, ${result.failureCount} failed\n\n${JSON.stringify(result.results, null, 2)}\n\nTimestamp: ${result.timestamp}`,
+        },
+    ];
+}
+export const bulkUpdateEntitiesTool = {
+    name: TOOL_NAME,
+    title: TOOL_TITLE,
+    description: TOOL_DESCRIPTION,
+    inputSchema: BulkUpdateEntitiesInputSchema,
+    outputSchema: BulkUpdateEntitiesOutputSchema,
+    annotations: {
+        readOnlyHint: false,
+        openWorldHint: false,
+        idempotentHint: true,
+        destructiveHint: true,
+    },
+    inputExamples: [
+        {
+            label: "Update daily budgets for multiple campaigns",
+            input: {
+                entityType: "campaign",
+                items: [
+                    {
+                        entityUrn: "urn:li:sponsoredCampaign:111111111",
+                        data: { dailyBudget: { amount: "75.00", currencyCode: "USD" } },
+                    },
+                    {
+                        entityUrn: "urn:li:sponsoredCampaign:222222222",
+                        data: { dailyBudget: { amount: "100.00", currencyCode: "USD" } },
+                    },
+                ],
+            },
+        },
+    ],
+    logic: bulkUpdateEntitiesLogic,
+    responseFormatter: bulkUpdateEntitiesResponseFormatter,
+};
+//# sourceMappingURL=bulk-update-entities.tool.js.map

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

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

package/dist/mcp-server/tools/definitions/bulk-update-status.tool.d.ts

@@ -0,0 +1,140 @@
+import { z } from "zod";
+import type { RequestContext, McpTextContent } from "@cesteral/shared";
+import type { SdkContext } from "@cesteral/shared";
+export declare const BulkUpdateStatusInputSchema: z.ZodObject<{
+    entityType: z.ZodEnum<[string, ...string[]]>;
+    entityUrns: z.ZodArray<z.ZodString, "many">;
+    status: z.ZodEnum<["ACTIVE", "PAUSED", "DRAFT", "ARCHIVED", "CANCELED"]>;
+}, "strip", z.ZodTypeAny, {
+    status: "ACTIVE" | "PAUSED" | "ARCHIVED" | "CANCELED" | "DRAFT";
+    entityType: string;
+    entityUrns: string[];
+}, {
+    status: "ACTIVE" | "PAUSED" | "ARCHIVED" | "CANCELED" | "DRAFT";
+    entityType: string;
+    entityUrns: string[];
+}>;
+export declare const BulkUpdateStatusOutputSchema: z.ZodObject<{
+    confirmed: z.ZodBoolean;
+    declineReason: z.ZodOptional<z.ZodString>;
+    results: z.ZodArray<z.ZodObject<{
+        entityUrn: z.ZodString;
+        success: z.ZodBoolean;
+        error: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        entityUrn: string;
+        success: boolean;
+        error?: string | undefined;
+    }, {
+        entityUrn: string;
+        success: boolean;
+        error?: string | undefined;
+    }>, "many">;
+    successCount: z.ZodNumber;
+    failureCount: z.ZodNumber;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    results: {
+        entityUrn: string;
+        success: boolean;
+        error?: string | undefined;
+    }[];
+    timestamp: string;
+    confirmed: boolean;
+    successCount: number;
+    failureCount: number;
+    declineReason?: string | undefined;
+}, {
+    results: {
+        entityUrn: string;
+        success: boolean;
+        error?: string | undefined;
+    }[];
+    timestamp: string;
+    confirmed: boolean;
+    successCount: number;
+    failureCount: number;
+    declineReason?: string | undefined;
+}>;
+type BulkUpdateStatusInput = z.infer<typeof BulkUpdateStatusInputSchema>;
+type BulkUpdateStatusOutput = z.infer<typeof BulkUpdateStatusOutputSchema>;
+export declare function bulkUpdateStatusLogic(input: BulkUpdateStatusInput, context: RequestContext, sdkContext?: SdkContext): Promise<BulkUpdateStatusOutput>;
+export declare function bulkUpdateStatusResponseFormatter(result: BulkUpdateStatusOutput): McpTextContent[];
+export declare const bulkUpdateStatusTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        entityType: z.ZodEnum<[string, ...string[]]>;
+        entityUrns: z.ZodArray<z.ZodString, "many">;
+        status: z.ZodEnum<["ACTIVE", "PAUSED", "DRAFT", "ARCHIVED", "CANCELED"]>;
+    }, "strip", z.ZodTypeAny, {
+        status: "ACTIVE" | "PAUSED" | "ARCHIVED" | "CANCELED" | "DRAFT";
+        entityType: string;
+        entityUrns: string[];
+    }, {
+        status: "ACTIVE" | "PAUSED" | "ARCHIVED" | "CANCELED" | "DRAFT";
+        entityType: string;
+        entityUrns: string[];
+    }>;
+    outputSchema: z.ZodObject<{
+        confirmed: z.ZodBoolean;
+        declineReason: z.ZodOptional<z.ZodString>;
+        results: z.ZodArray<z.ZodObject<{
+            entityUrn: z.ZodString;
+            success: z.ZodBoolean;
+            error: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            entityUrn: string;
+            success: boolean;
+            error?: string | undefined;
+        }, {
+            entityUrn: string;
+            success: boolean;
+            error?: string | undefined;
+        }>, "many">;
+        successCount: z.ZodNumber;
+        failureCount: z.ZodNumber;
+        timestamp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        results: {
+            entityUrn: string;
+            success: boolean;
+            error?: string | undefined;
+        }[];
+        timestamp: string;
+        confirmed: boolean;
+        successCount: number;
+        failureCount: number;
+        declineReason?: string | undefined;
+    }, {
+        results: {
+            entityUrn: string;
+            success: boolean;
+            error?: string | undefined;
+        }[];
+        timestamp: string;
+        confirmed: boolean;
+        successCount: number;
+        failureCount: number;
+        declineReason?: string | undefined;
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        idempotentHint: boolean;
+        destructiveHint: boolean;
+    };
+    inputExamples: {
+        label: string;
+        input: {
+            entityType: string;
+            entityUrns: string[];
+            status: string;
+        };
+    }[];
+    logic: typeof bulkUpdateStatusLogic;
+    responseFormatter: typeof bulkUpdateStatusResponseFormatter;
+};
+export {};
+//# sourceMappingURL=bulk-update-status.tool.d.ts.map

package/dist/mcp-server/tools/definitions/bulk-update-status.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulk-update-status.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/bulk-update-status.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAgBnD,eAAO,MAAM,2BAA2B;;;;;;;;;;;;EAMQ,CAAC;AAEjD,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAeD,CAAC;AAEzC,KAAK,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AACzE,KAAK,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAE3E,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,qBAAqB,EAC5B,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,sBAAsB,CAAC,CAqCjC;AAED,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,sBAAsB,GAC7B,cAAc,EAAE,CAelB;AAED,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwBhC,CAAC"}

package/dist/mcp-server/tools/definitions/bulk-update-status.tool.js

@@ -0,0 +1,109 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+import { getEntityTypeEnum } from "../utils/entity-mapping.js";
+import { elicitBulkStatusChangeConfirmation } from "@cesteral/shared";
+const TOOL_NAME = "linkedin_bulk_update_status";
+const TOOL_TITLE = "Bulk Update LinkedIn Ads Entity Status";
+const TOOL_DESCRIPTION = `Batch update status for multiple LinkedIn Ads entities.
+
+**Supported entity types:** ${getEntityTypeEnum().join(", ")}
+
+**Valid statuses:** ACTIVE, PAUSED, DRAFT, ARCHIVED, CANCELED
+
+**Gotchas:**
+- ARCHIVED entities cannot be reactivated.
+- Campaign groups must be paused before archiving.
+- Max 50 entities per call.
+- Each update consumes 3x rate limit tokens (write operation).`;
+export const BulkUpdateStatusInputSchema = z
+    .object({
+    entityType: z.enum(getEntityTypeEnum()).describe("Type of entities to update"),
+    entityUrns: z.array(z.string()).min(1).max(50).describe("Entity URNs to update (max 50)"),
+    status: z.enum(["ACTIVE", "PAUSED", "DRAFT", "ARCHIVED", "CANCELED"]).describe("Target status"),
+})
+    .describe("Parameters for bulk status update");
+export const BulkUpdateStatusOutputSchema = z
+    .object({
+    confirmed: z.boolean(),
+    declineReason: z.string().optional(),
+    results: z.array(z.object({
+        entityUrn: z.string(),
+        success: z.boolean(),
+        error: z.string().optional(),
+    })),
+    successCount: z.number(),
+    failureCount: z.number(),
+    timestamp: z.string().datetime(),
+})
+    .describe("Bulk status update result");
+export async function bulkUpdateStatusLogic(input, context, sdkContext) {
+    const confirmed = await elicitBulkStatusChangeConfirmation({
+        count: input.entityUrns.length,
+        entityLabel: input.entityType,
+        targetStatus: input.status,
+        impactPreview: input.entityUrns,
+        sdkContext,
+    });
+    if (!confirmed) {
+        return {
+            confirmed: false,
+            declineReason: "user_declined",
+            results: [],
+            successCount: 0,
+            failureCount: 0,
+            timestamp: new Date().toISOString(),
+        };
+    }
+    const { linkedInService } = resolveSessionServices(sdkContext);
+    const result = await linkedInService.bulkUpdateStatus(input.entityType, input.entityUrns, input.status, context);
+    const successCount = result.results.filter((r) => r.success).length;
+    return {
+        confirmed: true,
+        results: result.results,
+        successCount,
+        failureCount: result.results.length - successCount,
+        timestamp: new Date().toISOString(),
+    };
+}
+export function bulkUpdateStatusResponseFormatter(result) {
+    if (!result.confirmed) {
+        return [
+            {
+                type: "text",
+                text: `Bulk status update cancelled by user.\n\nTimestamp: ${result.timestamp}`,
+            },
+        ];
+    }
+    return [
+        {
+            type: "text",
+            text: `Bulk status update: ${result.successCount} succeeded, ${result.failureCount} failed\n\n${JSON.stringify(result.results, null, 2)}\n\nTimestamp: ${result.timestamp}`,
+        },
+    ];
+}
+export const bulkUpdateStatusTool = {
+    name: TOOL_NAME,
+    title: TOOL_TITLE,
+    description: TOOL_DESCRIPTION,
+    inputSchema: BulkUpdateStatusInputSchema,
+    outputSchema: BulkUpdateStatusOutputSchema,
+    annotations: {
+        readOnlyHint: false,
+        openWorldHint: false,
+        idempotentHint: true,
+        destructiveHint: true,
+    },
+    inputExamples: [
+        {
+            label: "Pause multiple campaigns",
+            input: {
+                entityType: "campaign",
+                entityUrns: ["urn:li:sponsoredCampaign:111111111", "urn:li:sponsoredCampaign:222222222"],
+                status: "PAUSED",
+            },
+        },
+    ],
+    logic: bulkUpdateStatusLogic,
+    responseFormatter: bulkUpdateStatusResponseFormatter,
+};
+//# sourceMappingURL=bulk-update-status.tool.js.map

package/dist/mcp-server/tools/definitions/bulk-update-status.tool.js.map

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

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

@@ -0,0 +1,117 @@
+import { z } from "zod";
+import type { RequestContext, McpTextContent } from "@cesteral/shared";
+import type { SdkContext } from "@cesteral/shared";
+export declare const CreateEntityInputSchema: z.ZodObject<{
+    entityType: z.ZodEnum<[string, ...string[]]>;
+    data: z.ZodRecord<z.ZodString, z.ZodAny>;
+}, "strip", z.ZodTypeAny, {
+    entityType: string;
+    data: Record<string, any>;
+}, {
+    entityType: string;
+    data: Record<string, any>;
+}>;
+export declare const CreateEntityOutputSchema: z.ZodObject<{
+    entity: z.ZodRecord<z.ZodString, z.ZodAny>;
+    entityType: z.ZodString;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    entityType: string;
+    timestamp: string;
+    entity: Record<string, any>;
+}, {
+    entityType: string;
+    timestamp: string;
+    entity: Record<string, any>;
+}>;
+type CreateEntityInput = z.infer<typeof CreateEntityInputSchema>;
+type CreateEntityOutput = z.infer<typeof CreateEntityOutputSchema>;
+export declare function createEntityLogic(input: CreateEntityInput, context: RequestContext, sdkContext?: SdkContext): Promise<CreateEntityOutput>;
+export declare function createEntityResponseFormatter(result: CreateEntityOutput): McpTextContent[];
+export declare const createEntityTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        entityType: z.ZodEnum<[string, ...string[]]>;
+        data: z.ZodRecord<z.ZodString, z.ZodAny>;
+    }, "strip", z.ZodTypeAny, {
+        entityType: string;
+        data: Record<string, any>;
+    }, {
+        entityType: string;
+        data: Record<string, any>;
+    }>;
+    outputSchema: z.ZodObject<{
+        entity: z.ZodRecord<z.ZodString, z.ZodAny>;
+        entityType: z.ZodString;
+        timestamp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        entityType: string;
+        timestamp: string;
+        entity: Record<string, any>;
+    }, {
+        entityType: string;
+        timestamp: string;
+        entity: Record<string, any>;
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        idempotentHint: boolean;
+        destructiveHint: boolean;
+    };
+    inputExamples: ({
+        label: string;
+        input: {
+            entityType: string;
+            data: {
+                name: string;
+                account: string;
+                status: string;
+                totalBudget: {
+                    amount: string;
+                    currencyCode: string;
+                };
+                runSchedule: {
+                    start: number;
+                    end: number;
+                };
+                campaignGroup?: undefined;
+                type?: undefined;
+                objectiveType?: undefined;
+                dailyBudget?: undefined;
+                bidType?: undefined;
+                unitCost?: undefined;
+            };
+        };
+    } | {
+        label: string;
+        input: {
+            entityType: string;
+            data: {
+                name: string;
+                campaignGroup: string;
+                account: string;
+                type: string;
+                objectiveType: string;
+                status: string;
+                dailyBudget: {
+                    amount: string;
+                    currencyCode: string;
+                };
+                bidType: string;
+                unitCost: {
+                    amount: string;
+                    currencyCode: string;
+                };
+                totalBudget?: undefined;
+                runSchedule?: undefined;
+            };
+        };
+    })[];
+    logic: typeof createEntityLogic;
+    responseFormatter: typeof createEntityResponseFormatter;
+};
+export {};
+//# sourceMappingURL=create-entity.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-entity.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/create-entity.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;AAoBnD,eAAO,MAAM,uBAAuB;;;;;;;;;EAKwB,CAAC;AAE7D,eAAO,MAAM,wBAAwB;;;;;;;;;;;;EAMA,CAAC;AAEtC,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,CAc7B;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,EAAE,CAO1F;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8C5B,CAAC"}

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

@@ -0,0 +1,98 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+import { getEntityTypeEnum } from "../utils/entity-mapping.js";
+const TOOL_NAME = "linkedin_create_entity";
+const TOOL_TITLE = "Create LinkedIn Ads Entity";
+const TOOL_DESCRIPTION = `Create a new LinkedIn Ads entity.
+
+**Supported entity types:** ${getEntityTypeEnum().join(", ")}
+
+**Key requirements by entity type:**
+- **campaignGroup**: requires \`name\`, \`account\` (URN), \`status\`
+- **campaign**: requires \`name\`, \`campaignGroup\` (URN), \`account\` (URN), \`type\`, \`objectiveType\`, \`status\`
+- **creative**: requires \`campaign\` (URN), \`status\`, \`reference\`
+- **conversionRule**: requires \`name\`, \`type\`, \`account\` (URN), \`status\`
+
+**Gotchas:**
+- All entity IDs are URNs (e.g., urn:li:sponsoredAccount:123)
+- Budget values use CurrencyAmount objects: \`{ "amount": "10.00", "currencyCode": "USD" }\`
+- Campaigns require \`type\` (TEXT_AD, SPONSORED_UPDATES, etc.) and \`objectiveType\`
+- Writes are rate-limited at 3x read cost`;
+export const CreateEntityInputSchema = z
+    .object({
+    entityType: z.enum(getEntityTypeEnum()).describe("Type of entity to create"),
+    data: z.record(z.any()).describe("Entity fields as key-value pairs"),
+})
+    .describe("Parameters for creating a LinkedIn Ads entity");
+export const CreateEntityOutputSchema = z
+    .object({
+    entity: z.record(z.any()).describe("Created entity (returns id/URN at minimum)"),
+    entityType: z.string(),
+    timestamp: z.string().datetime(),
+})
+    .describe("Entity creation result");
+export async function createEntityLogic(input, context, sdkContext) {
+    const { linkedInService } = resolveSessionServices(sdkContext);
+    const entity = await linkedInService.createEntity(input.entityType, input.data, context);
+    return {
+        entity: entity,
+        entityType: input.entityType,
+        timestamp: new Date().toISOString(),
+    };
+}
+export function createEntityResponseFormatter(result) {
+    return [
+        {
+            type: "text",
+            text: `${result.entityType} created successfully\n${JSON.stringify(result.entity, null, 2)}\n\nTimestamp: ${result.timestamp}`,
+        },
+    ];
+}
+export const createEntityTool = {
+    name: TOOL_NAME,
+    title: TOOL_TITLE,
+    description: TOOL_DESCRIPTION,
+    inputSchema: CreateEntityInputSchema,
+    outputSchema: CreateEntityOutputSchema,
+    annotations: {
+        readOnlyHint: false,
+        openWorldHint: false,
+        idempotentHint: false,
+        destructiveHint: true,
+    },
+    inputExamples: [
+        {
+            label: "Create a campaign group",
+            input: {
+                entityType: "campaignGroup",
+                data: {
+                    name: "Q1 2026 Brand Awareness",
+                    account: "urn:li:sponsoredAccount:123456789",
+                    status: "DRAFT",
+                    totalBudget: { amount: "5000.00", currencyCode: "USD" },
+                    runSchedule: { start: 1735689600000, end: 1748476800000 },
+                },
+            },
+        },
+        {
+            label: "Create a campaign",
+            input: {
+                entityType: "campaign",
+                data: {
+                    name: "LinkedIn Awareness Campaign",
+                    campaignGroup: "urn:li:sponsoredCampaignGroup:987654321",
+                    account: "urn:li:sponsoredAccount:123456789",
+                    type: "SPONSORED_UPDATES",
+                    objectiveType: "BRAND_AWARENESS",
+                    status: "DRAFT",
+                    dailyBudget: { amount: "50.00", currencyCode: "USD" },
+                    bidType: "CPM",
+                    unitCost: { amount: "10.00", currencyCode: "USD" },
+                },
+            },
+        },
+    ],
+    logic: createEntityLogic,
+    responseFormatter: createEntityResponseFormatter,
+};
+//# sourceMappingURL=create-entity.tool.js.map

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

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