@cesteral/ttd-mcp 1.0.0

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

@@ -0,0 +1,196 @@
+import { z } from "zod";
+import type { McpTextContent, RequestContext } from "@cesteral/shared";
+import type { SdkContext } from "@cesteral/shared";
+export declare const CreateEntityInputSchema: z.ZodEffects<z.ZodObject<{
+    entityType: z.ZodEnum<[string, ...string[]]>;
+    partnerId: z.ZodOptional<z.ZodString>;
+    advertiserId: z.ZodOptional<z.ZodString>;
+    campaignId: z.ZodOptional<z.ZodString>;
+    adGroupId: z.ZodOptional<z.ZodString>;
+    data: z.ZodRecord<z.ZodString, z.ZodAny>;
+    strictMode: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    entityType: string;
+    data: Record<string, any>;
+    advertiserId?: string | undefined;
+    campaignId?: string | undefined;
+    adGroupId?: string | undefined;
+    partnerId?: string | undefined;
+    strictMode?: boolean | undefined;
+}, {
+    entityType: string;
+    data: Record<string, any>;
+    advertiserId?: string | undefined;
+    campaignId?: string | undefined;
+    adGroupId?: string | undefined;
+    partnerId?: string | undefined;
+    strictMode?: boolean | undefined;
+}>, {
+    entityType: string;
+    data: Record<string, any>;
+    advertiserId?: string | undefined;
+    campaignId?: string | undefined;
+    adGroupId?: string | undefined;
+    partnerId?: string | undefined;
+    strictMode?: boolean | undefined;
+}, {
+    entityType: string;
+    data: Record<string, any>;
+    advertiserId?: string | undefined;
+    campaignId?: string | undefined;
+    adGroupId?: string | undefined;
+    partnerId?: string | undefined;
+    strictMode?: boolean | undefined;
+}>;
+export declare const CreateEntityOutputSchema: z.ZodObject<{
+    entity: z.ZodRecord<z.ZodString, z.ZodAny>;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    timestamp: string;
+    entity: Record<string, any>;
+}, {
+    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.ZodEffects<z.ZodObject<{
+        entityType: z.ZodEnum<[string, ...string[]]>;
+        partnerId: z.ZodOptional<z.ZodString>;
+        advertiserId: z.ZodOptional<z.ZodString>;
+        campaignId: z.ZodOptional<z.ZodString>;
+        adGroupId: z.ZodOptional<z.ZodString>;
+        data: z.ZodRecord<z.ZodString, z.ZodAny>;
+        strictMode: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        entityType: string;
+        data: Record<string, any>;
+        advertiserId?: string | undefined;
+        campaignId?: string | undefined;
+        adGroupId?: string | undefined;
+        partnerId?: string | undefined;
+        strictMode?: boolean | undefined;
+    }, {
+        entityType: string;
+        data: Record<string, any>;
+        advertiserId?: string | undefined;
+        campaignId?: string | undefined;
+        adGroupId?: string | undefined;
+        partnerId?: string | undefined;
+        strictMode?: boolean | undefined;
+    }>, {
+        entityType: string;
+        data: Record<string, any>;
+        advertiserId?: string | undefined;
+        campaignId?: string | undefined;
+        adGroupId?: string | undefined;
+        partnerId?: string | undefined;
+        strictMode?: boolean | undefined;
+    }, {
+        entityType: string;
+        data: Record<string, any>;
+        advertiserId?: string | undefined;
+        campaignId?: string | undefined;
+        adGroupId?: string | undefined;
+        partnerId?: string | undefined;
+        strictMode?: boolean | undefined;
+    }>;
+    outputSchema: z.ZodObject<{
+        entity: z.ZodRecord<z.ZodString, z.ZodAny>;
+        timestamp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        timestamp: string;
+        entity: Record<string, any>;
+    }, {
+        timestamp: string;
+        entity: Record<string, any>;
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+    };
+    inputExamples: ({
+        label: string;
+        input: {
+            entityType: string;
+            partnerId: string;
+            data: {
+                AdvertiserName: string;
+                CurrencyCode: string;
+                CampaignName?: undefined;
+                Budget?: undefined;
+                StartDate?: undefined;
+                EndDate?: undefined;
+                PacingMode?: undefined;
+                AdGroupName?: undefined;
+                RTBAttributes?: undefined;
+            };
+            advertiserId?: undefined;
+            campaignId?: undefined;
+        };
+    } | {
+        label: string;
+        input: {
+            entityType: string;
+            advertiserId: string;
+            data: {
+                CampaignName: string;
+                Budget: {
+                    Amount: number;
+                    CurrencyCode: string;
+                };
+                StartDate: string;
+                EndDate: string;
+                PacingMode: string;
+                AdvertiserName?: undefined;
+                CurrencyCode?: undefined;
+                AdGroupName?: undefined;
+                RTBAttributes?: undefined;
+            };
+            partnerId?: undefined;
+            campaignId?: undefined;
+        };
+    } | {
+        label: string;
+        input: {
+            entityType: string;
+            advertiserId: string;
+            campaignId: string;
+            data: {
+                AdGroupName: string;
+                RTBAttributes: {
+                    BudgetSettings: {
+                        DailyBudget: {
+                            Amount: number;
+                            CurrencyCode: string;
+                        };
+                    };
+                    BaseBidCPM: {
+                        Amount: number;
+                        CurrencyCode: string;
+                    };
+                };
+                AdvertiserName?: undefined;
+                CurrencyCode?: undefined;
+                CampaignName?: undefined;
+                Budget?: undefined;
+                StartDate?: undefined;
+                EndDate?: undefined;
+                PacingMode?: undefined;
+            };
+            partnerId?: 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;AAIxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAUnD,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyCe,CAAC;AAEpD,eAAO,MAAM,wBAAwB;;;;;;;;;EAKA,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,CAa7B;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,EAAE,CAO1F;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwD5B,CAAC"}

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

@@ -0,0 +1,126 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+import { getEntityTypeEnum } from "../utils/entity-mapping.js";
+import { addParentValidationIssue, mergeParentIdsIntoData } from "../utils/parent-id-validation.js";
+const TOOL_NAME = "ttd_create_entity";
+const TOOL_TITLE = "Create TTD Entity";
+const TOOL_DESCRIPTION = `Create a new The Trade Desk entity.
+
+**Supported entity types:** ${getEntityTypeEnum().join(", ")}
+
+Provide the entity data as a JSON object. Required fields vary by entity type — refer to TTD API v3 documentation.`;
+export const CreateEntityInputSchema = z
+    .object({
+    entityType: z.enum(getEntityTypeEnum()).describe("Type of entity to create"),
+    partnerId: z
+        .string()
+        .optional()
+        .describe("Partner ID (required when creating advertiser entities)"),
+    advertiserId: z
+        .string()
+        .optional()
+        .describe("Advertiser ID (required for most non-advertiser entities)"),
+    campaignId: z.string().optional().describe("Campaign ID (required for adGroup)"),
+    adGroupId: z.string().optional().describe("Ad Group ID (required for ad)"),
+    data: z.record(z.any()).describe("Entity data to create (fields vary by entity type)"),
+    strictMode: z
+        .boolean()
+        .optional()
+        .describe("Set TTD-Strict-Mode header — TTD returns 400 on unrecognized properties or read-only field assignments. Recommended for development/CI; avoid in production where harmless extra fields would otherwise succeed (per TTD Foundations §10)."),
+})
+    .superRefine((input, ctx) => {
+    const topLevelPartnerId = typeof input.partnerId === "string" ? input.partnerId.trim() : undefined;
+    const payloadPartnerId = typeof input.data?.PartnerId === "string" ? input.data.PartnerId.trim() : undefined;
+    if (input.entityType === "advertiser" && !topLevelPartnerId && !payloadPartnerId) {
+        ctx.addIssue({
+            code: "custom",
+            message: "partnerId is required when creating advertiser entities",
+            path: ["partnerId"],
+        });
+    }
+    addParentValidationIssue(ctx, input.entityType, input, input.data);
+})
+    .describe("Parameters for creating a TTD entity");
+export const CreateEntityOutputSchema = z
+    .object({
+    entity: z.record(z.any()).describe("Created entity data"),
+    timestamp: z.string().datetime(),
+})
+    .describe("Entity creation result");
+export async function createEntityLogic(input, context, sdkContext) {
+    const { ttdService } = resolveSessionServices(sdkContext);
+    const data = mergeParentIdsIntoData(input.data, input);
+    const entity = await ttdService.createEntity(input.entityType, data, context, {
+        strictMode: input.strictMode,
+    });
+    return {
+        entity: entity,
+        timestamp: new Date().toISOString(),
+    };
+}
+export function createEntityResponseFormatter(result) {
+    return [
+        {
+            type: "text",
+            text: `Entity 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,
+        destructiveHint: true,
+        idempotentHint: false,
+    },
+    inputExamples: [
+        {
+            label: "Create an advertiser",
+            input: {
+                entityType: "advertiser",
+                partnerId: "partner123",
+                data: {
+                    AdvertiserName: "Acme Corp",
+                    CurrencyCode: "USD",
+                },
+            },
+        },
+        {
+            label: "Create a campaign",
+            input: {
+                entityType: "campaign",
+                advertiserId: "adv123abc",
+                data: {
+                    CampaignName: "Q1 2025 Brand Awareness",
+                    Budget: { Amount: 50000, CurrencyCode: "USD" },
+                    StartDate: "2025-01-15T00:00:00Z",
+                    EndDate: "2025-03-31T23:59:59Z",
+                    PacingMode: "PaceAhead",
+                },
+            },
+        },
+        {
+            label: "Create an ad group under a campaign",
+            input: {
+                entityType: "adGroup",
+                advertiserId: "adv123abc",
+                campaignId: "camp456def",
+                data: {
+                    AdGroupName: "Prospecting - Display",
+                    RTBAttributes: {
+                        BudgetSettings: { DailyBudget: { Amount: 500, CurrencyCode: "USD" } },
+                        BaseBidCPM: { Amount: 3.5, 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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"}

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

@@ -0,0 +1,147 @@
+import { z } from "zod";
+import type { McpTextContent, RequestContext, SdkContext } from "@cesteral/shared";
+export declare const CreateReportScheduleInputSchema: z.ZodObject<{
+    reportName: z.ZodString;
+    scheduleType: z.ZodEnum<["Once", "Daily", "Weekly", "Monthly", "Quarterly"]>;
+    dateRange: z.ZodEnum<["Yesterday", "Last7Days", "Last14Days", "Last30Days", "LastXDays", "MonthToDate", "LastMonth", "QuarterToDate", "LastQuarter", "YearToDate", "Custom"]>;
+    fileFormat: z.ZodDefault<z.ZodOptional<z.ZodEnum<["CSV", "TSV", "ExcelPivot"]>>>;
+    scheduleStartDate: z.ZodOptional<z.ZodString>;
+    dimensions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    metrics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    advertiserIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    reportTemplateId: z.ZodNumber;
+    additionalConfig: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    reportName: string;
+    dateRange: "Yesterday" | "Last7Days" | "Last14Days" | "Last30Days" | "LastXDays" | "MonthToDate" | "LastMonth" | "QuarterToDate" | "LastQuarter" | "YearToDate" | "Custom";
+    reportTemplateId: number;
+    fileFormat: "CSV" | "TSV" | "ExcelPivot";
+    scheduleType: "Once" | "Daily" | "Weekly" | "Monthly" | "Quarterly";
+    scheduleStartDate?: string | undefined;
+    advertiserIds?: string[] | undefined;
+    dimensions?: string[] | undefined;
+    metrics?: string[] | undefined;
+    additionalConfig?: Record<string, unknown> | undefined;
+}, {
+    reportName: string;
+    dateRange: "Yesterday" | "Last7Days" | "Last14Days" | "Last30Days" | "LastXDays" | "MonthToDate" | "LastMonth" | "QuarterToDate" | "LastQuarter" | "YearToDate" | "Custom";
+    reportTemplateId: number;
+    scheduleType: "Once" | "Daily" | "Weekly" | "Monthly" | "Quarterly";
+    fileFormat?: "CSV" | "TSV" | "ExcelPivot" | undefined;
+    scheduleStartDate?: string | undefined;
+    advertiserIds?: string[] | undefined;
+    dimensions?: string[] | undefined;
+    metrics?: string[] | undefined;
+    additionalConfig?: Record<string, unknown> | undefined;
+}>;
+export declare const CreateReportScheduleOutputSchema: z.ZodObject<{
+    reportScheduleId: z.ZodString;
+    reportName: z.ZodString;
+    scheduleType: z.ZodString;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    reportScheduleId: string;
+    timestamp: string;
+    reportName: string;
+    scheduleType: string;
+}, {
+    reportScheduleId: string;
+    timestamp: string;
+    reportName: string;
+    scheduleType: string;
+}>;
+type CreateReportScheduleInput = z.infer<typeof CreateReportScheduleInputSchema>;
+type CreateReportScheduleOutput = z.infer<typeof CreateReportScheduleOutputSchema>;
+export declare function createReportScheduleLogic(input: CreateReportScheduleInput, context: RequestContext, sdkContext?: SdkContext): Promise<CreateReportScheduleOutput>;
+export declare function createReportScheduleResponseFormatter(result: CreateReportScheduleOutput): McpTextContent[];
+export declare const createReportScheduleTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        reportName: z.ZodString;
+        scheduleType: z.ZodEnum<["Once", "Daily", "Weekly", "Monthly", "Quarterly"]>;
+        dateRange: z.ZodEnum<["Yesterday", "Last7Days", "Last14Days", "Last30Days", "LastXDays", "MonthToDate", "LastMonth", "QuarterToDate", "LastQuarter", "YearToDate", "Custom"]>;
+        fileFormat: z.ZodDefault<z.ZodOptional<z.ZodEnum<["CSV", "TSV", "ExcelPivot"]>>>;
+        scheduleStartDate: z.ZodOptional<z.ZodString>;
+        dimensions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        metrics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        advertiserIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        reportTemplateId: z.ZodNumber;
+        additionalConfig: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        reportName: string;
+        dateRange: "Yesterday" | "Last7Days" | "Last14Days" | "Last30Days" | "LastXDays" | "MonthToDate" | "LastMonth" | "QuarterToDate" | "LastQuarter" | "YearToDate" | "Custom";
+        reportTemplateId: number;
+        fileFormat: "CSV" | "TSV" | "ExcelPivot";
+        scheduleType: "Once" | "Daily" | "Weekly" | "Monthly" | "Quarterly";
+        scheduleStartDate?: string | undefined;
+        advertiserIds?: string[] | undefined;
+        dimensions?: string[] | undefined;
+        metrics?: string[] | undefined;
+        additionalConfig?: Record<string, unknown> | undefined;
+    }, {
+        reportName: string;
+        dateRange: "Yesterday" | "Last7Days" | "Last14Days" | "Last30Days" | "LastXDays" | "MonthToDate" | "LastMonth" | "QuarterToDate" | "LastQuarter" | "YearToDate" | "Custom";
+        reportTemplateId: number;
+        scheduleType: "Once" | "Daily" | "Weekly" | "Monthly" | "Quarterly";
+        fileFormat?: "CSV" | "TSV" | "ExcelPivot" | undefined;
+        scheduleStartDate?: string | undefined;
+        advertiserIds?: string[] | undefined;
+        dimensions?: string[] | undefined;
+        metrics?: string[] | undefined;
+        additionalConfig?: Record<string, unknown> | undefined;
+    }>;
+    outputSchema: z.ZodObject<{
+        reportScheduleId: z.ZodString;
+        reportName: z.ZodString;
+        scheduleType: z.ZodString;
+        timestamp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        reportScheduleId: string;
+        timestamp: string;
+        reportName: string;
+        scheduleType: string;
+    }, {
+        reportScheduleId: string;
+        timestamp: string;
+        reportName: string;
+        scheduleType: string;
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+    };
+    inputExamples: ({
+        label: string;
+        input: {
+            reportName: string;
+            scheduleType: string;
+            dateRange: string;
+            dimensions: string[];
+            metrics: string[];
+            advertiserIds: string[];
+            additionalConfig?: undefined;
+        };
+    } | {
+        label: string;
+        input: {
+            reportName: string;
+            scheduleType: string;
+            dateRange: string;
+            dimensions: string[];
+            metrics: string[];
+            additionalConfig: {
+                ReportStartDate: string;
+                ReportEndDate: string;
+            };
+            advertiserIds?: undefined;
+        };
+    })[];
+    logic: typeof createReportScheduleLogic;
+    responseFormatter: typeof createReportScheduleResponseFormatter;
+};
+export {};
+//# sourceMappingURL=create-report-schedule.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-report-schedule.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/create-report-schedule.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AA0BnF,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+DgB,CAAC;AAE7D,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;EAOP,CAAC;AAEvC,KAAK,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AACjF,KAAK,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAEnF,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,yBAAyB,EAChC,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,0BAA0B,CAAC,CA8BrC;AAED,wBAAgB,qCAAqC,CACnD,MAAM,EAAE,0BAA0B,GACjC,cAAc,EAAE,CAclB;AAED,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyCpC,CAAC"}

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

@@ -0,0 +1,171 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+const TOOL_NAME = "ttd_create_report_schedule";
+const TOOL_TITLE = "Create TTD Report Schedule";
+const TOOL_DESCRIPTION = `Create a named report schedule (Once, Daily, Weekly, or Monthly).
+
+This is a legacy-friendly REST wrapper for the MyReports schedule endpoint.
+Use this when you already know the REST payload shape or need compatibility with older callers.
+
+Report templates and report schedules are distinct in TTD:
+- A **template** defines report structure
+- A **schedule** controls when a template runs
+
+For the docs-aligned GraphQL workflow, prefer:
+- \`ttd_create_report_template\`
+- \`ttd_create_template_schedule\`
+- \`ttd_get_report_executions\`
+
+For a one-off blocking report use \`ttd_get_report\`.
+For a one-off non-blocking report use \`ttd_submit_report\`.
+
+**Recurring schedules** (Daily/Weekly/Monthly) persist in TTD and run automatically.
+Use \`ttd_list_report_schedules\` to view and \`ttd_delete_report_schedule\` to remove them.
+
+For custom date ranges pass \`ReportStartDate\` / \`ReportEndDate\` in \`additionalConfig\`.`;
+export const CreateReportScheduleInputSchema = z
+    .object({
+    reportName: z.string().min(1).describe("Name for the report schedule"),
+    scheduleType: z
+        .enum(["Once", "Daily", "Weekly", "Monthly", "Quarterly"])
+        .describe("How often the report runs (per TTD MyReports reportschedule/facets)"),
+    dateRange: z
+        .enum([
+        "Yesterday",
+        "Last7Days",
+        "Last14Days",
+        "Last30Days",
+        "LastXDays",
+        "MonthToDate",
+        "LastMonth",
+        "QuarterToDate",
+        "LastQuarter",
+        "YearToDate",
+        "Custom",
+    ])
+        .describe("Date range for the report data"),
+    fileFormat: z
+        .enum(["CSV", "TSV", "ExcelPivot"])
+        .optional()
+        .default("CSV")
+        .describe("Report file format. Must match the template's format. Use ExcelPivot for Excel-shaped templates."),
+    scheduleStartDate: z
+        .string()
+        .optional()
+        .describe("ISO datetime; defaults to today UTC at 00:00. Required by TTD."),
+    dimensions: z
+        .array(z.string())
+        .optional()
+        .describe("Report dimensions (e.g. AdvertiserId, CampaignId, AdGroupId, Date, Country). " +
+        "See the report-reference resource for the full list of 188 available dimensions."),
+    metrics: z
+        .array(z.string())
+        .optional()
+        .describe("Report metrics (e.g. Impressions, Clicks, TotalCost, CTR, ROAS). " +
+        "See the report-reference resource for the full list of 318 available metrics."),
+    advertiserIds: z
+        .array(z.string())
+        .optional()
+        .describe("Filter report to specific advertiser IDs"),
+    reportTemplateId: z
+        .number()
+        .describe("TTD report template ID — REQUIRED by TTD. Find IDs via ttd_list_report_templates or the TTD UI."),
+    additionalConfig: z
+        .record(z.unknown())
+        .optional()
+        .describe("Additional TTD report config fields passed verbatim to the API. " +
+        "Useful for: ReportStartDate / ReportEndDate (Custom range), delivery email settings, etc."),
+})
+    .describe("Parameters for creating a TTD report schedule");
+export const CreateReportScheduleOutputSchema = z
+    .object({
+    reportScheduleId: z.string().describe("The created report schedule ID"),
+    reportName: z.string(),
+    scheduleType: z.string(),
+    timestamp: z.string().datetime(),
+})
+    .describe("Created report schedule");
+export async function createReportScheduleLogic(input, context, sdkContext) {
+    const { ttdReportingService } = resolveSessionServices(sdkContext);
+    const startDate = input.scheduleStartDate ?? new Date().toISOString().slice(0, 10) + "T00:00:00";
+    const config = {
+        ReportScheduleName: input.reportName,
+        ReportTemplateId: input.reportTemplateId,
+        ReportFileFormat: input.fileFormat,
+        ReportDateRange: input.dateRange,
+        ReportFrequency: input.scheduleType,
+        ScheduleStartDate: startDate,
+        TimeZone: "UTC",
+        ReportDateFormat: "Sortable",
+        ReportNumericFormat: "US",
+        IncludeHeaders: true,
+        ...(input.dimensions && { ReportDimensions: input.dimensions }),
+        ...(input.metrics && { ReportMetrics: input.metrics }),
+        ...(input.advertiserIds && { AdvertiserFilters: input.advertiserIds }),
+        ...input.additionalConfig,
+    };
+    const result = await ttdReportingService.createReportSchedule(config, context);
+    return {
+        reportScheduleId: result.reportScheduleId,
+        reportName: input.reportName,
+        scheduleType: input.scheduleType,
+        timestamp: new Date().toISOString(),
+    };
+}
+export function createReportScheduleResponseFormatter(result) {
+    return [
+        {
+            type: "text",
+            text: `Report schedule created: ${result.reportScheduleId}\n` +
+                `Name: ${result.reportName}\n` +
+                `Type: ${result.scheduleType}\n\n` +
+                (result.scheduleType === "Once"
+                    ? `Use \`ttd_check_report_status\` with scheduleId "${result.reportScheduleId}" to poll for completion.\n`
+                    : `Recurring schedule saved. Use \`ttd_list_report_schedules\` to view all schedules.\n`) +
+                `\nTimestamp: ${result.timestamp}`,
+        },
+    ];
+}
+export const createReportScheduleTool = {
+    name: TOOL_NAME,
+    title: TOOL_TITLE,
+    description: TOOL_DESCRIPTION,
+    inputSchema: CreateReportScheduleInputSchema,
+    outputSchema: CreateReportScheduleOutputSchema,
+    annotations: {
+        readOnlyHint: false,
+        openWorldHint: false,
+        destructiveHint: false,
+        idempotentHint: false,
+    },
+    inputExamples: [
+        {
+            label: "Daily campaign performance schedule",
+            input: {
+                reportName: "Daily Campaign Performance",
+                scheduleType: "Daily",
+                dateRange: "Yesterday",
+                dimensions: ["CampaignId", "Date"],
+                metrics: ["Impressions", "Clicks", "TotalCost", "CTR"],
+                advertiserIds: ["adv123"],
+            },
+        },
+        {
+            label: "One-time custom date range report",
+            input: {
+                reportName: "Q1 2025 Review",
+                scheduleType: "Once",
+                dateRange: "Custom",
+                dimensions: ["AdvertiserId", "CampaignId"],
+                metrics: ["Impressions", "TotalCost", "ROAS"],
+                additionalConfig: {
+                    ReportStartDate: "2025-01-01",
+                    ReportEndDate: "2025-03-31",
+                },
+            },
+        },
+    ],
+    logic: createReportScheduleLogic,
+    responseFormatter: createReportScheduleResponseFormatter,
+};
+//# sourceMappingURL=create-report-schedule.tool.js.map

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

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