@cesteral/ttd-mcp 1.0.0

package/dist/auth/ttd-auth-strategy.js

@@ -0,0 +1,28 @@
+import { TtdDirectTokenAuthAdapter, parseTtdDirectTokenFromHeaders, getTtdDirectTokenFingerprint, } from "./ttd-auth-adapter.js";
+export class TtdTokenAuthStrategy {
+    graphqlUrl;
+    logger;
+    constructor(graphqlUrl, logger) {
+        this.graphqlUrl = graphqlUrl;
+        this.logger = logger;
+    }
+    async verify(headers) {
+        const credentials = parseTtdDirectTokenFromHeaders(headers);
+        const adapter = new TtdDirectTokenAuthAdapter(credentials.token, "direct-token", this.graphqlUrl);
+        await adapter.validate();
+        this.logger?.debug("TTD direct API token accepted");
+        return {
+            authInfo: {
+                clientId: "ttd-direct-token",
+                authType: "ttd-token",
+            },
+            platformAuthAdapter: adapter,
+            credentialFingerprint: getTtdDirectTokenFingerprint(credentials),
+        };
+    }
+    async getCredentialFingerprint(headers) {
+        const credentials = parseTtdDirectTokenFromHeaders(headers);
+        return getTtdDirectTokenFingerprint(credentials);
+    }
+}
+//# sourceMappingURL=ttd-auth-strategy.js.map

package/dist/auth/ttd-auth-strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ttd-auth-strategy.js","sourceRoot":"","sources":["../../src/auth/ttd-auth-strategy.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,yBAAyB,EACzB,8BAA8B,EAC9B,4BAA4B,GAC7B,MAAM,uBAAuB,CAAC;AAE/B,MAAM,OAAO,oBAAoB;IAEZ;IACA;IAFnB,YACmB,UAAkB,EAClB,MAAe;QADf,eAAU,GAAV,UAAU,CAAQ;QAClB,WAAM,GAAN,MAAM,CAAS;IAC/B,CAAC;IAEJ,KAAK,CAAC,MAAM,CAAC,OAAsD;QACjE,MAAM,WAAW,GAAG,8BAA8B,CAAC,OAAO,CAAC,CAAC;QAC5D,MAAM,OAAO,GAAG,IAAI,yBAAyB,CAC3C,WAAW,CAAC,KAAK,EACjB,cAAc,EACd,IAAI,CAAC,UAAU,CAChB,CAAC;QACF,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAC;QAEzB,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,+BAA+B,CAAC,CAAC;QAEpD,OAAO;YACL,QAAQ,EAAE;gBACR,QAAQ,EAAE,kBAAkB;gBAC5B,QAAQ,EAAE,WAAW;aACtB;YACD,mBAAmB,EAAE,OAAO;YAC5B,qBAAqB,EAAE,4BAA4B,CAAC,WAAW,CAAC;SACjE,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,wBAAwB,CAC5B,OAAsD;QAEtD,MAAM,WAAW,GAAG,8BAA8B,CAAC,OAAO,CAAC,CAAC;QAC5D,OAAO,4BAA4B,CAAC,WAAW,CAAC,CAAC;IACnD,CAAC;CACF"}

package/dist/config/index.d.ts

@@ -0,0 +1,100 @@
+import { z } from "zod";
+declare const ConfigSchema: z.ZodObject<{
+    host: z.ZodDefault<z.ZodString>;
+    nodeEnv: z.ZodDefault<z.ZodEnum<["development", "production", "test"]>>;
+    mcpStatefulSessionTimeoutMs: z.ZodDefault<z.ZodNumber>;
+    mcpAuthSecretKey: z.ZodOptional<z.ZodString>;
+    mcpAllowedOrigins: z.ZodOptional<z.ZodString>;
+    logLevel: z.ZodDefault<z.ZodEnum<["debug", "info", "notice", "warning", "error"]>>;
+    mcpLogLevel: z.ZodDefault<z.ZodEnum<["debug", "info", "notice", "warning", "error"]>>;
+    otelEnabled: z.ZodDefault<z.ZodBoolean>;
+    otelExporterOtlpTracesEndpoint: z.ZodOptional<z.ZodString>;
+    otelExporterOtlpMetricsEndpoint: z.ZodOptional<z.ZodString>;
+    gcsBucketName: z.ZodOptional<z.ZodString>;
+} & {
+    serviceName: z.ZodDefault<z.ZodString>;
+    port: z.ZodDefault<z.ZodNumber>;
+    otelServiceName: z.ZodDefault<z.ZodString>;
+    mcpAuthMode: z.ZodDefault<z.ZodEnum<["ttd-token", "jwt", "none"]>>;
+    ttdUseSandbox: z.ZodDefault<z.ZodBoolean>;
+    ttdApiBaseUrl: z.ZodDefault<z.ZodString>;
+    ttdGraphqlUrl: z.ZodDefault<z.ZodString>;
+    ttdRateLimitPerMinute: z.ZodDefault<z.ZodNumber>;
+    ttdApiToken: z.ZodOptional<z.ZodString>;
+    ttdReportPollIntervalMs: z.ZodDefault<z.ZodNumber>;
+    ttdReportMaxPollAttempts: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    serviceName: string;
+    port: number;
+    otelServiceName: string;
+    mcpAuthMode: "ttd-token" | "jwt" | "none";
+    ttdUseSandbox: boolean;
+    ttdApiBaseUrl: string;
+    ttdGraphqlUrl: string;
+    ttdRateLimitPerMinute: number;
+    ttdReportPollIntervalMs: number;
+    ttdReportMaxPollAttempts: number;
+    host: string;
+    nodeEnv: "development" | "production" | "test";
+    mcpStatefulSessionTimeoutMs: number;
+    logLevel: "debug" | "info" | "notice" | "warning" | "error";
+    mcpLogLevel: "debug" | "info" | "notice" | "warning" | "error";
+    otelEnabled: boolean;
+    ttdApiToken?: string | undefined;
+    mcpAuthSecretKey?: string | undefined;
+    mcpAllowedOrigins?: string | undefined;
+    otelExporterOtlpTracesEndpoint?: string | undefined;
+    otelExporterOtlpMetricsEndpoint?: string | undefined;
+    gcsBucketName?: string | undefined;
+}, {
+    serviceName?: string | undefined;
+    port?: number | undefined;
+    otelServiceName?: string | undefined;
+    mcpAuthMode?: "ttd-token" | "jwt" | "none" | undefined;
+    ttdUseSandbox?: boolean | undefined;
+    ttdApiBaseUrl?: string | undefined;
+    ttdGraphqlUrl?: string | undefined;
+    ttdRateLimitPerMinute?: number | undefined;
+    ttdApiToken?: string | undefined;
+    ttdReportPollIntervalMs?: number | undefined;
+    ttdReportMaxPollAttempts?: number | undefined;
+    host?: string | undefined;
+    nodeEnv?: "development" | "production" | "test" | undefined;
+    mcpStatefulSessionTimeoutMs?: number | undefined;
+    mcpAuthSecretKey?: string | undefined;
+    mcpAllowedOrigins?: string | undefined;
+    logLevel?: "debug" | "info" | "notice" | "warning" | "error" | undefined;
+    mcpLogLevel?: "debug" | "info" | "notice" | "warning" | "error" | undefined;
+    otelEnabled?: boolean | undefined;
+    otelExporterOtlpTracesEndpoint?: string | undefined;
+    otelExporterOtlpMetricsEndpoint?: string | undefined;
+    gcsBucketName?: string | undefined;
+}>;
+export type AppConfig = z.infer<typeof ConfigSchema>;
+export declare function parseConfig(): AppConfig;
+export declare const mcpConfig: {
+    serviceName: string;
+    port: number;
+    otelServiceName: string;
+    mcpAuthMode: "ttd-token" | "jwt" | "none";
+    ttdUseSandbox: boolean;
+    ttdApiBaseUrl: string;
+    ttdGraphqlUrl: string;
+    ttdRateLimitPerMinute: number;
+    ttdReportPollIntervalMs: number;
+    ttdReportMaxPollAttempts: number;
+    host: string;
+    nodeEnv: "development" | "production" | "test";
+    mcpStatefulSessionTimeoutMs: number;
+    logLevel: "debug" | "info" | "notice" | "warning" | "error";
+    mcpLogLevel: "debug" | "info" | "notice" | "warning" | "error";
+    otelEnabled: boolean;
+    ttdApiToken?: string | undefined;
+    mcpAuthSecretKey?: string | undefined;
+    mcpAllowedOrigins?: string | undefined;
+    otelExporterOtlpTracesEndpoint?: string | undefined;
+    otelExporterOtlpMetricsEndpoint?: string | undefined;
+    gcsBucketName?: string | undefined;
+};
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAYxB,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4BhB,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAErD,wBAAgB,WAAW,IAAI,SAAS,CAwCvC;AAED,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;CAAgB,CAAC"}

package/dist/config/index.js

@@ -0,0 +1,47 @@
+import { z } from "zod";
+import { loadDotEnv, BaseConfigSchema, getBaseEnvConfig, parseConfigWithSchema, getDefaultHost, } from "@cesteral/shared";
+loadDotEnv();
+const ConfigSchema = BaseConfigSchema.extend({
+    serviceName: z.string().default("ttd-mcp"),
+    port: z.number().int().min(1).max(65535).default(3003),
+    otelServiceName: z.string().default("ttd-mcp"),
+    mcpAuthMode: z.enum(["ttd-token", "jwt", "none"]).default("ttd-token"),
+    ttdUseSandbox: z.boolean().default(false),
+    ttdApiBaseUrl: z.string().url().default("https://api.thetradedesk.com/v3"),
+    ttdGraphqlUrl: z.string().url().default("https://desk.thetradedesk.com/graphql"),
+    ttdRateLimitPerMinute: z.number().default(60),
+    ttdApiToken: z.string().optional(),
+    ttdReportPollIntervalMs: z.number().int().min(1000).default(2000),
+    ttdReportMaxPollAttempts: z.number().int().min(1).default(60),
+});
+export function parseConfig() {
+    const defaultHost = getDefaultHost();
+    const rawConfig = {
+        ...getBaseEnvConfig(defaultHost),
+        serviceName: process.env.SERVICE_NAME,
+        ...(process.env.TTD_MCP_PORT ? { port: Number(process.env.TTD_MCP_PORT) } : {}),
+        host: process.env.TTD_MCP_HOST || defaultHost,
+        ttdUseSandbox: process.env.TTD_USE_SANDBOX === "true",
+        ttdApiBaseUrl: process.env.TTD_API_BASE_URL ||
+            (process.env.TTD_USE_SANDBOX === "true"
+                ? "https://ext-api.sb.thetradedesk.com/v3"
+                : undefined),
+        ttdGraphqlUrl: process.env.TTD_GRAPHQL_URL ||
+            (process.env.TTD_USE_SANDBOX === "true"
+                ? "https://ext-api.sb.thetradedesk.com/graphql"
+                : undefined),
+        ttdRateLimitPerMinute: process.env.TTD_RATE_LIMIT_PER_MINUTE
+            ? Number(process.env.TTD_RATE_LIMIT_PER_MINUTE)
+            : undefined,
+        ttdApiToken: process.env.TTD_API_TOKEN,
+        ttdReportPollIntervalMs: process.env.TTD_REPORT_POLL_INTERVAL_MS
+            ? parseInt(process.env.TTD_REPORT_POLL_INTERVAL_MS, 10)
+            : undefined,
+        ttdReportMaxPollAttempts: process.env.TTD_REPORT_MAX_POLL_ATTEMPTS
+            ? parseInt(process.env.TTD_REPORT_MAX_POLL_ATTEMPTS, 10)
+            : undefined,
+    };
+    return parseConfigWithSchema(ConfigSchema, rawConfig);
+}
+export const mcpConfig = parseConfig();
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,45 @@
+#!/usr/bin/env node
+import { mcpConfig } from "./config/index.js";
+import { createMcpServer, runStdioServer } from "./mcp-server/server.js";
+import { startHttpServer } from "./mcp-server/transports/streamable-http-transport.js";
+import { initializeOpenTelemetry, otelLogMixin } from "@cesteral/shared";
+import { TtdDirectTokenAuthAdapter } from "./auth/ttd-auth-adapter.js";
+import { detectTransportMode, createServerLogger, bootstrapMcpServer } from "@cesteral/shared";
+import { createSessionServices, sessionServiceStore } from "./services/session-services.js";
+import { rateLimiter } from "./utils/platform.js";
+const transportMode = detectTransportMode();
+const logger = createServerLogger("ttd-mcp", transportMode, otelLogMixin());
+async function setupStdioCredentials(sessionId) {
+    const directToken = mcpConfig.ttdApiToken;
+    if (!directToken) {
+        logger.warn("No TTD API token found in env vars. Set TTD_API_TOKEN for stdio mode.");
+        return false;
+    }
+    const authAdapter = new TtdDirectTokenAuthAdapter(directToken, "direct-token", mcpConfig.ttdGraphqlUrl);
+    await authAdapter.validate();
+    const services = createSessionServices(authAdapter, {
+        baseUrl: mcpConfig.ttdApiBaseUrl,
+        graphqlUrl: mcpConfig.ttdGraphqlUrl,
+        reportPollIntervalMs: mcpConfig.ttdReportPollIntervalMs,
+        reportMaxPollAttempts: mcpConfig.ttdReportMaxPollAttempts,
+    }, logger, rateLimiter);
+    sessionServiceStore.set(sessionId, services);
+    logger.info("Stdio session services created successfully");
+    return true;
+}
+bootstrapMcpServer({
+    serviceName: "ttd-mcp",
+    config: mcpConfig,
+    logger,
+    transportMode,
+    initOtel: initializeOpenTelemetry,
+    setupStdioSession: setupStdioCredentials,
+    createMcpServer,
+    runStdio: runStdioServer,
+    startHttp: startHttpServer,
+    onShutdown: () => rateLimiter.destroy(),
+}).catch((err) => {
+    logger.fatal({ err }, "Failed to start ttd-mcp");
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,sDAAsD,CAAC;AACvF,OAAO,EAAE,uBAAuB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC/F,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAC5F,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,MAAM,aAAa,GAAG,mBAAmB,EAAE,CAAC;AAC5C,MAAM,MAAM,GAAG,kBAAkB,CAAC,SAAS,EAAE,aAAa,EAAE,YAAY,EAAE,CAAC,CAAC;AAM5E,KAAK,UAAU,qBAAqB,CAAC,SAAiB;IACpD,MAAM,WAAW,GAAG,SAAS,CAAC,WAAW,CAAC;IAE1C,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,CAAC,IAAI,CAAC,uEAAuE,CAAC,CAAC;QACrF,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,yBAAyB,CAC/C,WAAW,EACX,cAAc,EACd,SAAS,CAAC,aAAa,CACxB,CAAC;IAGF,MAAM,WAAW,CAAC,QAAQ,EAAE,CAAC;IAE7B,MAAM,QAAQ,GAAG,qBAAqB,CACpC,WAAW,EACX;QACE,OAAO,EAAE,SAAS,CAAC,aAAa;QAChC,UAAU,EAAE,SAAS,CAAC,aAAa;QACnC,oBAAoB,EAAE,SAAS,CAAC,uBAAuB;QACvD,qBAAqB,EAAE,SAAS,CAAC,wBAAwB;KAC1D,EACD,MAAM,EACN,WAAW,CACZ,CAAC;IAEF,mBAAmB,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC7C,MAAM,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;IAC3D,OAAO,IAAI,CAAC;AACd,CAAC;AAED,kBAAkB,CAAC;IACjB,WAAW,EAAE,SAAS;IACtB,MAAM,EAAE,SAAS;IACjB,MAAM;IACN,aAAa;IACb,QAAQ,EAAE,uBAAuB;IACjC,iBAAiB,EAAE,qBAAqB;IACxC,eAAe;IACf,QAAQ,EAAE,cAAc;IACxB,SAAS,EAAE,eAAe;IAC1B,UAAU,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE;CACxC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACf,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,EAAE,yBAAyB,CAAC,CAAC;IACjD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.d.ts

@@ -0,0 +1,4 @@
+import type { Prompt } from "@modelcontextprotocol/sdk/types.js";
+export declare const bulkOperationsWorkflowPrompt: Prompt;
+export declare function getBulkOperationsWorkflowMessage(args?: Record<string, string>): string;
+//# sourceMappingURL=bulk-operations-workflow.prompt.d.ts.map

package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulk-operations-workflow.prompt.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAQjE,eAAO,MAAM,4BAA4B,EAAE,MAiB1C,CAAC;AAEF,wBAAgB,gCAAgC,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CA6QtF"}

package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.js

@@ -0,0 +1,286 @@
+export const bulkOperationsWorkflowPrompt = {
+    name: "ttd_bulk_operations_workflow",
+    description: "Step-by-step guide for TTD bulk operations: batch create/update campaigns and ad groups, batch status changes, archive entities, batch bid adjustments, and GraphQL bulk jobs. Covers PUT semantics, partial failure handling, and verification.",
+    arguments: [
+        {
+            name: "advertiserId",
+            description: "TTD Advertiser ID",
+            required: true,
+        },
+        {
+            name: "operation",
+            description: "Operation type: 'create', 'update', 'status', 'archive', 'bids', or 'graphql' (default: status)",
+            required: false,
+        },
+    ],
+};
+export function getBulkOperationsWorkflowMessage(args) {
+    const advertiserId = args?.advertiserId || "{advertiserId}";
+    const operation = args?.operation || "status";
+    return `# TTD Bulk Operations Workflow
+
+Advertiser: \`${advertiserId}\`
+Operation: \`${operation}\`
+
+---
+
+## Overview
+
+TTD supports these bulk operation tools:
+
+| Tool | Purpose | Max Items |
+|------|---------|-----------|
+| \`ttd_bulk_create_entities\` | Create multiple campaigns or ad groups | 50 |
+| \`ttd_bulk_update_entities\` | Update multiple campaigns or ad groups (PUT) | 50 |
+| \`ttd_bulk_update_status\` | Change status: Available, Paused, Archived | 100 |
+| \`ttd_archive_entities\` | Archive (soft-delete) campaigns or ad groups | 100 |
+| \`ttd_adjust_bids\` | Adjust ad group bid CPMs | 50 |
+| \`ttd_graphql_query_bulk\` | Bulk GraphQL queries (async job) | per job limits |
+| \`ttd_graphql_mutation_bulk\` | Bulk GraphQL mutations (async, non-cancelable) | 1000 |
+
+---
+
+## Bulk Status Updates
+
+### Step 1: Identify Entities
+
+\`\`\`json
+{
+  "tool": "ttd_list_entities",
+  "params": {
+    "entityType": "adGroup",
+    "advertiserId": "${advertiserId}",
+    "campaignId": "{campaignId}"
+  }
+}
+\`\`\`
+
+### Step 2: Execute Status Change
+
+\`\`\`json
+{
+  "tool": "ttd_bulk_update_status",
+  "params": {
+    "entityType": "adGroup",
+    "entityIds": ["{adGroupId1}", "{adGroupId2}", "{adGroupId3}"],
+    "status": "Paused"
+  }
+}
+\`\`\`
+
+Valid statuses: \`Available\`, \`Paused\`, \`Archived\`
+
+⚠️ **GOTCHA**: TTD uses "Available" (not "Active") for the active state.
+
+⚠️ **GOTCHA**: Archiving is **irreversible** — use \`ttd_archive_entities\` or set status to "Archived". Cannot be un-archived.
+
+---
+
+## Bulk Entity Creation
+
+### Step 1: Fetch Schema
+
+**Resource:** \`entity-schema://{entityType}\` and \`entity-examples://{entityType}\`
+
+### Step 2: Build and Execute
+
+\`\`\`json
+{
+  "tool": "ttd_bulk_create_entities",
+  "params": {
+    "entityType": "adGroup",
+    "advertiserId": "${advertiserId}",
+    "campaignId": "{campaignId}",
+    "items": [
+      {
+        "AdGroupName": "Ad Group - US Targeting",
+        "BaseBidCPM": { "Amount": 5.00, "CurrencyCode": "USD" },
+        "MaxBidCPM": { "Amount": 10.00, "CurrencyCode": "USD" },
+        "RTBAttributes": {
+          "BudgetSettings": {
+            "DailyBudget": { "Amount": 100.00, "CurrencyCode": "USD" }
+          }
+        }
+      },
+      {
+        "AdGroupName": "Ad Group - UK Targeting",
+        "BaseBidCPM": { "Amount": 4.00, "CurrencyCode": "USD" },
+        "MaxBidCPM": { "Amount": 8.00, "CurrencyCode": "USD" },
+        "RTBAttributes": {
+          "BudgetSettings": {
+            "DailyBudget": { "Amount": 75.00, "CurrencyCode": "USD" }
+          }
+        }
+      }
+    ]
+  }
+}
+\`\`\`
+
+⚠️ **GOTCHA**: \`RTBAttributes\` is required for ad groups and must include budget settings.
+
+---
+
+## Bulk Entity Updates
+
+### Step 1: Fetch Current State
+
+TTD uses **PUT semantics** — the entire entity is replaced. You MUST fetch the current entity first, merge your changes, then send the full payload.
+
+\`\`\`json
+{
+  "tool": "ttd_get_entity",
+  "params": {
+    "entityType": "adGroup",
+    "entityId": "{adGroupId}"
+  }
+}
+\`\`\`
+
+### Step 2: Merge and Execute
+
+\`\`\`json
+{
+  "tool": "ttd_bulk_update_entities",
+  "params": {
+    "entityType": "adGroup",
+    "advertiserId": "${advertiserId}",
+    "campaignId": "{campaignId}",
+    "items": [
+      {
+        "entityId": "{adGroupId1}",
+        "data": { "...full entity with your changes merged in..." }
+      },
+      {
+        "entityId": "{adGroupId2}",
+        "data": { "...full entity with your changes merged in..." }
+      }
+    ]
+  }
+}
+\`\`\`
+
+⚠️ **GOTCHA**: Unlike DV360 (PATCH with updateMask), TTD uses **PUT** (full replacement). Omitting a field resets it to default. Always GET first, then merge changes.
+
+---
+
+## Archive Entities
+
+For permanent soft-deletion:
+
+\`\`\`json
+{
+  "tool": "ttd_archive_entities",
+  "params": {
+    "entityType": "campaign",
+    "entityIds": ["{campaignId1}", "{campaignId2}"]
+  }
+}
+\`\`\`
+
+⚠️ **WARNING**: Archiving is irreversible. Consider pausing first if you might want to reactivate later.
+
+---
+
+## Batch Bid Adjustments
+
+### Step 1: Review Current Bids
+
+\`\`\`json
+{
+  "tool": "ttd_list_entities",
+  "params": {
+    "entityType": "adGroup",
+    "advertiserId": "${advertiserId}",
+    "campaignId": "{campaignId}"
+  }
+}
+\`\`\`
+
+Note the current \`BaseBidCPM\` and \`MaxBidCPM\` for each ad group.
+
+### Step 2: Execute Adjustments
+
+TTD bids are in **dollars** (not micros like DV360/Google Ads).
+
+\`\`\`json
+{
+  "tool": "ttd_adjust_bids",
+  "params": {
+    "adjustments": [
+      {
+        "adGroupId": "{adGroupId1}",
+        "baseBidCpm": 6.50,
+        "maxBidCpm": 12.00
+      },
+      {
+        "adGroupId": "{adGroupId2}",
+        "baseBidCpm": 5.25,
+        "maxBidCpm": 10.00
+      }
+    ]
+  }
+}
+\`\`\`
+
+⚠️ **GOTCHA**: TTD bids are in **dollars** (e.g., 5.00 = $5.00 CPM), not micros or cents. This differs from DV360 (micros) and Meta (cents).
+
+---
+
+## GraphQL Bulk Jobs (Advanced)
+
+For large-scale operations beyond REST API limits.
+
+### Bulk Query
+
+\`\`\`json
+{
+  "tool": "ttd_graphql_query_bulk",
+  "params": {
+    "query": "query GetAdGroup(\$adGroupId: ID!) { adGroup(id: \$adGroupId) { name status } }",
+    "variables": [
+      { "adGroupId": "{id1}" },
+      { "adGroupId": "{id2}" }
+    ]
+  }
+}
+\`\`\`
+
+### Check Job Status
+
+\`\`\`json
+{
+  "tool": "ttd_graphql_bulk_job",
+  "params": { "jobId": "{jobId}" }
+}
+\`\`\`
+
+### Cancel Query Job
+
+\`\`\`json
+{
+  "tool": "ttd_graphql_cancel_bulk_job",
+  "params": { "jobId": "{jobId}" }
+}
+\`\`\`
+
+⚠️ **GOTCHA**: Bulk **mutation** jobs are **non-cancelable** once submitted. Double-check inputs before submitting.
+
+⚠️ **GOTCHA**: Result URLs expire after **1 hour**. Download promptly.
+
+⚠️ **GOTCHA**: Max 10 active / 20 queued jobs per partner.
+
+---
+
+## Safety Checklist
+
+- [ ] Correct \`advertiserId\`
+- [ ] Entity IDs verified by listing first
+- [ ] For updates: GET current entity first (PUT semantics = full replacement)
+- [ ] For archive: confirmed irreversibility with user
+- [ ] For bids: amounts in dollars (not micros or cents)
+- [ ] For GraphQL mutations: inputs double-checked (non-cancelable)
+- [ ] Partial failure results reviewed before proceeding
+`;
+}
+//# sourceMappingURL=bulk-operations-workflow.prompt.js.map

package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulk-operations-workflow.prompt.js","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.ts"],"names":[],"mappings":"AAWA,MAAM,CAAC,MAAM,4BAA4B,GAAW;IAClD,IAAI,EAAE,8BAA8B;IACpC,WAAW,EACT,kPAAkP;IACpP,SAAS,EAAE;QACT;YACE,IAAI,EAAE,cAAc;YACpB,WAAW,EAAE,mBAAmB;YAChC,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,WAAW;YACjB,WAAW,EACT,iGAAiG;YACnG,QAAQ,EAAE,KAAK;SAChB;KACF;CACF,CAAC;AAEF,MAAM,UAAU,gCAAgC,CAAC,IAA6B;IAC5E,MAAM,YAAY,GAAG,IAAI,EAAE,YAAY,IAAI,gBAAgB,CAAC;IAC5D,MAAM,SAAS,GAAG,IAAI,EAAE,SAAS,IAAI,QAAQ,CAAC;IAE9C,OAAO;;gBAEO,YAAY;eACb,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBA6BD,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBAwCZ,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBAuDZ,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBA+CZ,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0FlC,CAAC;AACF,CAAC"}

package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.d.ts

@@ -0,0 +1,4 @@
+import type { Prompt } from "@modelcontextprotocol/sdk/types.js";
+export declare const campaignSetupWorkflowPrompt: Prompt;
+export declare function getCampaignSetupWorkflowMessage(args?: Record<string, string>): string;
+//# sourceMappingURL=campaign-setup-workflow.prompt.d.ts.map

package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"campaign-setup-workflow.prompt.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAEjE,eAAO,MAAM,2BAA2B,EAAE,MAWzC,CAAC;AAEF,wBAAgB,+BAA+B,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAyOrF"}