@cesteral/amazon-dsp-mcp 1.0.0

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

@@ -0,0 +1,63 @@
+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 { getAdPreviewTool } from "./get-ad-preview.tool.js";
+export { duplicateEntityTool } from "./duplicate-entity.tool.js";
+export { validateEntityTool } from "./validate-entity.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 { getAdPreviewTool } from "./get-ad-preview.tool.js";
+import { duplicateEntityTool } from "./duplicate-entity.tool.js";
+import { validateEntityTool } from "./validate-entity.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,
+    getAdPreviewTool,
+    duplicateEntityTool,
+    validateEntityTool,
+    createToolSearchTool({ platform: "amazon_dsp", 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,gDAEoB,CAAC;AAE5D,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,CAYhC;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 = "amazon_dsp_list_advertisers";
+const TOOL_TITLE = "List AmazonDsp Advertisers";
+const TOOL_DESCRIPTION = `List AmazonDsp advertiser accounts accessible to the authenticated user.
+
+Returns advertiser IDs, names, and account status information.
+Use the profile_id from results with other amazon_dsp_* tools.`;
+export const ListAdvertisersInputSchema = z
+    .object({})
+    .describe("Parameters for listing AmazonDsp 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 { amazonDspService } = resolveSessionServices(sdkContext);
+    const result = await amazonDspService.listAdvertisers(0, 100, context);
+    const advertisers = result.entities;
+    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,6BAA6B,CAAC;AAChD,MAAM,UAAU,GAAG,4BAA4B,CAAC;AAChD,MAAM,gBAAgB,GAAG;;;+DAGsC,CAAC;AAEhE,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC;KACxC,MAAM,CAAC,EAAE,CAAC;KACV,QAAQ,CAAC,8CAA8C,CAAC,CAAC;AAE5D,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,gBAAgB,EAAE,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAEhE,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,eAAe,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IAEvE,MAAM,WAAW,GAAG,MAAM,CAAC,QAAgD,CAAC;IAE5E,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,171 @@
+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[]]>;
+    profileId: z.ZodString;
+    filters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    startIndex: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    pageSize: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    startIndex: number;
+    entityType: string;
+    profileId: string;
+    pageSize: number;
+    filters?: Record<string, string> | undefined;
+}, {
+    entityType: string;
+    profileId: string;
+    startIndex?: number | undefined;
+    filters?: Record<string, string> | 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[]]>;
+        profileId: z.ZodString;
+        filters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        startIndex: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        pageSize: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, "strip", z.ZodTypeAny, {
+        startIndex: number;
+        entityType: string;
+        profileId: string;
+        pageSize: number;
+        filters?: Record<string, string> | undefined;
+    }, {
+        entityType: string;
+        profileId: string;
+        startIndex?: number | undefined;
+        filters?: Record<string, string> | 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;
+            profileId: string;
+            filters: {
+                advertiserId: string;
+                orderId?: undefined;
+            };
+            startIndex: number;
+            pageSize: number;
+        };
+    } | {
+        label: string;
+        input: {
+            entityType: string;
+            profileId: string;
+            filters: {
+                orderId: string;
+                advertiserId?: undefined;
+            };
+            startIndex?: 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;AAanD,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;EAwBqB,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,CAyB7B;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,EAAE,CAgB1F;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkC5B,CAAC"}

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

@@ -0,0 +1,112 @@
+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 = "amazon_dsp_list_entities";
+const TOOL_TITLE = "List AmazonDsp Ads Entities";
+const TOOL_DESCRIPTION = `List Amazon DSP entities with optional filtering and offset-based pagination.
+
+**Entity Hierarchy:** Advertiser > Order (Campaign) > Line Item (Ad Group) > Creative
+
+**Supported entity types:** ${getEntityTypeEnum().join(", ")}
+
+All entities are scoped to an advertiser account. Pagination uses \`startIndex\` (offset) and \`pageSize\`.
+Use the entity-specific filter param: campaigns / orders filter by \`advertiserId\`, ad groups / line items filter by \`orderId\`, targets by \`lineItemId\`, and creative associations by \`lineItemId\`.`;
+export const ListEntitiesInputSchema = z
+    .object({
+    entityType: z.enum(getEntityTypeEnum()).describe("Type of entities to list"),
+    profileId: z.string().min(1).describe("Amazon DSP Advertiser ID (used as the scope/profile)"),
+    filters: z
+        .record(z.string())
+        .optional()
+        .describe("Optional filter criteria (e.g., { advertiserId: '123', orderId: '456' })"),
+    startIndex: z
+        .number()
+        .int()
+        .min(0)
+        .optional()
+        .default(0)
+        .describe("Start index for offset pagination (default 0)"),
+    pageSize: z
+        .number()
+        .int()
+        .min(1)
+        .max(100)
+        .optional()
+        .default(25)
+        .describe("Number of entities per page (default 25, max 100)"),
+})
+    .describe("Parameters for listing Amazon DSP 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 { amazonDspService } = resolveSessionServices(sdkContext);
+    const result = await amazonDspService.listEntities(input.entityType, input.filters, input.startIndex, input.pageSize, context);
+    const { pageInfo } = result;
+    const hasMore = pageInfo.startIndex + pageInfo.count < pageInfo.totalResults;
+    const nextStartIndex = pageInfo.startIndex + pageInfo.count;
+    return {
+        entities: result.entities,
+        pagination: buildPaginationOutput({
+            nextCursor: hasMore ? String(nextStartIndex) : null,
+            pageSize: pageInfo.count,
+            totalCount: pageInfo.totalResults,
+            nextPageInputKey: "startIndex",
+        }),
+        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 orders (campaigns)",
+            input: {
+                entityType: "campaign",
+                profileId: "1234567890",
+                filters: { advertiserId: "adv_123" },
+                startIndex: 0,
+                pageSize: 25,
+            },
+        },
+        {
+            label: "List line items for an order",
+            input: {
+                entityType: "adGroup",
+                profileId: "1234567890",
+                filters: { orderId: "ord_456" },
+            },
+        },
+    ],
+    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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"}

package/dist/mcp-server/tools/definitions/search-targeting.tool.d.ts

@@ -0,0 +1,89 @@
+import { z } from "zod";
+import type { RequestContext, McpTextContent } from "@cesteral/shared";
+import type { SdkContext } from "@cesteral/shared";
+export declare const SearchTargetingInputSchema: z.ZodObject<{
+    profileId: z.ZodString;
+    query: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    profileId: string;
+    limit: number;
+    query?: string | undefined;
+}, {
+    profileId: string;
+    query?: string | undefined;
+    limit?: number | undefined;
+}>;
+export declare const SearchTargetingOutputSchema: z.ZodObject<{
+    results: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">;
+    count: z.ZodNumber;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    timestamp: string;
+    results: Record<string, any>[];
+    count: number;
+}, {
+    timestamp: string;
+    results: Record<string, any>[];
+    count: number;
+}>;
+type SearchTargetingInput = z.infer<typeof SearchTargetingInputSchema>;
+type SearchTargetingOutput = z.infer<typeof SearchTargetingOutputSchema>;
+export declare function searchTargetingLogic(input: SearchTargetingInput, context: RequestContext, sdkContext?: SdkContext): Promise<SearchTargetingOutput>;
+export declare function searchTargetingResponseFormatter(result: SearchTargetingOutput): McpTextContent[];
+export declare const searchTargetingTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        profileId: z.ZodString;
+        query: z.ZodOptional<z.ZodString>;
+        limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, "strip", z.ZodTypeAny, {
+        profileId: string;
+        limit: number;
+        query?: string | undefined;
+    }, {
+        profileId: string;
+        query?: string | undefined;
+        limit?: number | undefined;
+    }>;
+    outputSchema: z.ZodObject<{
+        results: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">;
+        count: z.ZodNumber;
+        timestamp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        timestamp: string;
+        results: Record<string, any>[];
+        count: number;
+    }, {
+        timestamp: string;
+        results: Record<string, any>[];
+        count: number;
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        idempotentHint: boolean;
+        destructiveHint: boolean;
+    };
+    inputExamples: ({
+        label: string;
+        input: {
+            profileId: string;
+            query: string;
+            limit: number;
+        };
+    } | {
+        label: string;
+        input: {
+            profileId: string;
+            limit: number;
+            query?: undefined;
+        };
+    })[];
+    logic: typeof searchTargetingLogic;
+    responseFormatter: typeof searchTargetingResponseFormatter;
+};
+export {};
+//# sourceMappingURL=search-targeting.tool.d.ts.map

package/dist/mcp-server/tools/definitions/search-targeting.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-targeting.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-targeting.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;AAcnD,eAAO,MAAM,0BAA0B;;;;;;;;;;;;EAmB6B,CAAC;AAErE,eAAO,MAAM,2BAA2B;;;;;;;;;;;;EAMK,CAAC;AAE9C,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,KAAK,EAAE,oBAAoB,EAC3B,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,qBAAqB,CAAC,CAkBhC;AAED,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,qBAAqB,GAAG,cAAc,EAAE,CAOhG;AAED,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+B/B,CAAC"}