@cesteral/linkedin-mcp 1.0.0

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

@@ -0,0 +1,325 @@
+import { z } from "zod";
+import type { RequestContext, McpTextContent } from "@cesteral/shared";
+import type { SdkContext } from "@cesteral/shared";
+export declare const GetAnalyticsInputSchema: 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>;
+    metrics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    pivot: z.ZodOptional<z.ZodString>;
+    timeGranularity: z.ZodOptional<z.ZodEnum<["DAILY", "MONTHLY", "YEARLY", "ALL"]>>;
+} & {
+    mode: z.ZodDefault<z.ZodOptional<z.ZodEnum<["summary", "rows"]>>>;
+    columns: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    offset: z.ZodOptional<z.ZodNumber>;
+    maxRows: z.ZodOptional<z.ZodNumber>;
+    aggregateBy: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    aggregateMetrics: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<["sum", "avg", "count", "min", "max"]>>>;
+} & {
+    includeComputedMetrics: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    adAccountUrn: string;
+    mode: "summary" | "rows";
+    includeComputedMetrics: boolean;
+    pivot?: string | undefined;
+    timeGranularity?: "DAILY" | "MONTHLY" | "YEARLY" | "ALL" | undefined;
+    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;
+    columns?: string[] | undefined;
+    offset?: number | undefined;
+    maxRows?: number | undefined;
+    aggregateBy?: string[] | undefined;
+    aggregateMetrics?: Record<string, "count" | "sum" | "avg" | "min" | "max"> | undefined;
+}, {
+    adAccountUrn: string;
+    pivot?: string | undefined;
+    timeGranularity?: "DAILY" | "MONTHLY" | "YEARLY" | "ALL" | undefined;
+    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;
+    mode?: "summary" | "rows" | undefined;
+    columns?: string[] | undefined;
+    offset?: number | undefined;
+    maxRows?: number | undefined;
+    aggregateBy?: string[] | undefined;
+    aggregateMetrics?: Record<string, "count" | "sum" | "avg" | "min" | "max"> | undefined;
+    includeComputedMetrics?: boolean | undefined;
+}>, {
+    adAccountUrn: string;
+    mode: "summary" | "rows";
+    includeComputedMetrics: boolean;
+    pivot?: string | undefined;
+    timeGranularity?: "DAILY" | "MONTHLY" | "YEARLY" | "ALL" | undefined;
+    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;
+    columns?: string[] | undefined;
+    offset?: number | undefined;
+    maxRows?: number | undefined;
+    aggregateBy?: string[] | undefined;
+    aggregateMetrics?: Record<string, "count" | "sum" | "avg" | "min" | "max"> | undefined;
+}, {
+    adAccountUrn: string;
+    pivot?: string | undefined;
+    timeGranularity?: "DAILY" | "MONTHLY" | "YEARLY" | "ALL" | undefined;
+    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;
+    mode?: "summary" | "rows" | undefined;
+    columns?: string[] | undefined;
+    offset?: number | undefined;
+    maxRows?: number | undefined;
+    aggregateBy?: string[] | undefined;
+    aggregateMetrics?: Record<string, "count" | "sum" | "avg" | "min" | "max"> | undefined;
+    includeComputedMetrics?: boolean | undefined;
+}>;
+export declare const GetAnalyticsOutputSchema: z.ZodObject<{
+    totalRows: z.ZodNumber;
+    returnedRows: z.ZodNumber;
+    truncated: z.ZodBoolean;
+    nextOffset: z.ZodNullable<z.ZodNumber>;
+    headers: z.ZodArray<z.ZodString, "many">;
+    selectedColumns: z.ZodArray<z.ZodString, "many">;
+    mode: z.ZodEnum<["summary", "rows"]>;
+    previewRows: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">>;
+    rows: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">>;
+    warnings: z.ZodArray<z.ZodString, "many">;
+} & {
+    pivot: z.ZodString;
+    timeGranularity: z.ZodString;
+    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, {
+    pivot: string;
+    timeGranularity: string;
+    timestamp: string;
+    mode: "summary" | "rows";
+    dateRange: {
+        start: string;
+        end: string;
+    };
+    totalRows: number;
+    returnedRows: number;
+    truncated: boolean;
+    nextOffset: number | null;
+    headers: string[];
+    selectedColumns: string[];
+    warnings: string[];
+    rows?: Record<string, any>[] | undefined;
+    previewRows?: Record<string, any>[] | undefined;
+}, {
+    pivot: string;
+    timeGranularity: string;
+    timestamp: string;
+    mode: "summary" | "rows";
+    dateRange: {
+        start: string;
+        end: string;
+    };
+    totalRows: number;
+    returnedRows: number;
+    truncated: boolean;
+    nextOffset: number | null;
+    headers: string[];
+    selectedColumns: string[];
+    warnings: string[];
+    rows?: Record<string, any>[] | undefined;
+    previewRows?: Record<string, any>[] | undefined;
+}>;
+type GetAnalyticsInput = z.infer<typeof GetAnalyticsInputSchema>;
+type GetAnalyticsOutput = z.infer<typeof GetAnalyticsOutputSchema>;
+export declare function getAnalyticsLogic(input: GetAnalyticsInput, context: RequestContext, sdkContext?: SdkContext): Promise<GetAnalyticsOutput>;
+export declare function getAnalyticsResponseFormatter(result: GetAnalyticsOutput): McpTextContent[];
+export declare const getAnalyticsTool: {
+    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>;
+        metrics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        pivot: z.ZodOptional<z.ZodString>;
+        timeGranularity: z.ZodOptional<z.ZodEnum<["DAILY", "MONTHLY", "YEARLY", "ALL"]>>;
+    } & {
+        mode: z.ZodDefault<z.ZodOptional<z.ZodEnum<["summary", "rows"]>>>;
+        columns: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        offset: z.ZodOptional<z.ZodNumber>;
+        maxRows: z.ZodOptional<z.ZodNumber>;
+        aggregateBy: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        aggregateMetrics: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<["sum", "avg", "count", "min", "max"]>>>;
+    } & {
+        includeComputedMetrics: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        adAccountUrn: string;
+        mode: "summary" | "rows";
+        includeComputedMetrics: boolean;
+        pivot?: string | undefined;
+        timeGranularity?: "DAILY" | "MONTHLY" | "YEARLY" | "ALL" | undefined;
+        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;
+        columns?: string[] | undefined;
+        offset?: number | undefined;
+        maxRows?: number | undefined;
+        aggregateBy?: string[] | undefined;
+        aggregateMetrics?: Record<string, "count" | "sum" | "avg" | "min" | "max"> | undefined;
+    }, {
+        adAccountUrn: string;
+        pivot?: string | undefined;
+        timeGranularity?: "DAILY" | "MONTHLY" | "YEARLY" | "ALL" | undefined;
+        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;
+        mode?: "summary" | "rows" | undefined;
+        columns?: string[] | undefined;
+        offset?: number | undefined;
+        maxRows?: number | undefined;
+        aggregateBy?: string[] | undefined;
+        aggregateMetrics?: Record<string, "count" | "sum" | "avg" | "min" | "max"> | undefined;
+        includeComputedMetrics?: boolean | undefined;
+    }>, {
+        adAccountUrn: string;
+        mode: "summary" | "rows";
+        includeComputedMetrics: boolean;
+        pivot?: string | undefined;
+        timeGranularity?: "DAILY" | "MONTHLY" | "YEARLY" | "ALL" | undefined;
+        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;
+        columns?: string[] | undefined;
+        offset?: number | undefined;
+        maxRows?: number | undefined;
+        aggregateBy?: string[] | undefined;
+        aggregateMetrics?: Record<string, "count" | "sum" | "avg" | "min" | "max"> | undefined;
+    }, {
+        adAccountUrn: string;
+        pivot?: string | undefined;
+        timeGranularity?: "DAILY" | "MONTHLY" | "YEARLY" | "ALL" | undefined;
+        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;
+        mode?: "summary" | "rows" | undefined;
+        columns?: string[] | undefined;
+        offset?: number | undefined;
+        maxRows?: number | undefined;
+        aggregateBy?: string[] | undefined;
+        aggregateMetrics?: Record<string, "count" | "sum" | "avg" | "min" | "max"> | undefined;
+        includeComputedMetrics?: boolean | undefined;
+    }>;
+    outputSchema: z.ZodObject<{
+        totalRows: z.ZodNumber;
+        returnedRows: z.ZodNumber;
+        truncated: z.ZodBoolean;
+        nextOffset: z.ZodNullable<z.ZodNumber>;
+        headers: z.ZodArray<z.ZodString, "many">;
+        selectedColumns: z.ZodArray<z.ZodString, "many">;
+        mode: z.ZodEnum<["summary", "rows"]>;
+        previewRows: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">>;
+        rows: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">>;
+        warnings: z.ZodArray<z.ZodString, "many">;
+    } & {
+        pivot: z.ZodString;
+        timeGranularity: z.ZodString;
+        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, {
+        pivot: string;
+        timeGranularity: string;
+        timestamp: string;
+        mode: "summary" | "rows";
+        dateRange: {
+            start: string;
+            end: string;
+        };
+        totalRows: number;
+        returnedRows: number;
+        truncated: boolean;
+        nextOffset: number | null;
+        headers: string[];
+        selectedColumns: string[];
+        warnings: string[];
+        rows?: Record<string, any>[] | undefined;
+        previewRows?: Record<string, any>[] | undefined;
+    }, {
+        pivot: string;
+        timeGranularity: string;
+        timestamp: string;
+        mode: "summary" | "rows";
+        dateRange: {
+            start: string;
+            end: string;
+        };
+        totalRows: number;
+        returnedRows: number;
+        truncated: boolean;
+        nextOffset: number | null;
+        headers: string[];
+        selectedColumns: string[];
+        warnings: string[];
+        rows?: Record<string, any>[] | undefined;
+        previewRows?: Record<string, any>[] | undefined;
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        idempotentHint: boolean;
+        destructiveHint: boolean;
+    };
+    inputExamples: ({
+        label: string;
+        input: {
+            adAccountUrn: string;
+            datePreset: string;
+            metrics: string[];
+            pivot: string;
+            timeGranularity: string;
+            startDate?: undefined;
+            endDate?: undefined;
+        };
+    } | {
+        label: string;
+        input: {
+            adAccountUrn: string;
+            startDate: string;
+            endDate: string;
+            pivot: string;
+            timeGranularity: string;
+            datePreset?: undefined;
+            metrics?: undefined;
+        };
+    })[];
+    logic: typeof getAnalyticsLogic;
+    responseFormatter: typeof getAnalyticsResponseFormatter;
+};
+export {};
+//# sourceMappingURL=get-analytics.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-analytics.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-analytics.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAYxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAmBnD,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqCwB,CAAC;AAE7D,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQN,CAAC;AAEhC,KAAK,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACjE,KAAK,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAUnE,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,kBAAkB,CAAC,CAqD7B;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,EAAE,CAQ1F;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoC5B,CAAC"}

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

@@ -0,0 +1,154 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+import { appendComputedMetricsToRows, ComputedMetricsFlagSchema, createReportView, DATE_PRESET_VALUES, formatReportViewResponse, ReportViewInputSchema, ReportViewOutputSchema, resolveDatePreset, } from "@cesteral/shared";
+const TOOL_NAME = "linkedin_get_analytics";
+const TOOL_TITLE = "Get LinkedIn Ads Analytics";
+const TOOL_DESCRIPTION = `Get analytics metrics for a LinkedIn Ads account.
+
+Uses the LinkedIn /v2/adAnalytics endpoint with offset-based date ranges.
+
+**Available pivots:** CAMPAIGN, CAMPAIGN_GROUP, CREATIVE, MEMBER_COMPANY_SIZE,
+MEMBER_INDUSTRY, MEMBER_SENIORITY, MEMBER_JOB_TITLE, MEMBER_JOB_FUNCTION,
+MEMBER_COUNTRY, MEMBER_REGION
+
+**Available metrics:** impressions, clicks, costInUsd, conversions,
+externalWebsiteConversions, leadGenerationMailContactInfoShares, oneClickLeads,
+videoViews, videoCompletions, videoFirstQuartileCompletions,
+videoMidpointCompletions, videoThirdQuartileCompletions
+
+**timeGranularity values:** DAILY, MONTHLY, YEARLY, ALL`;
+export const GetAnalyticsInputSchema = 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)"),
+    metrics: z
+        .array(z.string())
+        .optional()
+        .describe("Metrics to retrieve (defaults to impressions, clicks, costInUsd, conversions)"),
+    pivot: z.string().optional().describe("Dimension to pivot on (default: CAMPAIGN)"),
+    timeGranularity: z
+        .enum(["DAILY", "MONTHLY", "YEARLY", "ALL"])
+        .optional()
+        .describe("Time granularity (default: DAILY)"),
+})
+    .merge(ReportViewInputSchema)
+    .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");
+export const GetAnalyticsOutputSchema = ReportViewOutputSchema.extend({
+    pivot: z.string().describe("Pivot dimension used"),
+    timeGranularity: z.string(),
+    dateRange: z.object({
+        start: z.string(),
+        end: z.string(),
+    }),
+    timestamp: z.string().datetime(),
+}).describe("Analytics result");
+const LINKEDIN_COMPUTED_METRIC_ALIASES = {
+    cost: ["costInUsd", "costInLocalCurrency"],
+    impressions: ["impressions"],
+    clicks: ["clicks"],
+    conversions: ["externalWebsiteConversions", "conversions", "oneClickLeads"],
+    conversionValue: ["conversionValueInLocalCurrency"],
+};
+export async function getAnalyticsLogic(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.getAnalytics(input.adAccountUrn, { start: resolvedStartDate, end: resolvedEndDate }, input.metrics, input.pivot, input.timeGranularity, context);
+    const rawElements = result.elements;
+    const stringRows = rawElements.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 augmented = input.includeComputedMetrics
+        ? appendComputedMetricsToRows(stringRows, LINKEDIN_COMPUTED_METRIC_ALIASES)
+        : stringRows;
+    const computedWarning = input.includeComputedMetrics
+        ? augmented[0]?._computedMetricsWarnings
+        : undefined;
+    const view = createReportView({
+        rows: augmented,
+        totalRows: augmented.length,
+        input,
+        warnings: computedWarning ? [`computed metrics: ${computedWarning}`] : undefined,
+    });
+    return {
+        ...view,
+        pivot: input.pivot ?? "CAMPAIGN",
+        timeGranularity: input.timeGranularity ?? "DAILY",
+        dateRange: { start: resolvedStartDate, end: resolvedEndDate },
+        timestamp: new Date().toISOString(),
+    };
+}
+export function getAnalyticsResponseFormatter(result) {
+    const header = `Analytics (${result.pivot}, ${result.timeGranularity})\nDate range: ${result.dateRange.start} to ${result.dateRange.end}`;
+    return [
+        {
+            type: "text",
+            text: `${header}\n\n${formatReportViewResponse(result, "Rows")}\n\nTimestamp: ${result.timestamp}`,
+        },
+    ];
+}
+export const getAnalyticsTool = {
+    name: TOOL_NAME,
+    title: TOOL_TITLE,
+    description: TOOL_DESCRIPTION,
+    inputSchema: GetAnalyticsInputSchema,
+    outputSchema: GetAnalyticsOutputSchema,
+    annotations: {
+        readOnlyHint: true,
+        openWorldHint: false,
+        idempotentHint: true,
+        destructiveHint: false,
+    },
+    inputExamples: [
+        {
+            label: "Get last 30 days campaign impressions and clicks",
+            input: {
+                adAccountUrn: "urn:li:sponsoredAccount:123456789",
+                datePreset: "LAST_30_DAYS",
+                metrics: ["impressions", "clicks", "costInUsd"],
+                pivot: "CAMPAIGN",
+                timeGranularity: "DAILY",
+            },
+        },
+        {
+            label: "Get monthly summary by campaign group",
+            input: {
+                adAccountUrn: "urn:li:sponsoredAccount:123456789",
+                startDate: "2026-01-01",
+                endDate: "2026-03-01",
+                pivot: "CAMPAIGN_GROUP",
+                timeGranularity: "MONTHLY",
+            },
+        },
+    ],
+    logic: getAnalyticsLogic,
+    responseFormatter: getAnalyticsResponseFormatter,
+};
+//# sourceMappingURL=get-analytics.tool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-analytics.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-analytics.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EACL,2BAA2B,EAC3B,yBAAyB,EACzB,gBAAgB,EAChB,kBAAkB,EAClB,wBAAwB,EACxB,qBAAqB,EACrB,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAI1B,MAAM,SAAS,GAAG,wBAAwB,CAAC;AAC3C,MAAM,UAAU,GAAG,4BAA4B,CAAC;AAChD,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;wDAa+B,CAAC;AAEzD,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC;KACrC,MAAM,CAAC;IACN,YAAY,EAAE,CAAC;SACZ,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,wDAAwD,CAAC;IACrE,UAAU,EAAE,CAAC;SACV,IAAI,CAAC,kBAAkB,CAAC;SACxB,QAAQ,EAAE;SACV,QAAQ,CAAC,6DAA6D,CAAC;IAC1E,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,KAAK,CAAC,qBAAqB,EAAE,mCAAmC,CAAC;SACjE,QAAQ,EAAE;SACV,QAAQ,CAAC,uEAAuE,CAAC;IACpF,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,KAAK,CAAC,qBAAqB,EAAE,mCAAmC,CAAC;SACjE,QAAQ,EAAE;SACV,QAAQ,CAAC,qEAAqE,CAAC;IAClF,OAAO,EAAE,CAAC;SACP,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,EAAE;SACV,QAAQ,CAAC,+EAA+E,CAAC;IAC5F,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;IAClF,eAAe,EAAE,CAAC;SACf,IAAI,CAAC,CAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;SAC3C,QAAQ,EAAE;SACV,QAAQ,CAAC,mCAAmC,CAAC;CACjD,CAAC;KACD,KAAK,CAAC,qBAAqB,CAAC;KAC5B,KAAK,CAAC,yBAAyB,CAAC;KAChC,MAAM,CACL,CAAC,IAAI,EAAE,EAAE,CACP,IAAI,CAAC,UAAU,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,EAC/F,EAAE,OAAO,EAAE,yDAAyD,EAAE,CACvE;KACA,QAAQ,CAAC,+CAA+C,CAAC,CAAC;AAE7D,MAAM,CAAC,MAAM,wBAAwB,GAAG,sBAAsB,CAAC,MAAM,CAAC;IACpE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;IAClD,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE;IAC3B,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC;QAClB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;QACjB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;KAChB,CAAC;IACF,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC;AAKhC,MAAM,gCAAgC,GAAG;IACvC,IAAI,EAAE,CAAC,WAAW,EAAE,qBAAqB,CAAC;IAC1C,WAAW,EAAE,CAAC,aAAa,CAAC;IAC5B,MAAM,EAAE,CAAC,QAAQ,CAAC;IAClB,WAAW,EAAE,CAAC,4BAA4B,EAAE,aAAa,EAAE,eAAe,CAAC;IAC3E,eAAe,EAAE,CAAC,gCAAgC,CAAC;CACpD,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,KAAwB,EACxB,OAAuB,EACvB,UAAuB;IAEvB,MAAM,EAAE,wBAAwB,EAAE,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAExE,IAAI,iBAAiB,GAAG,KAAK,CAAC,SAAS,CAAC;IACxC,IAAI,eAAe,GAAG,KAAK,CAAC,OAAO,CAAC;IACpC,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QACrB,MAAM,QAAQ,GAAG,iBAAiB,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACrD,iBAAiB,GAAG,QAAQ,CAAC,SAAS,CAAC;QACvC,eAAe,GAAG,QAAQ,CAAC,OAAO,CAAC;IACrC,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,wBAAwB,CAAC,YAAY,CACxD,KAAK,CAAC,YAAY,EAClB,EAAE,KAAK,EAAE,iBAAkB,EAAE,GAAG,EAAE,eAAgB,EAAE,EACpD,KAAK,CAAC,OAAO,EACb,KAAK,CAAC,KAAK,EACX,KAAK,CAAC,eAAe,EACrB,OAAO,CACR,CAAC;IAKF,MAAM,WAAW,GAAG,MAAM,CAAC,QAAqC,CAAC;IACjE,MAAM,UAAU,GAA6B,WAAW,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACnE,MAAM,MAAM,GAA2B,EAAE,CAAC;QAC1C,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YACzC,MAAM,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QAC7E,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,KAAK,CAAC,sBAAsB;QAC5C,CAAC,CAAC,2BAA2B,CAAC,UAAU,EAAE,gCAAgC,CAAC;QAC3E,CAAC,CAAC,UAAU,CAAC;IACf,MAAM,eAAe,GAAG,KAAK,CAAC,sBAAsB;QAClD,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,wBAAwB;QACxC,CAAC,CAAC,SAAS,CAAC;IAEd,MAAM,IAAI,GAAG,gBAAgB,CAAC;QAC5B,IAAI,EAAE,SAAS;QACf,SAAS,EAAE,SAAS,CAAC,MAAM;QAC3B,KAAK;QACL,QAAQ,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC,qBAAqB,eAAe,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS;KACjF,CAAC,CAAC;IAEH,OAAO;QACL,GAAG,IAAI;QACP,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,UAAU;QAChC,eAAe,EAAE,KAAK,CAAC,eAAe,IAAI,OAAO;QACjD,SAAS,EAAE,EAAE,KAAK,EAAE,iBAAkB,EAAE,GAAG,EAAE,eAAgB,EAAE;QAC/D,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,MAA0B;IACtE,MAAM,MAAM,GAAG,cAAc,MAAM,CAAC,KAAK,KAAK,MAAM,CAAC,eAAe,kBAAkB,MAAM,CAAC,SAAS,CAAC,KAAK,OAAO,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC;IAC1I,OAAO;QACL;YACE,IAAI,EAAE,MAAe;YACrB,IAAI,EAAE,GAAG,MAAM,OAAO,wBAAwB,CAAC,MAAM,EAAE,MAAM,CAAC,kBAAkB,MAAM,CAAC,SAAS,EAAE;SACnG;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,UAAU;IACjB,WAAW,EAAE,gBAAgB;IAC7B,WAAW,EAAE,uBAAuB;IACpC,YAAY,EAAE,wBAAwB;IACtC,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,kDAAkD;YACzD,KAAK,EAAE;gBACL,YAAY,EAAE,mCAAmC;gBACjD,UAAU,EAAE,cAAc;gBAC1B,OAAO,EAAE,CAAC,aAAa,EAAE,QAAQ,EAAE,WAAW,CAAC;gBAC/C,KAAK,EAAE,UAAU;gBACjB,eAAe,EAAE,OAAO;aACzB;SACF;QACD;YACE,KAAK,EAAE,uCAAuC;YAC9C,KAAK,EAAE;gBACL,YAAY,EAAE,mCAAmC;gBACjD,SAAS,EAAE,YAAY;gBACvB,OAAO,EAAE,YAAY;gBACrB,KAAK,EAAE,gBAAgB;gBACvB,eAAe,EAAE,SAAS;aAC3B;SACF;KACF;IACD,KAAK,EAAE,iBAAiB;IACxB,iBAAiB,EAAE,6BAA6B;CACjD,CAAC"}

package/dist/mcp-server/tools/definitions/get-delivery-forecast.tool.d.ts

@@ -0,0 +1,95 @@
+import { z } from "zod";
+import type { RequestContext, McpTextContent } from "@cesteral/shared";
+import type { SdkContext } from "@cesteral/shared";
+export declare const GetDeliveryForecastInputSchema: z.ZodObject<{
+    adAccountUrn: z.ZodString;
+    targetingCriteria: z.ZodRecord<z.ZodString, z.ZodAny>;
+    optimizationTargetType: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    targetingCriteria: Record<string, any>;
+    adAccountUrn: string;
+    optimizationTargetType?: string | undefined;
+}, {
+    targetingCriteria: Record<string, any>;
+    adAccountUrn: string;
+    optimizationTargetType?: string | undefined;
+}>;
+export declare const GetDeliveryForecastOutputSchema: z.ZodObject<{
+    forecast: z.ZodRecord<z.ZodString, z.ZodAny>;
+    adAccountUrn: z.ZodString;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    adAccountUrn: string;
+    timestamp: string;
+    forecast: Record<string, any>;
+}, {
+    adAccountUrn: string;
+    timestamp: string;
+    forecast: Record<string, any>;
+}>;
+type GetDeliveryForecastInput = z.infer<typeof GetDeliveryForecastInputSchema>;
+type GetDeliveryForecastOutput = z.infer<typeof GetDeliveryForecastOutputSchema>;
+export declare function getDeliveryForecastLogic(input: GetDeliveryForecastInput, context: RequestContext, sdkContext?: SdkContext): Promise<GetDeliveryForecastOutput>;
+export declare function getDeliveryForecastResponseFormatter(result: GetDeliveryForecastOutput): McpTextContent[];
+export declare const getDeliveryForecastTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        adAccountUrn: z.ZodString;
+        targetingCriteria: z.ZodRecord<z.ZodString, z.ZodAny>;
+        optimizationTargetType: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        targetingCriteria: Record<string, any>;
+        adAccountUrn: string;
+        optimizationTargetType?: string | undefined;
+    }, {
+        targetingCriteria: Record<string, any>;
+        adAccountUrn: string;
+        optimizationTargetType?: string | undefined;
+    }>;
+    outputSchema: z.ZodObject<{
+        forecast: z.ZodRecord<z.ZodString, z.ZodAny>;
+        adAccountUrn: z.ZodString;
+        timestamp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        adAccountUrn: string;
+        timestamp: string;
+        forecast: Record<string, any>;
+    }, {
+        adAccountUrn: string;
+        timestamp: string;
+        forecast: Record<string, any>;
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        idempotentHint: boolean;
+        destructiveHint: boolean;
+    };
+    inputExamples: {
+        label: string;
+        input: {
+            adAccountUrn: string;
+            targetingCriteria: {
+                include: {
+                    and: ({
+                        or: {
+                            "urn:li:adTargetingFacet:geos": string[];
+                            "urn:li:adTargetingFacet:memberSeniorities"?: undefined;
+                        };
+                    } | {
+                        or: {
+                            "urn:li:adTargetingFacet:memberSeniorities": string[];
+                            "urn:li:adTargetingFacet:geos"?: undefined;
+                        };
+                    })[];
+                };
+            };
+        };
+    }[];
+    logic: typeof getDeliveryForecastLogic;
+    responseFormatter: typeof getDeliveryForecastResponseFormatter;
+};
+export {};
+//# sourceMappingURL=get-delivery-forecast.tool.d.ts.map

package/dist/mcp-server/tools/definitions/get-delivery-forecast.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-delivery-forecast.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-delivery-forecast.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;AAWnD,eAAO,MAAM,8BAA8B;;;;;;;;;;;;EAYuB,CAAC;AAEnE,eAAO,MAAM,+BAA+B;;;;;;;;;;;;EAML,CAAC;AAExC,KAAK,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAC/E,KAAK,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAEjF,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,wBAAwB,EAC/B,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,yBAAyB,CAAC,CAepC;AAED,wBAAgB,oCAAoC,CAClD,MAAM,EAAE,yBAAyB,GAChC,cAAc,EAAE,CAOlB;AAED,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyCnC,CAAC"}