@cesteral/ttd-mcp 1.0.0

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

@@ -0,0 +1,141 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+const TOOL_NAME = "ttd_bulk_manage_bid_lists";
+const TOOL_TITLE = "TTD Bulk Manage Bid Lists";
+const TOOL_DESCRIPTION = `Batch get or batch update multiple TTD bid lists via GraphQL.
+
+TTD's GraphQL has no native multi-id bid-list query or multi-input update mutation — this tool fans out individual \`bidList(id:)\` queries and \`bidListUpdate(input:)\` mutations in parallel (concurrency=5) and aggregates the per-item results.
+
+### Operations
+- **batch_get** — Retrieve up to 50 bid lists by their IDs
+- **batch_update** — Update up to 50 bid lists; each item must be a complete \`BidListUpdateInput\`
+
+### Notes
+- TTD's \`/v3/bidlist/batch*\` REST endpoints are deprecated; this tool uses GraphQL.
+- Per-item failures are surfaced in the response without aborting other items.
+- Optional \`selection\` lets you override the GraphQL selection set (default: \`"id name"\`).
+- For single bid list operations including create/set/delete, use \`ttd_manage_bid_list\`.`;
+export const BidListBulkInputSchema = z
+    .object({
+    operation: z.enum(["batch_get", "batch_update"]).describe("Operation to perform"),
+    bidListIds: z
+        .array(z.string())
+        .min(1)
+        .max(50)
+        .optional()
+        .describe("Required for batch_get; array of bid list IDs (max 50)"),
+    items: z
+        .array(z.record(z.any()))
+        .min(1)
+        .max(50)
+        .optional()
+        .describe("Required for batch_update; each must be a complete BidListUpdateInput (max 50)"),
+    selection: z
+        .string()
+        .optional()
+        .describe('GraphQL selection set on returned BidList. Default: "id name"'),
+})
+    .refine((val) => val.operation === "batch_get"
+    ? Array.isArray(val.bidListIds) && val.bidListIds.length > 0
+    : true, {
+    message: "bidListIds is required for batch_get",
+    path: ["bidListIds"],
+})
+    .refine((val) => val.operation === "batch_update" ? Array.isArray(val.items) && val.items.length > 0 : true, {
+    message: "items is required for batch_update",
+    path: ["items"],
+})
+    .describe("Parameters for bulk bid list operations via GraphQL");
+export const BidListBulkOutputSchema = z
+    .object({
+    operation: z.string(),
+    totalItems: z.number(),
+    succeeded: z.number(),
+    failed: z.number(),
+    results: z.array(z.record(z.any())),
+    timestamp: z.string().datetime(),
+})
+    .describe("Bulk bid list operation result");
+export async function bidListBulkLogic(input, context, sdkContext) {
+    const { ttdService } = resolveSessionServices(sdkContext);
+    const selection = input.selection ?? "id name";
+    const ts = new Date().toISOString();
+    if (input.operation === "batch_get") {
+        const results = await ttdService.batchGetBidLists(input.bidListIds, context, selection);
+        return {
+            operation: "batch_get",
+            totalItems: results.length,
+            succeeded: results.filter((r) => r.success).length,
+            failed: results.filter((r) => !r.success).length,
+            results: results,
+            timestamp: ts,
+        };
+    }
+    const results = await ttdService.batchUpdateBidLists(input.items, context, selection);
+    return {
+        operation: "batch_update",
+        totalItems: results.length,
+        succeeded: results.filter((r) => r.success).length,
+        failed: results.filter((r) => !r.success).length,
+        results: results,
+        timestamp: ts,
+    };
+}
+export function bidListBulkResponseFormatter(result) {
+    const label = result.operation === "batch_get" ? "Batch get" : "Batch update";
+    return [
+        {
+            type: "text",
+            text: [
+                `${label} via GraphQL: ${result.succeeded}/${result.totalItems} succeeded, ${result.failed} failed`,
+                "",
+                `Results: ${JSON.stringify(result.results, null, 2)}`,
+                `Timestamp: ${result.timestamp}`,
+            ].join("\n"),
+        },
+    ];
+}
+export const bulkManageBidListsTool = {
+    name: TOOL_NAME,
+    title: TOOL_TITLE,
+    description: TOOL_DESCRIPTION,
+    inputSchema: BidListBulkInputSchema,
+    outputSchema: BidListBulkOutputSchema,
+    annotations: {
+        readOnlyHint: false,
+        openWorldHint: false,
+        destructiveHint: false,
+        idempotentHint: false,
+    },
+    inputExamples: [
+        {
+            label: "Batch get bid lists by IDs",
+            input: {
+                operation: "batch_get",
+                bidListIds: ["bl-abc123", "bl-def456", "bl-ghi789"],
+                selection: "id name adjustmentType",
+            },
+        },
+        {
+            label: "Batch incremental updates",
+            input: {
+                operation: "batch_update",
+                items: [
+                    {
+                        id: "bl-abc123",
+                        linesToAdd: [
+                            { dimensionValues: [{ dimension: "Site", value: "nytimes.com" }], adjustment: 1.5 },
+                        ],
+                    },
+                    {
+                        id: "bl-def456",
+                        linesToRemove: [{ dimensionValues: [{ dimension: "Site", value: "example-bad.com" }] }],
+                    },
+                ],
+            },
+        },
+    ],
+    logic: bidListBulkLogic,
+    responseFormatter: bidListBulkResponseFormatter,
+};
+//# sourceMappingURL=bid-list-bulk.tool.js.map

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

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

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

@@ -0,0 +1,225 @@
+import { z } from "zod";
+import type { McpTextContent, RequestContext } from "@cesteral/shared";
+import type { SdkContext } from "@cesteral/shared";
+export declare const BidListInputSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
+    operation: z.ZodEnum<["create", "get", "update", "set", "delete"]>;
+    bidListId: z.ZodOptional<z.ZodString>;
+    data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    selection: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    operation: "create" | "update" | "set" | "get" | "delete";
+    data?: Record<string, any> | undefined;
+    bidListId?: string | undefined;
+    selection?: string | undefined;
+}, {
+    operation: "create" | "update" | "set" | "get" | "delete";
+    data?: Record<string, any> | undefined;
+    bidListId?: string | undefined;
+    selection?: string | undefined;
+}>, {
+    operation: "create" | "update" | "set" | "get" | "delete";
+    data?: Record<string, any> | undefined;
+    bidListId?: string | undefined;
+    selection?: string | undefined;
+}, {
+    operation: "create" | "update" | "set" | "get" | "delete";
+    data?: Record<string, any> | undefined;
+    bidListId?: string | undefined;
+    selection?: string | undefined;
+}>, {
+    operation: "create" | "update" | "set" | "get" | "delete";
+    data?: Record<string, any> | undefined;
+    bidListId?: string | undefined;
+    selection?: string | undefined;
+}, {
+    operation: "create" | "update" | "set" | "get" | "delete";
+    data?: Record<string, any> | undefined;
+    bidListId?: string | undefined;
+    selection?: string | undefined;
+}>;
+export declare const BidListOutputSchema: z.ZodObject<{
+    operation: z.ZodString;
+    bidListId: z.ZodOptional<z.ZodString>;
+    result: z.ZodRecord<z.ZodString, z.ZodAny>;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    timestamp: string;
+    result: Record<string, any>;
+    operation: string;
+    bidListId?: string | undefined;
+}, {
+    timestamp: string;
+    result: Record<string, any>;
+    operation: string;
+    bidListId?: string | undefined;
+}>;
+type BidListInput = z.infer<typeof BidListInputSchema>;
+type BidListOutput = z.infer<typeof BidListOutputSchema>;
+export declare function bidListLogic(input: BidListInput, context: RequestContext, sdkContext?: SdkContext): Promise<BidListOutput>;
+export declare function bidListResponseFormatter(result: BidListOutput): McpTextContent[];
+export declare const manageBidListTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
+        operation: z.ZodEnum<["create", "get", "update", "set", "delete"]>;
+        bidListId: z.ZodOptional<z.ZodString>;
+        data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        selection: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        operation: "create" | "update" | "set" | "get" | "delete";
+        data?: Record<string, any> | undefined;
+        bidListId?: string | undefined;
+        selection?: string | undefined;
+    }, {
+        operation: "create" | "update" | "set" | "get" | "delete";
+        data?: Record<string, any> | undefined;
+        bidListId?: string | undefined;
+        selection?: string | undefined;
+    }>, {
+        operation: "create" | "update" | "set" | "get" | "delete";
+        data?: Record<string, any> | undefined;
+        bidListId?: string | undefined;
+        selection?: string | undefined;
+    }, {
+        operation: "create" | "update" | "set" | "get" | "delete";
+        data?: Record<string, any> | undefined;
+        bidListId?: string | undefined;
+        selection?: string | undefined;
+    }>, {
+        operation: "create" | "update" | "set" | "get" | "delete";
+        data?: Record<string, any> | undefined;
+        bidListId?: string | undefined;
+        selection?: string | undefined;
+    }, {
+        operation: "create" | "update" | "set" | "get" | "delete";
+        data?: Record<string, any> | undefined;
+        bidListId?: string | undefined;
+        selection?: string | undefined;
+    }>;
+    outputSchema: z.ZodObject<{
+        operation: z.ZodString;
+        bidListId: z.ZodOptional<z.ZodString>;
+        result: z.ZodRecord<z.ZodString, z.ZodAny>;
+        timestamp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        timestamp: string;
+        result: Record<string, any>;
+        operation: string;
+        bidListId?: string | undefined;
+    }, {
+        timestamp: string;
+        result: Record<string, any>;
+        operation: string;
+        bidListId?: string | undefined;
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+    };
+    inputExamples: ({
+        label: string;
+        input: {
+            operation: string;
+            data: {
+                owner: {
+                    type: string;
+                    id: string;
+                };
+                name: string;
+                adjustmentType: string;
+                lines: {
+                    dimensionValues: {
+                        dimension: string;
+                        value: string;
+                    }[];
+                    adjustment: number;
+                }[];
+                id?: undefined;
+                linesToAdd?: undefined;
+                linesToRemove?: undefined;
+            };
+            bidListId?: undefined;
+            selection?: undefined;
+        };
+    } | {
+        label: string;
+        input: {
+            operation: string;
+            bidListId: string;
+            selection: string;
+            data?: undefined;
+        };
+    } | {
+        label: string;
+        input: {
+            operation: string;
+            data: {
+                id: string;
+                lines: {
+                    dimensionValues: {
+                        dimension: string;
+                        value: string;
+                    }[];
+                    adjustment: number;
+                }[];
+                owner?: undefined;
+                name?: undefined;
+                adjustmentType?: undefined;
+                linesToAdd?: undefined;
+                linesToRemove?: undefined;
+            };
+            bidListId?: undefined;
+            selection?: undefined;
+        };
+    } | {
+        label: string;
+        input: {
+            operation: string;
+            data: {
+                id: string;
+                linesToAdd: {
+                    dimensionValues: {
+                        dimension: string;
+                        value: string;
+                    }[];
+                    adjustment: number;
+                }[];
+                linesToRemove: {
+                    dimensionValues: {
+                        dimension: string;
+                        value: string;
+                    }[];
+                }[];
+                owner?: undefined;
+                name?: undefined;
+                adjustmentType?: undefined;
+                lines?: undefined;
+            };
+            bidListId?: undefined;
+            selection?: undefined;
+        };
+    } | {
+        label: string;
+        input: {
+            operation: string;
+            data: {
+                id: string;
+                owner?: undefined;
+                name?: undefined;
+                adjustmentType?: undefined;
+                lines?: undefined;
+                linesToAdd?: undefined;
+                linesToRemove?: undefined;
+            };
+            bidListId?: undefined;
+            selection?: undefined;
+        };
+    })[];
+    logic: typeof bidListLogic;
+    responseFormatter: typeof bidListResponseFormatter;
+};
+export {};
+//# sourceMappingURL=bid-list.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bid-list.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/bid-list.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;AAuBnD,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkCyC,CAAC;AAEzE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;EAOQ,CAAC;AAEzC,KAAK,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AACvD,KAAK,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEzD,wBAAsB,YAAY,CAChC,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,aAAa,CAAC,CAkDxB;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,aAAa,GAAG,cAAc,EAAE,CAMhF;AAED,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwE7B,CAAC"}

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

@@ -0,0 +1,169 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+import { McpError, JsonRpcErrorCode } from "@cesteral/shared";
+const TOOL_NAME = "ttd_manage_bid_list";
+const TOOL_TITLE = "TTD Manage Bid List";
+const TOOL_DESCRIPTION = `Create, retrieve, update, replace, or delete a single TTD bid list via GraphQL.
+
+Bid lists define price floors/ceilings or block rules for specific inventory targets (domains, apps, deal IDs, etc.) and are attached to ad groups or advertisers.
+
+### Operations
+- **create** — \`bidListCreate(input: BidListCreateInput!)\` — create a new bid list
+- **get** — \`bidList(id: ID!)\` — retrieve a bid list by ID
+- **update** — \`bidListUpdate(input: BidListUpdateInput!)\` — incremental change (add/remove specific lines without restating the entire list)
+- **set** — \`bidListSet(input: BidListSetInput!)\` — atomic full-replace of all lines with the supplied set
+- **delete** — \`bidListDelete(input: BidListDeleteInput!)\` — remove the bid list
+
+### Notes
+- TTD's \`/v3/bidlist*\` REST endpoints are deprecated — this tool uses the GraphQL replacements documented in ttd-api-reference-part2.md.
+- For \`get\`, the \`bidListId\` you pass is forwarded as the GraphQL \`id\`.
+- For \`create\`/\`update\`/\`set\`/\`delete\`, pass the full GraphQL input object via \`data\`. TTD's input shape (not the old REST shape) is what's expected.
+- Optional \`selection\` lets you override the GraphQL selection set on the returned \`BidList\` (default: \`"id name"\`).
+- To manage multiple bid lists at once, use \`ttd_bulk_manage_bid_lists\`.`;
+export const BidListInputSchema = z
+    .object({
+    operation: z.enum(["create", "get", "update", "set", "delete"]).describe("GraphQL operation"),
+    bidListId: z.string().optional().describe("Required for get"),
+    data: z
+        .record(z.any())
+        .optional()
+        .describe("GraphQL input object — required for create/update/set/delete. Must match TTD's BidList{Create,Update,Set,Delete}Input shape."),
+    selection: z
+        .string()
+        .optional()
+        .describe('GraphQL selection set on the returned BidList. Default: "id name". Use "id name lines { ... }" for richer responses.'),
+})
+    .refine((val) => val.operation === "get"
+    ? typeof val.bidListId === "string" && val.bidListId.length > 0
+    : true, { message: "bidListId is required for get", path: ["bidListId"] })
+    .refine((val) => val.operation === "create" ||
+    val.operation === "update" ||
+    val.operation === "set" ||
+    val.operation === "delete"
+    ? val.data !== undefined && val.data !== null
+    : true, { message: "data is required for create/update/set/delete", path: ["data"] })
+    .describe("Parameters for managing a single TTD bid list via GraphQL");
+export const BidListOutputSchema = z
+    .object({
+    operation: z.string().describe("The operation that was performed"),
+    bidListId: z.string().optional().describe("The bid list ID if applicable"),
+    result: z.record(z.any()).describe("Raw GraphQL response"),
+    timestamp: z.string().datetime(),
+})
+    .describe("Bid list operation result");
+export async function bidListLogic(input, context, sdkContext) {
+    const { ttdService } = resolveSessionServices(sdkContext);
+    const selection = input.selection ?? "id name";
+    const now = () => new Date().toISOString();
+    switch (input.operation) {
+        case "create": {
+            if (!input.data)
+                throw new McpError(JsonRpcErrorCode.InvalidParams, "data is required for create");
+            const result = (await ttdService.createBidList(input.data, context, selection));
+            return { operation: "create", result, timestamp: now() };
+        }
+        case "get": {
+            const result = (await ttdService.getBidList(input.bidListId, context, selection));
+            return { operation: "get", bidListId: input.bidListId, result, timestamp: now() };
+        }
+        case "update": {
+            if (!input.data)
+                throw new McpError(JsonRpcErrorCode.InvalidParams, "data is required for update");
+            const result = (await ttdService.updateBidList(input.data, context, selection));
+            return { operation: "update", bidListId: input.bidListId, result, timestamp: now() };
+        }
+        case "set": {
+            if (!input.data)
+                throw new McpError(JsonRpcErrorCode.InvalidParams, "data is required for set");
+            const result = (await ttdService.setBidList(input.data, context, selection));
+            return { operation: "set", bidListId: input.bidListId, result, timestamp: now() };
+        }
+        case "delete": {
+            if (!input.data)
+                throw new McpError(JsonRpcErrorCode.InvalidParams, "data is required for delete");
+            const result = (await ttdService.deleteBidList(input.data, context));
+            return { operation: "delete", bidListId: input.bidListId, result, timestamp: now() };
+        }
+    }
+}
+export function bidListResponseFormatter(result) {
+    const lines = [`Bid list ${result.operation} via GraphQL.`, ""];
+    if (result.bidListId)
+        lines.push(`Bid List ID: ${result.bidListId}`);
+    lines.push(`Result: ${JSON.stringify(result.result, null, 2)}`);
+    lines.push(`Timestamp: ${result.timestamp}`);
+    return [{ type: "text", text: lines.join("\n") }];
+}
+export const manageBidListTool = {
+    name: TOOL_NAME,
+    title: TOOL_TITLE,
+    description: TOOL_DESCRIPTION,
+    inputSchema: BidListInputSchema,
+    outputSchema: BidListOutputSchema,
+    annotations: {
+        readOnlyHint: false,
+        openWorldHint: false,
+        destructiveHint: false,
+        idempotentHint: false,
+    },
+    inputExamples: [
+        {
+            label: "Create a bid list",
+            input: {
+                operation: "create",
+                data: {
+                    owner: { type: "Advertiser", id: "adv123abc" },
+                    name: "Premium News Domains",
+                    adjustmentType: "BidMultiplier",
+                    lines: [
+                        { dimensionValues: [{ dimension: "Site", value: "nytimes.com" }], adjustment: 1.5 },
+                        { dimensionValues: [{ dimension: "Site", value: "wsj.com" }], adjustment: 1.3 },
+                    ],
+                },
+            },
+        },
+        {
+            label: "Get a bid list by ID",
+            input: {
+                operation: "get",
+                bidListId: "bl-abc123def",
+                selection: "id name adjustmentType lines { dimensionValues { dimension value } adjustment }",
+            },
+        },
+        {
+            label: "Atomically replace all lines (bidListSet)",
+            input: {
+                operation: "set",
+                data: {
+                    id: "bl-abc123def",
+                    lines: [
+                        { dimensionValues: [{ dimension: "Site", value: "nytimes.com" }], adjustment: 1.8 },
+                    ],
+                },
+            },
+        },
+        {
+            label: "Incrementally add/remove lines (bidListUpdate)",
+            input: {
+                operation: "update",
+                data: {
+                    id: "bl-abc123def",
+                    linesToAdd: [
+                        { dimensionValues: [{ dimension: "Site", value: "ft.com" }], adjustment: 1.4 },
+                    ],
+                    linesToRemove: [{ dimensionValues: [{ dimension: "Site", value: "wsj.com" }] }],
+                },
+            },
+        },
+        {
+            label: "Delete a bid list",
+            input: {
+                operation: "delete",
+                data: { id: "bl-abc123def" },
+            },
+        },
+    ],
+    logic: bidListLogic,
+    responseFormatter: bidListResponseFormatter,
+};
+//# sourceMappingURL=bid-list.tool.js.map

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

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