@cesteral/linkedin-mcp 1.0.0

package/dist/mcp-server/tools/definitions/get-ad-previews.tool.js

@@ -0,0 +1,71 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+const TOOL_NAME = "linkedin_get_ad_previews";
+const TOOL_TITLE = "Get LinkedIn Ads Ad Preview";
+const TOOL_DESCRIPTION = `Get a preview of a LinkedIn Ads creative.
+
+Returns preview rendering data for a creative URN.
+
+**adFormat values:** SINGLE_IMAGE_AD, VIDEO_AD, CAROUSEL_AD, TEXT_AD,
+SPOTLIGHT_AD, FOLLOWER_AD, MESSAGE_AD, CONVERSATION_AD`;
+export const GetAdPreviewsInputSchema = z
+    .object({
+    creativeUrn: z
+        .string()
+        .min(1)
+        .describe("The creative URN to preview (e.g., urn:li:sponsoredCreative:123)"),
+    adFormat: z
+        .string()
+        .optional()
+        .describe("Ad format for the preview (e.g., SINGLE_IMAGE_AD)"),
+})
+    .describe("Parameters for getting a LinkedIn ad preview");
+export const GetAdPreviewsOutputSchema = z
+    .object({
+    preview: z.record(z.any()).describe("Preview data from LinkedIn API"),
+    creativeUrn: z.string(),
+    timestamp: z.string().datetime(),
+})
+    .describe("Ad preview result");
+export async function getAdPreviewsLogic(input, context, sdkContext) {
+    const { linkedInService } = resolveSessionServices(sdkContext);
+    const preview = await linkedInService.getAdPreviews(input.creativeUrn, input.adFormat, context);
+    return {
+        preview: preview,
+        creativeUrn: input.creativeUrn,
+        timestamp: new Date().toISOString(),
+    };
+}
+export function getAdPreviewsResponseFormatter(result) {
+    return [
+        {
+            type: "text",
+            text: `Ad preview for ${result.creativeUrn}\n\n${JSON.stringify(result.preview, null, 2)}\n\nTimestamp: ${result.timestamp}`,
+        },
+    ];
+}
+export const getAdPreviewsTool = {
+    name: TOOL_NAME,
+    title: TOOL_TITLE,
+    description: TOOL_DESCRIPTION,
+    inputSchema: GetAdPreviewsInputSchema,
+    outputSchema: GetAdPreviewsOutputSchema,
+    annotations: {
+        readOnlyHint: true,
+        openWorldHint: false,
+        idempotentHint: true,
+        destructiveHint: false,
+    },
+    inputExamples: [
+        {
+            label: "Get preview for a creative",
+            input: {
+                creativeUrn: "urn:li:sponsoredCreative:123456789",
+                adFormat: "SINGLE_IMAGE_AD",
+            },
+        },
+    ],
+    logic: getAdPreviewsLogic,
+    responseFormatter: getAdPreviewsResponseFormatter,
+};
+//# sourceMappingURL=get-ad-previews.tool.js.map

package/dist/mcp-server/tools/definitions/get-ad-previews.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-ad-previews.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-ad-previews.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAIrE,MAAM,SAAS,GAAG,0BAA0B,CAAC;AAC7C,MAAM,UAAU,GAAG,6BAA6B,CAAC;AACjD,MAAM,gBAAgB,GAAG;;;;;uDAK8B,CAAC;AAExD,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC;KACtC,MAAM,CAAC;IACN,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,kEAAkE,CAAC;IAC/E,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,mDAAmD,CAAC;CACjE,CAAC;KACD,QAAQ,CAAC,8CAA8C,CAAC,CAAC;AAE5D,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC;KACvC,MAAM,CAAC;IACN,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAC,gCAAgC,CAAC;IACrE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC;KACD,QAAQ,CAAC,mBAAmB,CAAC,CAAC;AAKjC,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,KAAyB,EACzB,OAAuB,EACvB,UAAuB;IAEvB,MAAM,EAAE,eAAe,EAAE,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAE/D,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,aAAa,CACjD,KAAK,CAAC,WAAW,EACjB,KAAK,CAAC,QAAQ,EACd,OAAO,CACR,CAAC;IAEF,OAAO;QACL,OAAO,EAAE,OAAkC;QAC3C,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,MAA2B;IACxE,OAAO;QACL;YACE,IAAI,EAAE,MAAe;YACrB,IAAI,EAAE,kBAAkB,MAAM,CAAC,WAAW,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,kBAAkB,MAAM,CAAC,SAAS,EAAE;SAC7H;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,UAAU;IACjB,WAAW,EAAE,gBAAgB;IAC7B,WAAW,EAAE,wBAAwB;IACrC,YAAY,EAAE,yBAAyB;IACvC,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,4BAA4B;YACnC,KAAK,EAAE;gBACL,WAAW,EAAE,oCAAoC;gBACjD,QAAQ,EAAE,iBAAiB;aAC5B;SACF;KACF;IACD,KAAK,EAAE,kBAAkB;IACzB,iBAAiB,EAAE,8BAA8B;CAClD,CAAC"}

package/dist/mcp-server/tools/definitions/get-analytics-breakdowns.tool.d.ts

@@ -0,0 +1,223 @@
+import { z } from "zod";
+import type { RequestContext, McpTextContent } from "@cesteral/shared";
+import type { SdkContext } from "@cesteral/shared";
+export declare const GetAnalyticsBreakdownsInputSchema: z.ZodEffects<z.ZodObject<{
+    adAccountUrn: z.ZodString;
+    datePreset: z.ZodOptional<z.ZodEnum<["TODAY", "YESTERDAY", "LAST_7_DAYS", "LAST_14_DAYS", "LAST_30_DAYS", "THIS_MONTH", "LAST_MONTH", "LAST_90_DAYS"]>>;
+    startDate: z.ZodOptional<z.ZodString>;
+    endDate: z.ZodOptional<z.ZodString>;
+    pivots: z.ZodArray<z.ZodString, "many">;
+    metrics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+} & {
+    includeComputedMetrics: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    adAccountUrn: string;
+    includeComputedMetrics: boolean;
+    pivots: string[];
+    datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
+    startDate?: string | undefined;
+    endDate?: string | undefined;
+    metrics?: string[] | undefined;
+}, {
+    adAccountUrn: string;
+    pivots: string[];
+    datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
+    startDate?: string | undefined;
+    endDate?: string | undefined;
+    metrics?: string[] | undefined;
+    includeComputedMetrics?: boolean | undefined;
+}>, {
+    adAccountUrn: string;
+    includeComputedMetrics: boolean;
+    pivots: string[];
+    datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
+    startDate?: string | undefined;
+    endDate?: string | undefined;
+    metrics?: string[] | undefined;
+}, {
+    adAccountUrn: string;
+    pivots: string[];
+    datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
+    startDate?: string | undefined;
+    endDate?: string | undefined;
+    metrics?: string[] | undefined;
+    includeComputedMetrics?: boolean | undefined;
+}>;
+export declare const GetAnalyticsBreakdownsOutputSchema: z.ZodObject<{
+    results: z.ZodArray<z.ZodObject<{
+        pivot: z.ZodString;
+        elements: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">;
+        count: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        count: number;
+        pivot: string;
+        elements: Record<string, any>[];
+    }, {
+        count: number;
+        pivot: string;
+        elements: Record<string, any>[];
+    }>, "many">;
+    dateRange: z.ZodObject<{
+        start: z.ZodString;
+        end: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        start: string;
+        end: string;
+    }, {
+        start: string;
+        end: string;
+    }>;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    results: {
+        count: number;
+        pivot: string;
+        elements: Record<string, any>[];
+    }[];
+    timestamp: string;
+    dateRange: {
+        start: string;
+        end: string;
+    };
+}, {
+    results: {
+        count: number;
+        pivot: string;
+        elements: Record<string, any>[];
+    }[];
+    timestamp: string;
+    dateRange: {
+        start: string;
+        end: string;
+    };
+}>;
+type GetAnalyticsBreakdownsInput = z.infer<typeof GetAnalyticsBreakdownsInputSchema>;
+type GetAnalyticsBreakdownsOutput = z.infer<typeof GetAnalyticsBreakdownsOutputSchema>;
+export declare function getAnalyticsBreakdownsLogic(input: GetAnalyticsBreakdownsInput, context: RequestContext, sdkContext?: SdkContext): Promise<GetAnalyticsBreakdownsOutput>;
+export declare function getAnalyticsBreakdownsResponseFormatter(result: GetAnalyticsBreakdownsOutput): McpTextContent[];
+export declare const getAnalyticsBreakdownsTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodEffects<z.ZodObject<{
+        adAccountUrn: z.ZodString;
+        datePreset: z.ZodOptional<z.ZodEnum<["TODAY", "YESTERDAY", "LAST_7_DAYS", "LAST_14_DAYS", "LAST_30_DAYS", "THIS_MONTH", "LAST_MONTH", "LAST_90_DAYS"]>>;
+        startDate: z.ZodOptional<z.ZodString>;
+        endDate: z.ZodOptional<z.ZodString>;
+        pivots: z.ZodArray<z.ZodString, "many">;
+        metrics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    } & {
+        includeComputedMetrics: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        adAccountUrn: string;
+        includeComputedMetrics: boolean;
+        pivots: string[];
+        datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
+        startDate?: string | undefined;
+        endDate?: string | undefined;
+        metrics?: string[] | undefined;
+    }, {
+        adAccountUrn: string;
+        pivots: string[];
+        datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
+        startDate?: string | undefined;
+        endDate?: string | undefined;
+        metrics?: string[] | undefined;
+        includeComputedMetrics?: boolean | undefined;
+    }>, {
+        adAccountUrn: string;
+        includeComputedMetrics: boolean;
+        pivots: string[];
+        datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
+        startDate?: string | undefined;
+        endDate?: string | undefined;
+        metrics?: string[] | undefined;
+    }, {
+        adAccountUrn: string;
+        pivots: string[];
+        datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
+        startDate?: string | undefined;
+        endDate?: string | undefined;
+        metrics?: string[] | undefined;
+        includeComputedMetrics?: boolean | undefined;
+    }>;
+    outputSchema: z.ZodObject<{
+        results: z.ZodArray<z.ZodObject<{
+            pivot: z.ZodString;
+            elements: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">;
+            count: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            count: number;
+            pivot: string;
+            elements: Record<string, any>[];
+        }, {
+            count: number;
+            pivot: string;
+            elements: Record<string, any>[];
+        }>, "many">;
+        dateRange: z.ZodObject<{
+            start: z.ZodString;
+            end: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            start: string;
+            end: string;
+        }, {
+            start: string;
+            end: string;
+        }>;
+        timestamp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        results: {
+            count: number;
+            pivot: string;
+            elements: Record<string, any>[];
+        }[];
+        timestamp: string;
+        dateRange: {
+            start: string;
+            end: string;
+        };
+    }, {
+        results: {
+            count: number;
+            pivot: string;
+            elements: Record<string, any>[];
+        }[];
+        timestamp: string;
+        dateRange: {
+            start: string;
+            end: string;
+        };
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        idempotentHint: boolean;
+        destructiveHint: boolean;
+    };
+    inputExamples: ({
+        label: string;
+        input: {
+            adAccountUrn: string;
+            datePreset: string;
+            pivots: string[];
+            metrics: string[];
+            startDate?: undefined;
+            endDate?: undefined;
+        };
+    } | {
+        label: string;
+        input: {
+            adAccountUrn: string;
+            startDate: string;
+            endDate: string;
+            pivots: string[];
+            datePreset?: undefined;
+            metrics?: undefined;
+        };
+    })[];
+    logic: typeof getAnalyticsBreakdownsLogic;
+    responseFormatter: typeof getAnalyticsBreakdownsResponseFormatter;
+};
+export {};
+//# sourceMappingURL=get-analytics-breakdowns.tool.d.ts.map

package/dist/mcp-server/tools/definitions/get-analytics-breakdowns.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-analytics-breakdowns.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-analytics-breakdowns.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,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmC8B,CAAC;AAE7E,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAcL,CAAC;AAE3C,KAAK,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AACrF,KAAK,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAC;AAEvF,wBAAsB,2BAA2B,CAC/C,KAAK,EAAE,2BAA2B,EAClC,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,4BAA4B,CAAC,CA0CvC;AAUD,wBAAgB,uCAAuC,CACrD,MAAM,EAAE,4BAA4B,GACnC,cAAc,EAAE,CAoBlB;AAED,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkCtC,CAAC"}

package/dist/mcp-server/tools/definitions/get-analytics-breakdowns.tool.js

@@ -0,0 +1,152 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+import { appendComputedMetricsToRows, ComputedMetricsFlagSchema, DATE_PRESET_VALUES, resolveDatePreset, } from "@cesteral/shared";
+const TOOL_NAME = "linkedin_get_analytics_breakdowns";
+const TOOL_TITLE = "Get LinkedIn Ads Analytics with Breakdowns";
+const TOOL_DESCRIPTION = `Get analytics with multiple dimensional breakdowns for a LinkedIn Ads account.
+
+Runs one analytics query per pivot and returns combined results.
+
+**Useful pivot combinations:**
+- CAMPAIGN + MEMBER_COUNTRY: campaign performance by geography
+- CAMPAIGN + MEMBER_JOB_TITLE: audience composition
+- CREATIVE + CAMPAIGN: creative performance within campaigns`;
+export const GetAnalyticsBreakdownsInputSchema = z
+    .object({
+    adAccountUrn: z
+        .string()
+        .min(1)
+        .describe("The ad account URN (e.g., urn:li:sponsoredAccount:123)"),
+    datePreset: z
+        .enum(DATE_PRESET_VALUES)
+        .optional()
+        .describe("Preset date range. Use this OR startDate+endDate (not both)"),
+    startDate: z
+        .string()
+        .regex(/^\d{4}-\d{2}-\d{2}$/, "Date must be in YYYY-MM-DD format")
+        .optional()
+        .describe("Start date in YYYY-MM-DD format (required if datePreset not provided)"),
+    endDate: z
+        .string()
+        .regex(/^\d{4}-\d{2}-\d{2}$/, "Date must be in YYYY-MM-DD format")
+        .optional()
+        .describe("End date in YYYY-MM-DD format (required if datePreset not provided)"),
+    pivots: z
+        .array(z.string())
+        .min(1)
+        .describe("Pivot dimensions to break down by (e.g., CAMPAIGN, MEMBER_COUNTRY)"),
+    metrics: z
+        .array(z.string())
+        .optional()
+        .describe("Metrics to retrieve (defaults to impressions, clicks, costInUsd)"),
+})
+    .merge(ComputedMetricsFlagSchema)
+    .refine((data) => data.datePreset !== undefined || (data.startDate !== undefined && data.endDate !== undefined), { message: "Provide either datePreset or both startDate and endDate" })
+    .describe("Parameters for getting LinkedIn Ads analytics with breakdowns");
+export const GetAnalyticsBreakdownsOutputSchema = z
+    .object({
+    results: z
+        .array(z.object({
+        pivot: z.string(),
+        elements: z.array(z.record(z.any())),
+        count: z.number(),
+    }))
+        .describe("Analytics results per pivot"),
+    dateRange: z.object({ start: z.string(), end: z.string() }),
+    timestamp: z.string().datetime(),
+})
+    .describe("Analytics breakdowns result");
+export async function getAnalyticsBreakdownsLogic(input, context, sdkContext) {
+    const { linkedInReportingService } = resolveSessionServices(sdkContext);
+    let resolvedStartDate = input.startDate;
+    let resolvedEndDate = input.endDate;
+    if (input.datePreset) {
+        const resolved = resolveDatePreset(input.datePreset);
+        resolvedStartDate = resolved.startDate;
+        resolvedEndDate = resolved.endDate;
+    }
+    const result = await linkedInReportingService.getAnalyticsBreakdowns(input.adAccountUrn, { start: resolvedStartDate, end: resolvedEndDate }, input.pivots, input.metrics, undefined, context);
+    return {
+        results: result.results.map((r) => {
+            const raw = r.elements;
+            const stringRows = raw.map((row) => {
+                const record = {};
+                for (const [k, v] of Object.entries(row)) {
+                    record[k] = typeof v === "string" ? v : v == null ? "" : JSON.stringify(v);
+                }
+                return record;
+            });
+            const elements = input.includeComputedMetrics
+                ? appendComputedMetricsToRows(stringRows, BREAKDOWNS_COMPUTED_METRIC_ALIASES)
+                : stringRows;
+            return {
+                pivot: r.pivot,
+                elements: elements,
+                count: elements.length,
+            };
+        }),
+        dateRange: { start: resolvedStartDate, end: resolvedEndDate },
+        timestamp: new Date().toISOString(),
+    };
+}
+const BREAKDOWNS_COMPUTED_METRIC_ALIASES = {
+    cost: ["costInUsd", "costInLocalCurrency"],
+    impressions: ["impressions"],
+    clicks: ["clicks"],
+    conversions: ["externalWebsiteConversions", "conversions", "oneClickLeads"],
+    conversionValue: ["conversionValueInLocalCurrency"],
+};
+export function getAnalyticsBreakdownsResponseFormatter(result) {
+    const lines = [
+        `Analytics Breakdowns — Date range: ${result.dateRange.start} to ${result.dateRange.end}`,
+        "",
+    ];
+    for (const r of result.results) {
+        lines.push(`## ${r.pivot} (${r.count} rows)`);
+        lines.push(JSON.stringify(r.elements, null, 2));
+        lines.push("");
+    }
+    lines.push(`Timestamp: ${result.timestamp}`);
+    return [
+        {
+            type: "text",
+            text: lines.join("\n"),
+        },
+    ];
+}
+export const getAnalyticsBreakdownsTool = {
+    name: TOOL_NAME,
+    title: TOOL_TITLE,
+    description: TOOL_DESCRIPTION,
+    inputSchema: GetAnalyticsBreakdownsInputSchema,
+    outputSchema: GetAnalyticsBreakdownsOutputSchema,
+    annotations: {
+        readOnlyHint: true,
+        openWorldHint: false,
+        idempotentHint: true,
+        destructiveHint: false,
+    },
+    inputExamples: [
+        {
+            label: "Get campaign + country breakdown for last 30 days",
+            input: {
+                adAccountUrn: "urn:li:sponsoredAccount:123456789",
+                datePreset: "LAST_30_DAYS",
+                pivots: ["CAMPAIGN", "MEMBER_COUNTRY"],
+                metrics: ["impressions", "clicks", "costInUsd"],
+            },
+        },
+        {
+            label: "Get creative performance breakdown",
+            input: {
+                adAccountUrn: "urn:li:sponsoredAccount:123456789",
+                startDate: "2026-01-01",
+                endDate: "2026-03-01",
+                pivots: ["CREATIVE"],
+            },
+        },
+    ],
+    logic: getAnalyticsBreakdownsLogic,
+    responseFormatter: getAnalyticsBreakdownsResponseFormatter,
+};
+//# sourceMappingURL=get-analytics-breakdowns.tool.js.map

package/dist/mcp-server/tools/definitions/get-analytics-breakdowns.tool.js.map

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