@cesteral/tiktok-mcp 1.0.0

package/dist/mcp-server/tools/definitions/check-report-status.tool.d.ts

@@ -0,0 +1,119 @@
+import { z } from "zod";
+import type { RequestContext, McpTextContent } from "@cesteral/shared";
+import type { SdkContext } from "@cesteral/shared";
+export declare const CheckReportStatusInputSchema: z.ZodObject<{
+    advertiserId: z.ZodString;
+    taskId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    taskId: string;
+    advertiserId: string;
+}, {
+    taskId: string;
+    advertiserId: string;
+}>;
+export declare const CheckReportStatusOutputSchema: z.ZodObject<{
+    state: z.ZodEnum<["pending", "running", "complete", "failed", "cancelled"]>;
+    progress: z.ZodOptional<z.ZodNumber>;
+    downloadUrl: z.ZodOptional<z.ZodString>;
+    errors: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    submittedAt: z.ZodOptional<z.ZodString>;
+    completedAt: z.ZodOptional<z.ZodString>;
+} & {
+    taskId: z.ZodString;
+    rawStatus: z.ZodString;
+    isComplete: z.ZodBoolean;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    taskId: string;
+    timestamp: string;
+    rawStatus: string;
+    isComplete: boolean;
+    state: "pending" | "running" | "complete" | "failed" | "cancelled";
+    downloadUrl?: string | undefined;
+    progress?: number | undefined;
+    errors?: string[] | undefined;
+    submittedAt?: string | undefined;
+    completedAt?: string | undefined;
+}, {
+    taskId: string;
+    timestamp: string;
+    rawStatus: string;
+    isComplete: boolean;
+    state: "pending" | "running" | "complete" | "failed" | "cancelled";
+    downloadUrl?: string | undefined;
+    progress?: number | undefined;
+    errors?: string[] | undefined;
+    submittedAt?: string | undefined;
+    completedAt?: string | undefined;
+}>;
+type CheckReportStatusInput = z.infer<typeof CheckReportStatusInputSchema>;
+type CheckReportStatusOutput = z.infer<typeof CheckReportStatusOutputSchema>;
+export declare function checkReportStatusLogic(input: CheckReportStatusInput, context: RequestContext, sdkContext?: SdkContext): Promise<CheckReportStatusOutput>;
+export declare function checkReportStatusResponseFormatter(result: CheckReportStatusOutput): McpTextContent[];
+export declare const checkReportStatusTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        advertiserId: z.ZodString;
+        taskId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        taskId: string;
+        advertiserId: string;
+    }, {
+        taskId: string;
+        advertiserId: string;
+    }>;
+    outputSchema: z.ZodObject<{
+        state: z.ZodEnum<["pending", "running", "complete", "failed", "cancelled"]>;
+        progress: z.ZodOptional<z.ZodNumber>;
+        downloadUrl: z.ZodOptional<z.ZodString>;
+        errors: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        submittedAt: z.ZodOptional<z.ZodString>;
+        completedAt: z.ZodOptional<z.ZodString>;
+    } & {
+        taskId: z.ZodString;
+        rawStatus: z.ZodString;
+        isComplete: z.ZodBoolean;
+        timestamp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        taskId: string;
+        timestamp: string;
+        rawStatus: string;
+        isComplete: boolean;
+        state: "pending" | "running" | "complete" | "failed" | "cancelled";
+        downloadUrl?: string | undefined;
+        progress?: number | undefined;
+        errors?: string[] | undefined;
+        submittedAt?: string | undefined;
+        completedAt?: string | undefined;
+    }, {
+        taskId: string;
+        timestamp: string;
+        rawStatus: string;
+        isComplete: boolean;
+        state: "pending" | "running" | "complete" | "failed" | "cancelled";
+        downloadUrl?: string | undefined;
+        progress?: number | undefined;
+        errors?: string[] | undefined;
+        submittedAt?: string | undefined;
+        completedAt?: string | undefined;
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+    };
+    inputExamples: {
+        label: string;
+        input: {
+            advertiserId: string;
+            taskId: string;
+        };
+    }[];
+    logic: typeof checkReportStatusLogic;
+    responseFormatter: typeof checkReportStatusResponseFormatter;
+};
+export {};
+//# sourceMappingURL=check-report-status.tool.d.ts.map

package/dist/mcp-server/tools/definitions/check-report-status.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-report-status.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/check-report-status.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;AAanD,eAAO,MAAM,4BAA4B;;;;;;;;;EAKkB,CAAC;AAE5D,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAKD,CAAC;AAE1C,KAAK,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAC3E,KAAK,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAE7E,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,sBAAsB,EAC7B,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,uBAAuB,CAAC,CAiBlC;AAED,wBAAgB,kCAAkC,CAChD,MAAM,EAAE,uBAAuB,GAC9B,cAAc,EAAE,CAyBlB;AAED,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuBjC,CAAC"}

package/dist/mcp-server/tools/definitions/check-report-status.tool.js

@@ -0,0 +1,89 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+import { fromTikTokStatus, ReportStatusSchema } from "@cesteral/shared";
+const TOOL_NAME = "tiktok_check_report_status";
+const TOOL_TITLE = "Check TikTok Report Status";
+const TOOL_DESCRIPTION = `Check the status of a previously submitted TikTok report task.
+
+Makes a single API call to check task status. Does not poll or wait.
+
+**Canonical states:** \`pending\`, \`running\`, \`complete\`, \`failed\`, \`cancelled\`.
+TikTok raw statuses (PENDING/RUNNING/DONE/FAILED) are mapped; the raw string is returned as \`rawStatus\`.
+- If state is \`complete\` with a \`downloadUrl\`, use \`tiktok_download_report\` to fetch results.
+- If not done, call this tool again in ~10 seconds.`;
+export const CheckReportStatusInputSchema = z
+    .object({
+    advertiserId: z.string().min(1).describe("TikTok Advertiser ID"),
+    taskId: z.string().min(1).describe("Report task ID from tiktok_submit_report"),
+})
+    .describe("Parameters for checking TikTok report status");
+export const CheckReportStatusOutputSchema = ReportStatusSchema.extend({
+    taskId: z.string().describe("Report task ID"),
+    rawStatus: z.string().describe("Raw TikTok status (PENDING/RUNNING/DONE/FAILED)"),
+    isComplete: z.boolean().describe("Whether the canonical state is 'complete'"),
+    timestamp: z.string().datetime(),
+}).describe("Report status check result");
+export async function checkReportStatusLogic(input, context, sdkContext) {
+    const { tiktokReportingService } = resolveSessionServices(sdkContext);
+    const result = await tiktokReportingService.checkReportStatus(input.taskId, context);
+    const canonical = fromTikTokStatus({
+        status: result.status,
+        downloadUrl: result.downloadUrl,
+    });
+    return {
+        ...canonical,
+        taskId: result.taskId,
+        rawStatus: result.status,
+        isComplete: canonical.state === "complete",
+        timestamp: new Date().toISOString(),
+    };
+}
+export function checkReportStatusResponseFormatter(result) {
+    if (result.isComplete && result.downloadUrl) {
+        return [
+            {
+                type: "text",
+                text: `Report complete: ${result.taskId}\n\nDownload URL: ${result.downloadUrl}\n\nUse \`tiktok_download_report\` with this URL to fetch and parse the report data.\n\nTimestamp: ${result.timestamp}`,
+            },
+        ];
+    }
+    if (result.state === "failed") {
+        return [
+            {
+                type: "text",
+                text: `Report failed: ${result.taskId}\n\nThe report task failed. Check the report configuration and try again.\n\nTimestamp: ${result.timestamp}`,
+            },
+        ];
+    }
+    return [
+        {
+            type: "text",
+            text: `Report in progress: ${result.taskId}\nState: ${result.state} (${result.rawStatus})\n\nCall \`tiktok_check_report_status\` again in ~10 seconds.\n\nTimestamp: ${result.timestamp}`,
+        },
+    ];
+}
+export const checkReportStatusTool = {
+    name: TOOL_NAME,
+    title: TOOL_TITLE,
+    description: TOOL_DESCRIPTION,
+    inputSchema: CheckReportStatusInputSchema,
+    outputSchema: CheckReportStatusOutputSchema,
+    annotations: {
+        readOnlyHint: true,
+        openWorldHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+    },
+    inputExamples: [
+        {
+            label: "Check report task status",
+            input: {
+                advertiserId: "1234567890",
+                taskId: "task-abc123",
+            },
+        },
+    ],
+    logic: checkReportStatusLogic,
+    responseFormatter: checkReportStatusResponseFormatter,
+};
+//# sourceMappingURL=check-report-status.tool.js.map

package/dist/mcp-server/tools/definitions/check-report-status.tool.js.map

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

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

@@ -0,0 +1,115 @@
+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[]]>;
+    advertiserId: z.ZodString;
+    data: z.ZodRecord<z.ZodString, z.ZodAny>;
+}, "strip", z.ZodTypeAny, {
+    entityType: string;
+    advertiserId: string;
+    data: Record<string, any>;
+}, {
+    entityType: string;
+    advertiserId: 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[]]>;
+        advertiserId: z.ZodString;
+        data: z.ZodRecord<z.ZodString, z.ZodAny>;
+    }, "strip", z.ZodTypeAny, {
+        entityType: string;
+        advertiserId: string;
+        data: Record<string, any>;
+    }, {
+        entityType: string;
+        advertiserId: 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;
+            advertiserId: string;
+            data: {
+                campaign_name: string;
+                objective_type: string;
+                budget_mode: string;
+                budget: number;
+                campaign_id?: undefined;
+                adgroup_name?: undefined;
+                placements?: undefined;
+                schedule_type?: undefined;
+                pacing?: undefined;
+                schedule_start_time?: undefined;
+                schedule_end_time?: undefined;
+                optimization_goal?: undefined;
+            };
+        };
+    } | {
+        label: string;
+        input: {
+            entityType: string;
+            advertiserId: string;
+            data: {
+                campaign_id: string;
+                adgroup_name: string;
+                placements: string[];
+                budget_mode: string;
+                budget: number;
+                schedule_type: string;
+                pacing: string;
+                schedule_start_time: string;
+                schedule_end_time: string;
+                optimization_goal: string;
+                campaign_name?: undefined;
+                objective_type?: 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;AAmBnD,eAAO,MAAM,uBAAuB;;;;;;;;;;;;EAWsB,CAAC;AAE3D,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgD5B,CAAC"}

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

@@ -0,0 +1,103 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+import { getEntityTypeEnum } from "../utils/entity-mapping.js";
+const TOOL_NAME = "tiktok_create_entity";
+const TOOL_TITLE = "Create TikTok Ads Entity";
+const TOOL_DESCRIPTION = `Create a new TikTok Ads entity.
+
+**Supported entity types:** ${getEntityTypeEnum().join(", ")}
+
+**Key requirements by entity type:**
+- **campaign**: requires \`campaign_name\`, \`objective_type\` (for example \`TRAFFIC\` or \`APP_PROMOTION\`); \`budget_mode\` and \`budget\` are used for budgeted campaigns
+- **adGroup**: requires \`campaign_id\`, \`adgroup_name\`; TikTok commonly also requires scheduling, pacing, and optimization fields depending on objective and promotion type
+- **ad**: requires \`adgroup_id\` and \`creatives\` per TikTok's \`AdCreateBody\`
+- **creative**: this server's creative endpoints are custom mappings and should be checked against account-level creative support before use
+
+**Gotchas:**
+- Budget values are in the advertiser's account currency
+- Creation status fields use \`operation_status\` where supported
+- advertiser_id is automatically injected`;
+export const CreateEntityInputSchema = z
+    .object({
+    entityType: z.enum(getEntityTypeEnum()).describe("Type of entity to create"),
+    advertiserId: z
+        .string()
+        .min(1)
+        .describe("TikTok Advertiser ID (informational — the session-bound advertiser from authentication is used for API calls)"),
+    data: z.record(z.any()).describe("Entity fields as key-value pairs"),
+})
+    .describe("Parameters for creating a TikTok Ads entity");
+export const CreateEntityOutputSchema = z
+    .object({
+    entity: z.record(z.any()).describe("Created entity data (includes entity ID)"),
+    entityType: z.string(),
+    timestamp: z.string().datetime(),
+})
+    .describe("Entity creation result");
+export async function createEntityLogic(input, context, sdkContext) {
+    const { tiktokService } = resolveSessionServices(sdkContext);
+    const entity = await tiktokService.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 traffic campaign",
+            input: {
+                entityType: "campaign",
+                advertiserId: "1234567890",
+                data: {
+                    campaign_name: "Summer Sale 2026",
+                    objective_type: "TRAFFIC",
+                    budget_mode: "BUDGET_MODE_DAY",
+                    budget: 100,
+                },
+            },
+        },
+        {
+            label: "Create an ad group",
+            input: {
+                entityType: "adGroup",
+                advertiserId: "1234567890",
+                data: {
+                    campaign_id: "1800123456789",
+                    adgroup_name: "US 25-44 Interest Targeting",
+                    placements: ["PLACEMENT_TIKTOK"],
+                    budget_mode: "BUDGET_MODE_DAY",
+                    budget: 50,
+                    schedule_type: "SCHEDULE_START_END",
+                    pacing: "PACING_MODE_SMOOTH",
+                    schedule_start_time: "2026-01-01 00:00:00",
+                    schedule_end_time: "2026-12-31 23:59:59",
+                    optimization_goal: "CLICK",
+                },
+            },
+        },
+    ],
+    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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"}

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

@@ -0,0 +1,100 @@
+import { z } from "zod";
+import type { RequestContext, McpTextContent } from "@cesteral/shared";
+import type { SdkContext } from "@cesteral/shared";
+export declare const DeleteEntityInputSchema: z.ZodObject<{
+    entityType: z.ZodEnum<[string, ...string[]]>;
+    advertiserId: z.ZodString;
+    entityIds: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    entityType: string;
+    advertiserId: string;
+    entityIds: string[];
+}, {
+    entityType: string;
+    advertiserId: string;
+    entityIds: string[];
+}>;
+export declare const DeleteEntityOutputSchema: z.ZodObject<{
+    confirmed: z.ZodBoolean;
+    declineReason: z.ZodOptional<z.ZodString>;
+    deleted: z.ZodBoolean;
+    entityType: z.ZodString;
+    entityIds: z.ZodArray<z.ZodString, "many">;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    entityType: string;
+    timestamp: string;
+    entityIds: string[];
+    confirmed: boolean;
+    deleted: boolean;
+    declineReason?: string | undefined;
+}, {
+    entityType: string;
+    timestamp: string;
+    entityIds: string[];
+    confirmed: boolean;
+    deleted: boolean;
+    declineReason?: string | undefined;
+}>;
+type DeleteEntityInput = z.infer<typeof DeleteEntityInputSchema>;
+type DeleteEntityOutput = z.infer<typeof DeleteEntityOutputSchema>;
+export declare function deleteEntityLogic(input: DeleteEntityInput, context: RequestContext, sdkContext?: SdkContext): Promise<DeleteEntityOutput>;
+export declare function deleteEntityResponseFormatter(result: DeleteEntityOutput): McpTextContent[];
+export declare const deleteEntityTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        entityType: z.ZodEnum<[string, ...string[]]>;
+        advertiserId: z.ZodString;
+        entityIds: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        entityType: string;
+        advertiserId: string;
+        entityIds: string[];
+    }, {
+        entityType: string;
+        advertiserId: string;
+        entityIds: string[];
+    }>;
+    outputSchema: z.ZodObject<{
+        confirmed: z.ZodBoolean;
+        declineReason: z.ZodOptional<z.ZodString>;
+        deleted: z.ZodBoolean;
+        entityType: z.ZodString;
+        entityIds: z.ZodArray<z.ZodString, "many">;
+        timestamp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        entityType: string;
+        timestamp: string;
+        entityIds: string[];
+        confirmed: boolean;
+        deleted: boolean;
+        declineReason?: string | undefined;
+    }, {
+        entityType: string;
+        timestamp: string;
+        entityIds: string[];
+        confirmed: boolean;
+        deleted: boolean;
+        declineReason?: string | undefined;
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        idempotentHint: boolean;
+        destructiveHint: boolean;
+    };
+    inputExamples: {
+        label: string;
+        input: {
+            entityType: string;
+            advertiserId: string;
+            entityIds: string[];
+        };
+    }[];
+    logic: typeof deleteEntityLogic;
+    responseFormatter: typeof deleteEntityResponseFormatter;
+};
+export {};
+//# sourceMappingURL=delete-entity.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delete-entity.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/delete-entity.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;AAWnD,eAAO,MAAM,uBAAuB;;;;;;;;;;;;EAUsB,CAAC;AAE3D,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;EASF,CAAC;AAEpC,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,CA6B7B;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,EAAE,CAe1F;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgC5B,CAAC"}

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

@@ -0,0 +1,110 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+import { getEntityTypeEnum } from "../utils/entity-mapping.js";
+import { elicitBulkDeleteConfirmation } from "@cesteral/shared";
+const TOOL_NAME = "tiktok_delete_entity";
+const TOOL_TITLE = "Delete TikTok Ads Entity";
+const TOOL_DESCRIPTION = `Delete one or more TikTok Ads entities.
+
+**Supported entity types:** ${getEntityTypeEnum().join(", ")}
+
+TikTok delete uses a POST to the /delete/ endpoint with an array of entity IDs.
+Deleted entities cannot be recovered. Consider using \`tiktok_bulk_update_status\` with DISABLE first.`;
+export const DeleteEntityInputSchema = z
+    .object({
+    entityType: z.enum(getEntityTypeEnum()).describe("Type of entity to delete"),
+    advertiserId: z.string().min(1).describe("TikTok Advertiser ID"),
+    entityIds: z
+        .array(z.string().min(1))
+        .min(1)
+        .max(20)
+        .describe("Array of entity IDs to delete (max 20)"),
+})
+    .describe("Parameters for deleting TikTok Ads entities");
+export const DeleteEntityOutputSchema = z
+    .object({
+    confirmed: z.boolean(),
+    declineReason: z.string().optional(),
+    deleted: z.boolean(),
+    entityType: z.string(),
+    entityIds: z.array(z.string()),
+    timestamp: z.string().datetime(),
+})
+    .describe("Entity delete result");
+export async function deleteEntityLogic(input, context, sdkContext) {
+    const confirmed = await elicitBulkDeleteConfirmation({
+        count: input.entityIds.length,
+        entityLabel: input.entityType,
+        impactPreview: input.entityIds,
+        sdkContext,
+    });
+    if (!confirmed) {
+        return {
+            confirmed: false,
+            declineReason: "user_declined",
+            deleted: false,
+            entityType: input.entityType,
+            entityIds: input.entityIds,
+            timestamp: new Date().toISOString(),
+        };
+    }
+    const { tiktokService } = resolveSessionServices(sdkContext);
+    await tiktokService.deleteEntity(input.entityType, input.entityIds, context);
+    return {
+        confirmed: true,
+        deleted: true,
+        entityType: input.entityType,
+        entityIds: input.entityIds,
+        timestamp: new Date().toISOString(),
+    };
+}
+export function deleteEntityResponseFormatter(result) {
+    if (!result.confirmed) {
+        return [
+            {
+                type: "text",
+                text: `Bulk deletion of ${result.entityIds.length} ${result.entityType}(s) cancelled by user.\n\nTimestamp: ${result.timestamp}`,
+            },
+        ];
+    }
+    return [
+        {
+            type: "text",
+            text: `${result.entityType} entities deleted: ${result.entityIds.join(", ")}\n\nTimestamp: ${result.timestamp}`,
+        },
+    ];
+}
+export const deleteEntityTool = {
+    name: TOOL_NAME,
+    title: TOOL_TITLE,
+    description: TOOL_DESCRIPTION,
+    inputSchema: DeleteEntityInputSchema,
+    outputSchema: DeleteEntityOutputSchema,
+    annotations: {
+        readOnlyHint: false,
+        openWorldHint: false,
+        idempotentHint: false,
+        destructiveHint: true,
+    },
+    inputExamples: [
+        {
+            label: "Delete a single campaign",
+            input: {
+                entityType: "campaign",
+                advertiserId: "1234567890",
+                entityIds: ["1800123456789"],
+            },
+        },
+        {
+            label: "Delete multiple ad groups",
+            input: {
+                entityType: "adGroup",
+                advertiserId: "1234567890",
+                entityIds: ["1700111111111", "1700222222222"],
+            },
+        },
+    ],
+    logic: deleteEntityLogic,
+    responseFormatter: deleteEntityResponseFormatter,
+};
+//# sourceMappingURL=delete-entity.tool.js.map

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

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