@cesteral/tiktok-mcp 1.0.0

package/dist/mcp-server/tools/definitions/get-targeting-options.tool.js

@@ -0,0 +1,120 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+const TOOL_NAME = "tiktok_get_targeting_options";
+const TOOL_TITLE = "Get TikTok Targeting Options";
+const TOOL_DESCRIPTION = `Browse available TikTok targeting metadata using official \`/tool/*\` endpoints.
+
+Use this to discover valid targeting values before creating or updating ad groups.
+This tool dispatches to the documented TikTok list endpoints instead of the older
+generic targeting routes.
+
+**Supported option types:** ACTION_CATEGORY, CARRIER, DEVICE_MODEL, INTEREST_CATEGORY,
+INTEREST_KEYWORD, ISP, LANGUAGE, LOCATION`;
+export const GetTargetingOptionsInputSchema = z
+    .object({
+    advertiserId: z.string().min(1).describe("TikTok Advertiser ID"),
+    optionType: z
+        .enum([
+        "ACTION_CATEGORY",
+        "CARRIER",
+        "DEVICE_MODEL",
+        "INTEREST_CATEGORY",
+        "INTEREST_KEYWORD",
+        "ISP",
+        "LANGUAGE",
+        "LOCATION",
+    ])
+        .describe("Which official TikTok targeting endpoint to query"),
+    keyword: z.string().optional().describe("Keyword for INTEREST_KEYWORD lookups"),
+    placements: z
+        .array(z.string())
+        .optional()
+        .describe("Placements required by LOCATION lookups, e.g. ['PLACEMENT_TIKTOK']"),
+    objectiveType: z
+        .string()
+        .optional()
+        .describe("Objective type used by LOCATION lookups, e.g. TRAFFIC or APP_PROMOTION"),
+    promotionType: z
+        .string()
+        .optional()
+        .describe("Promotion type used by LOCATION or ISP lookups when required"),
+    operatingSystem: z
+        .enum(["ANDROID", "IOS"])
+        .optional()
+        .describe("Optional OS filter used by LOCATION lookups"),
+    locationIds: z.array(z.string()).optional().describe("Location IDs used by ISP lookups"),
+    scene: z
+        .enum(["ISP"])
+        .optional()
+        .describe("Scene used by tool_targeting_list. Currently only ISP is supported here."),
+    specialIndustries: z
+        .array(z.string())
+        .optional()
+        .describe("Special industries used by ACTION_CATEGORY lookups"),
+})
+    .describe("Parameters for browsing TikTok targeting options");
+export const GetTargetingOptionsOutputSchema = z
+    .object({
+    options: z.record(z.any()).describe("Available targeting options"),
+    timestamp: z.string().datetime(),
+})
+    .describe("Targeting options result");
+export async function getTargetingOptionsLogic(input, context, sdkContext) {
+    const { tiktokService } = resolveSessionServices(sdkContext);
+    const options = (await tiktokService.getTargetingOptions(input.optionType, {
+        ...(input.keyword ? { keyword: input.keyword } : {}),
+        ...(input.placements ? { placements: input.placements } : {}),
+        ...(input.objectiveType ? { objective_type: input.objectiveType } : {}),
+        ...(input.promotionType ? { promotion_type: input.promotionType } : {}),
+        ...(input.operatingSystem ? { operating_system: input.operatingSystem } : {}),
+        ...(input.locationIds ? { location_ids: input.locationIds } : {}),
+        ...(input.scene ? { scene: input.scene } : {}),
+        ...(input.specialIndustries ? { special_industries: input.specialIndustries } : {}),
+    }, context));
+    return {
+        options,
+        timestamp: new Date().toISOString(),
+    };
+}
+export function getTargetingOptionsResponseFormatter(result) {
+    return [
+        {
+            type: "text",
+            text: `TikTok targeting options:\n${JSON.stringify(result.options, null, 2)}\n\nTimestamp: ${result.timestamp}`,
+        },
+    ];
+}
+export const getTargetingOptionsTool = {
+    name: TOOL_NAME,
+    title: TOOL_TITLE,
+    description: TOOL_DESCRIPTION,
+    inputSchema: GetTargetingOptionsInputSchema,
+    outputSchema: GetTargetingOptionsOutputSchema,
+    annotations: {
+        readOnlyHint: true,
+        openWorldHint: false,
+        idempotentHint: true,
+        destructiveHint: false,
+    },
+    inputExamples: [
+        {
+            label: "Get languages",
+            input: {
+                advertiserId: "1234567890",
+                optionType: "LANGUAGE",
+            },
+        },
+        {
+            label: "Get locations for a traffic campaign",
+            input: {
+                advertiserId: "1234567890",
+                optionType: "LOCATION",
+                placements: ["PLACEMENT_TIKTOK"],
+                objectiveType: "TRAFFIC",
+            },
+        },
+    ],
+    logic: getTargetingOptionsLogic,
+    responseFormatter: getTargetingOptionsResponseFormatter,
+};
+//# sourceMappingURL=get-targeting-options.tool.js.map

package/dist/mcp-server/tools/definitions/get-targeting-options.tool.js.map

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

package/dist/mcp-server/tools/definitions/index.d.ts

@@ -0,0 +1,26 @@
+export { listEntitiesTool } from "./list-entities.tool.js";
+export { getEntityTool } from "./get-entity.tool.js";
+export { createEntityTool } from "./create-entity.tool.js";
+export { updateEntityTool } from "./update-entity.tool.js";
+export { deleteEntityTool } from "./delete-entity.tool.js";
+export { listAdvertisersTool } from "./list-advertisers.tool.js";
+export { getReportTool } from "./get-report.tool.js";
+export { getReportBreakdownsTool } from "./get-report-breakdowns.tool.js";
+export { submitReportTool } from "./submit-report.tool.js";
+export { checkReportStatusTool } from "./check-report-status.tool.js";
+export { downloadReportTool } from "./download-report.tool.js";
+export { bulkUpdateStatusTool } from "./bulk-update-status.tool.js";
+export { bulkCreateEntitiesTool } from "./bulk-create-entities.tool.js";
+export { bulkUpdateEntitiesTool } from "./bulk-update-entities.tool.js";
+export { adjustBidsTool } from "./adjust-bids.tool.js";
+export { searchTargetingTool } from "./search-targeting.tool.js";
+export { getTargetingOptionsTool } from "./get-targeting-options.tool.js";
+export { duplicateEntityTool } from "./duplicate-entity.tool.js";
+export { getAudienceEstimateTool } from "./get-audience-estimate.tool.js";
+export { getAdPreviewTool } from "./get-ad-preview.tool.js";
+export { validateEntityTool } from "./validate-entity.tool.js";
+export { uploadImageTool } from "./upload-image.tool.js";
+export { uploadVideoTool } from "./upload-video.tool.js";
+import { type ToolDefinitionForFactory } from "@cesteral/shared";
+export declare const allTools: ToolDefinitionForFactory[];
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp-server/tools/definitions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/index.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAyBzD,OAAO,EAGL,KAAK,wBAAwB,EAC9B,MAAM,kBAAkB,CAAC;AA0C1B,eAAO,MAAM,QAAQ,EAAE,wBAAwB,EAG9C,CAAC"}

package/dist/mcp-server/tools/definitions/index.js

@@ -0,0 +1,78 @@
+export { listEntitiesTool } from "./list-entities.tool.js";
+export { getEntityTool } from "./get-entity.tool.js";
+export { createEntityTool } from "./create-entity.tool.js";
+export { updateEntityTool } from "./update-entity.tool.js";
+export { deleteEntityTool } from "./delete-entity.tool.js";
+export { listAdvertisersTool } from "./list-advertisers.tool.js";
+export { getReportTool } from "./get-report.tool.js";
+export { getReportBreakdownsTool } from "./get-report-breakdowns.tool.js";
+export { submitReportTool } from "./submit-report.tool.js";
+export { checkReportStatusTool } from "./check-report-status.tool.js";
+export { downloadReportTool } from "./download-report.tool.js";
+export { bulkUpdateStatusTool } from "./bulk-update-status.tool.js";
+export { bulkCreateEntitiesTool } from "./bulk-create-entities.tool.js";
+export { bulkUpdateEntitiesTool } from "./bulk-update-entities.tool.js";
+export { adjustBidsTool } from "./adjust-bids.tool.js";
+export { searchTargetingTool } from "./search-targeting.tool.js";
+export { getTargetingOptionsTool } from "./get-targeting-options.tool.js";
+export { duplicateEntityTool } from "./duplicate-entity.tool.js";
+export { getAudienceEstimateTool } from "./get-audience-estimate.tool.js";
+export { getAdPreviewTool } from "./get-ad-preview.tool.js";
+export { validateEntityTool } from "./validate-entity.tool.js";
+export { uploadImageTool } from "./upload-image.tool.js";
+export { uploadVideoTool } from "./upload-video.tool.js";
+import { listEntitiesTool } from "./list-entities.tool.js";
+import { getEntityTool } from "./get-entity.tool.js";
+import { createEntityTool } from "./create-entity.tool.js";
+import { updateEntityTool } from "./update-entity.tool.js";
+import { deleteEntityTool } from "./delete-entity.tool.js";
+import { listAdvertisersTool } from "./list-advertisers.tool.js";
+import { getReportTool } from "./get-report.tool.js";
+import { getReportBreakdownsTool } from "./get-report-breakdowns.tool.js";
+import { submitReportTool } from "./submit-report.tool.js";
+import { checkReportStatusTool } from "./check-report-status.tool.js";
+import { downloadReportTool } from "./download-report.tool.js";
+import { bulkUpdateStatusTool } from "./bulk-update-status.tool.js";
+import { bulkCreateEntitiesTool } from "./bulk-create-entities.tool.js";
+import { bulkUpdateEntitiesTool } from "./bulk-update-entities.tool.js";
+import { adjustBidsTool } from "./adjust-bids.tool.js";
+import { searchTargetingTool } from "./search-targeting.tool.js";
+import { getTargetingOptionsTool } from "./get-targeting-options.tool.js";
+import { duplicateEntityTool } from "./duplicate-entity.tool.js";
+import { getAudienceEstimateTool } from "./get-audience-estimate.tool.js";
+import { getAdPreviewTool } from "./get-ad-preview.tool.js";
+import { validateEntityTool } from "./validate-entity.tool.js";
+import { uploadImageTool } from "./upload-image.tool.js";
+import { uploadVideoTool } from "./upload-video.tool.js";
+import { conformanceTools, createToolSearchTool, } from "@cesteral/shared";
+const productionTools = [
+    listEntitiesTool,
+    getEntityTool,
+    createEntityTool,
+    updateEntityTool,
+    deleteEntityTool,
+    listAdvertisersTool,
+    getReportTool,
+    getReportBreakdownsTool,
+    submitReportTool,
+    checkReportStatusTool,
+    downloadReportTool,
+    bulkUpdateStatusTool,
+    bulkCreateEntitiesTool,
+    bulkUpdateEntitiesTool,
+    adjustBidsTool,
+    searchTargetingTool,
+    getTargetingOptionsTool,
+    duplicateEntityTool,
+    getAudienceEstimateTool,
+    getAdPreviewTool,
+    uploadImageTool,
+    uploadVideoTool,
+    validateEntityTool,
+    createToolSearchTool({ platform: "tiktok", getTools: () => allTools }),
+];
+export const allTools = [
+    ...productionTools,
+    ...(process.env.MCP_INCLUDE_CONFORMANCE_TOOLS === "true" ? conformanceTools : []),
+];
+//# sourceMappingURL=index.js.map

package/dist/mcp-server/tools/definitions/index.js.map

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

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

@@ -0,0 +1,54 @@
+import { z } from "zod";
+import type { RequestContext, McpTextContent } from "@cesteral/shared";
+import type { SdkContext } from "@cesteral/shared";
+export declare const ListAdvertisersInputSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export declare const ListAdvertisersOutputSchema: z.ZodObject<{
+    advertisers: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">;
+    count: z.ZodNumber;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    count: number;
+    timestamp: string;
+    advertisers: Record<string, any>[];
+}, {
+    count: number;
+    timestamp: string;
+    advertisers: Record<string, any>[];
+}>;
+type ListAdvertisersInput = z.infer<typeof ListAdvertisersInputSchema>;
+type ListAdvertisersOutput = z.infer<typeof ListAdvertisersOutputSchema>;
+export declare function listAdvertisersLogic(_input: ListAdvertisersInput, context: RequestContext, sdkContext?: SdkContext): Promise<ListAdvertisersOutput>;
+export declare function listAdvertisersResponseFormatter(result: ListAdvertisersOutput): McpTextContent[];
+export declare const listAdvertisersTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+    outputSchema: z.ZodObject<{
+        advertisers: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">;
+        count: z.ZodNumber;
+        timestamp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        count: number;
+        timestamp: string;
+        advertisers: Record<string, any>[];
+    }, {
+        count: number;
+        timestamp: string;
+        advertisers: Record<string, any>[];
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        idempotentHint: boolean;
+        destructiveHint: boolean;
+    };
+    inputExamples: {
+        label: string;
+        input: {};
+    }[];
+    logic: typeof listAdvertisersLogic;
+    responseFormatter: typeof listAdvertisersResponseFormatter;
+};
+export {};
+//# sourceMappingURL=list-advertisers.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list-advertisers.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/list-advertisers.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AASnD,eAAO,MAAM,0BAA0B,gDAEiB,CAAC;AAEzD,eAAO,MAAM,2BAA2B;;;;;;;;;;;;EAMH,CAAC;AAEtC,KAAK,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AACvE,KAAK,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEzE,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,oBAAoB,EAC5B,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,qBAAqB,CAAC,CAchC;AAED,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,qBAAqB,GAAG,cAAc,EAAE,CAOhG;AAED,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoB/B,CAAC"}

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

@@ -0,0 +1,58 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+const TOOL_NAME = "tiktok_list_advertisers";
+const TOOL_TITLE = "List TikTok Advertisers";
+const TOOL_DESCRIPTION = `List TikTok advertiser accounts accessible to the authenticated user.
+
+Returns advertiser IDs, names, and account status information.
+Use the advertiser_id from results with other tiktok_* tools.`;
+export const ListAdvertisersInputSchema = z
+    .object({})
+    .describe("Parameters for listing TikTok advertisers");
+export const ListAdvertisersOutputSchema = z
+    .object({
+    advertisers: z.array(z.record(z.any())).describe("List of advertiser accounts"),
+    count: z.number().describe("Number of advertisers returned"),
+    timestamp: z.string().datetime(),
+})
+    .describe("Advertiser list result");
+export async function listAdvertisersLogic(_input, context, sdkContext) {
+    const { tiktokService } = resolveSessionServices(sdkContext);
+    const result = (await tiktokService.listAdvertisers(context));
+    const advertisers = (result?.list ?? []);
+    return {
+        advertisers,
+        count: advertisers.length,
+        timestamp: new Date().toISOString(),
+    };
+}
+export function listAdvertisersResponseFormatter(result) {
+    return [
+        {
+            type: "text",
+            text: `Found ${result.count} advertiser(s)\n${JSON.stringify(result.advertisers, null, 2)}\n\nTimestamp: ${result.timestamp}`,
+        },
+    ];
+}
+export const listAdvertisersTool = {
+    name: TOOL_NAME,
+    title: TOOL_TITLE,
+    description: TOOL_DESCRIPTION,
+    inputSchema: ListAdvertisersInputSchema,
+    outputSchema: ListAdvertisersOutputSchema,
+    annotations: {
+        readOnlyHint: true,
+        openWorldHint: false,
+        idempotentHint: true,
+        destructiveHint: false,
+    },
+    inputExamples: [
+        {
+            label: "List all accessible advertisers",
+            input: {},
+        },
+    ],
+    logic: listAdvertisersLogic,
+    responseFormatter: listAdvertisersResponseFormatter,
+};
+//# sourceMappingURL=list-advertisers.tool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list-advertisers.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/list-advertisers.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAIrE,MAAM,SAAS,GAAG,yBAAyB,CAAC;AAC5C,MAAM,UAAU,GAAG,yBAAyB,CAAC;AAC7C,MAAM,gBAAgB,GAAG;;;8DAGqC,CAAC;AAE/D,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC;KACxC,MAAM,CAAC,EAAE,CAAC;KACV,QAAQ,CAAC,2CAA2C,CAAC,CAAC;AAEzD,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC;KACzC,MAAM,CAAC;IACN,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,6BAA6B,CAAC;IAC/E,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;IAC5D,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC;KACD,QAAQ,CAAC,wBAAwB,CAAC,CAAC;AAKtC,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,MAA4B,EAC5B,OAAuB,EACvB,UAAuB;IAEvB,MAAM,EAAE,aAAa,EAAE,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAE7D,MAAM,MAAM,GAAG,CAAC,MAAM,aAAa,CAAC,eAAe,CAAC,OAAO,CAAC,CAE3D,CAAC;IAEF,MAAM,WAAW,GAAG,CAAC,MAAM,EAAE,IAAI,IAAI,EAAE,CAA8B,CAAC;IAEtE,OAAO;QACL,WAAW;QACX,KAAK,EAAE,WAAW,CAAC,MAAM;QACzB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gCAAgC,CAAC,MAA6B;IAC5E,OAAO;QACL;YACE,IAAI,EAAE,MAAe;YACrB,IAAI,EAAE,SAAS,MAAM,CAAC,KAAK,mBAAmB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,kBAAkB,MAAM,CAAC,SAAS,EAAE;SAC9H;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,UAAU;IACjB,WAAW,EAAE,gBAAgB;IAC7B,WAAW,EAAE,0BAA0B;IACvC,YAAY,EAAE,2BAA2B;IACzC,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;QAClB,aAAa,EAAE,KAAK;QACpB,cAAc,EAAE,IAAI;QACpB,eAAe,EAAE,KAAK;KACvB;IACD,aAAa,EAAE;QACb;YACE,KAAK,EAAE,iCAAiC;YACxC,KAAK,EAAE,EAAE;SACV;KACF;IACD,KAAK,EAAE,oBAAoB;IAC3B,iBAAiB,EAAE,gCAAgC;CACpD,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"list-entities.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/list-entities.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAYnD,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;EA+BqB,CAAC;AAE1D,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAMJ,CAAC;AAElC,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,CA0B7B;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,EAAE,CAgB1F;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiC5B,CAAC"}

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

@@ -0,0 +1,114 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+import { getEntityTypeEnum } from "../utils/entity-mapping.js";
+import { PaginationOutputSchema, buildPaginationOutput, formatPaginationHint, } from "@cesteral/shared";
+const TOOL_NAME = "tiktok_list_entities";
+const TOOL_TITLE = "List TikTok Ads Entities";
+const TOOL_DESCRIPTION = `List TikTok Ads entities with optional filtering and page-based pagination.
+
+**Entity Hierarchy:** Advertiser > Campaign > Ad Group > Ad (+ Creatives)
+
+**Supported entity types:** ${getEntityTypeEnum().join(", ")}
+
+All entities are scoped to an advertiser account. Pagination uses \`page\` (1-based) and \`pageSize\`.`;
+export const ListEntitiesInputSchema = z
+    .object({
+    entityType: z.enum(getEntityTypeEnum()).describe("Type of entities to list"),
+    advertiserId: z
+        .string()
+        .min(1)
+        .describe("TikTok Advertiser ID (informational — the session-bound advertiser from authentication is used for API calls)"),
+    filters: z
+        .record(z.unknown())
+        .optional()
+        .describe("Optional TikTok filtering object (for example { primary_status: 'STATUS_ALL' } or { campaign_ids: ['123'] })"),
+    page: z
+        .number()
+        .int()
+        .min(1)
+        .optional()
+        .default(1)
+        .describe("Page number (1-based, default 1)"),
+    pageSize: z
+        .number()
+        .int()
+        .min(1)
+        .max(1000)
+        .optional()
+        .default(10)
+        .describe("Number of entities per page (default 10, max 1000)"),
+})
+    .describe("Parameters for listing TikTok Ads entities");
+export const ListEntitiesOutputSchema = z
+    .object({
+    entities: z.array(z.record(z.any())).describe("List of entities"),
+    pagination: PaginationOutputSchema,
+    timestamp: z.string().datetime(),
+})
+    .describe("Entity list result");
+export async function listEntitiesLogic(input, context, sdkContext) {
+    const { tiktokService } = resolveSessionServices(sdkContext);
+    const result = await tiktokService.listEntities(input.entityType, input.filters, input.page, input.pageSize, context);
+    const { pageInfo } = result;
+    const hasMore = pageInfo.page < pageInfo.total_page;
+    const nextPage = pageInfo.page + 1;
+    const entities = result.entities;
+    return {
+        entities,
+        pagination: buildPaginationOutput({
+            nextCursor: hasMore ? String(nextPage) : null,
+            pageSize: entities.length,
+            totalCount: pageInfo.total_number,
+            nextPageInputKey: "page",
+        }),
+        timestamp: new Date().toISOString(),
+    };
+}
+export function listEntitiesResponseFormatter(result) {
+    const { pageSize, totalCount } = result.pagination;
+    const summary = `Found ${pageSize} entities${totalCount !== undefined ? ` (total ${totalCount})` : ""}`;
+    const entities = pageSize > 0
+        ? `\n\nEntities:\n${JSON.stringify(result.entities, null, 2)}`
+        : "\n\nNo entities found";
+    return [
+        {
+            type: "text",
+            text: `${summary}${entities}${formatPaginationHint(result.pagination)}\n\nTimestamp: ${result.timestamp}`,
+        },
+    ];
+}
+export const listEntitiesTool = {
+    name: TOOL_NAME,
+    title: TOOL_TITLE,
+    description: TOOL_DESCRIPTION,
+    inputSchema: ListEntitiesInputSchema,
+    outputSchema: ListEntitiesOutputSchema,
+    annotations: {
+        readOnlyHint: true,
+        openWorldHint: false,
+        idempotentHint: true,
+        destructiveHint: false,
+    },
+    inputExamples: [
+        {
+            label: "List active campaigns",
+            input: {
+                entityType: "campaign",
+                advertiserId: "1234567890",
+                filters: { primary_status: "STATUS_ALL" },
+                page: 1,
+                pageSize: 10,
+            },
+        },
+        {
+            label: "List ad groups",
+            input: {
+                entityType: "adGroup",
+                advertiserId: "1234567890",
+            },
+        },
+    ],
+    logic: listEntitiesLogic,
+    responseFormatter: listEntitiesResponseFormatter,
+};
+//# sourceMappingURL=list-entities.tool.js.map

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

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