@cesteral/dbm-mcp 1.0.0

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

@@ -0,0 +1,89 @@
+import { z } from "zod";
+import type { RequestContext, McpTextContent } from "@cesteral/shared";
+import type { SdkContext, ToolDefinition } from "@cesteral/shared";
+export declare const GetCampaignDeliveryInputSchema: z.ZodObject<{
+    advertiserId: z.ZodString;
+    campaignId: z.ZodString;
+    startDate: z.ZodString;
+    endDate: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    advertiserId: string;
+    campaignId: string;
+    startDate: string;
+    endDate: string;
+}, {
+    advertiserId: string;
+    campaignId: string;
+    startDate: string;
+    endDate: string;
+}>;
+export declare const GetCampaignDeliveryOutputSchema: z.ZodObject<{
+    advertiserId: z.ZodString;
+    campaignId: z.ZodString;
+    dateRange: z.ZodObject<{
+        startDate: z.ZodString;
+        endDate: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        startDate: string;
+        endDate: string;
+    }, {
+        startDate: string;
+        endDate: string;
+    }>;
+    metrics: z.ZodObject<{
+        impressions: z.ZodNumber;
+        clicks: z.ZodNumber;
+        spend: z.ZodNumber;
+        conversions: z.ZodNumber;
+        revenue: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        impressions: number;
+        clicks: number;
+        spend: number;
+        conversions: number;
+        revenue: number;
+    }, {
+        impressions: number;
+        clicks: number;
+        spend: number;
+        conversions: number;
+        revenue: number;
+    }>;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    advertiserId: string;
+    metrics: {
+        impressions: number;
+        clicks: number;
+        spend: number;
+        conversions: number;
+        revenue: number;
+    };
+    campaignId: string;
+    dateRange: {
+        startDate: string;
+        endDate: string;
+    };
+    timestamp: string;
+}, {
+    advertiserId: string;
+    metrics: {
+        impressions: number;
+        clicks: number;
+        spend: number;
+        conversions: number;
+        revenue: number;
+    };
+    campaignId: string;
+    dateRange: {
+        startDate: string;
+        endDate: string;
+    };
+    timestamp: string;
+}>;
+export type GetCampaignDeliveryInput = z.infer<typeof GetCampaignDeliveryInputSchema>;
+export type GetCampaignDeliveryOutput = z.infer<typeof GetCampaignDeliveryOutputSchema>;
+export declare function getCampaignDeliveryLogic(input: GetCampaignDeliveryInput, _context: RequestContext, sdkContext?: SdkContext): Promise<GetCampaignDeliveryOutput>;
+export declare function getCampaignDeliveryResponseFormatter(result: GetCampaignDeliveryOutput, input: GetCampaignDeliveryInput): McpTextContent[];
+export declare const getCampaignDeliveryTool: ToolDefinition<typeof GetCampaignDeliveryInputSchema, typeof GetCampaignDeliveryOutputSchema>;
+//# sourceMappingURL=get-campaign-delivery.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-campaign-delivery.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-campaign-delivery.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,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAWnE,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;EAaqB,CAAC;AAKjE,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiBG,CAAC;AAEhD,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AACtF,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAKxF,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,wBAAwB,EAC/B,QAAQ,EAAE,cAAc,EACxB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,yBAAyB,CAAC,CA4BpC;AAOD,wBAAgB,oCAAoC,CAClD,MAAM,EAAE,yBAAyB,EACjC,KAAK,EAAE,wBAAwB,GAC9B,cAAc,EAAE,CAqBlB;AAKD,eAAO,MAAM,uBAAuB,EAAE,cAAc,CAClD,OAAO,8BAA8B,EACrC,OAAO,+BAA+B,CA4CvC,CAAC"}

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

@@ -0,0 +1,128 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+import { calculateCTR, calculateCPM, formatMetricValue } from "../../../utils/metrics.js";
+const TOOL_NAME = "dbm_get_campaign_delivery";
+const TOOL_TITLE = "Get Campaign Delivery";
+const TOOL_DESCRIPTION = "Fetch DV360 delivery metrics (impressions, clicks, spend, conversions) for a campaign within a date range via Bid Manager API";
+export const GetCampaignDeliveryInputSchema = z
+    .object({
+    advertiserId: z.string().min(1).describe("DV360 Advertiser ID"),
+    campaignId: z.string().min(1).describe("DV360 Campaign ID to fetch delivery metrics for"),
+    startDate: z
+        .string()
+        .regex(/^\d{4}-\d{2}-\d{2}$/, "Date must be in YYYY-MM-DD format")
+        .describe("Start date in YYYY-MM-DD format"),
+    endDate: z
+        .string()
+        .regex(/^\d{4}-\d{2}-\d{2}$/, "Date must be in YYYY-MM-DD format")
+        .describe("End date in YYYY-MM-DD format"),
+})
+    .describe("Parameters for fetching campaign delivery metrics");
+export const GetCampaignDeliveryOutputSchema = z
+    .object({
+    advertiserId: z.string(),
+    campaignId: z.string(),
+    dateRange: z.object({
+        startDate: z.string(),
+        endDate: z.string(),
+    }),
+    metrics: z.object({
+        impressions: z.number(),
+        clicks: z.number(),
+        spend: z.number(),
+        conversions: z.number(),
+        revenue: z.number(),
+    }),
+    timestamp: z.string().datetime(),
+})
+    .describe("Campaign delivery metrics result");
+export async function getCampaignDeliveryLogic(input, _context, sdkContext) {
+    const { bidManagerService } = resolveSessionServices(sdkContext);
+    const metrics = await bidManagerService.getDeliveryMetrics({
+        advertiserId: input.advertiserId,
+        campaignId: input.campaignId,
+        startDate: input.startDate,
+        endDate: input.endDate,
+    });
+    return {
+        advertiserId: input.advertiserId,
+        campaignId: input.campaignId,
+        dateRange: {
+            startDate: input.startDate,
+            endDate: input.endDate,
+        },
+        metrics: {
+            impressions: metrics.impressions,
+            clicks: metrics.clicks,
+            spend: metrics.spend,
+            conversions: metrics.conversions,
+            revenue: metrics.revenue,
+        },
+        timestamp: new Date().toISOString(),
+    };
+}
+export function getCampaignDeliveryResponseFormatter(result, input) {
+    const ctr = calculateCTR(result.metrics.clicks, result.metrics.impressions);
+    const cpm = calculateCPM(result.metrics.spend, result.metrics.impressions);
+    return [
+        {
+            type: "text",
+            text: `Campaign ${input.campaignId} Delivery (${input.startDate} to ${input.endDate}):
+
+Delivery Metrics:
+- Impressions: ${result.metrics.impressions.toLocaleString()}
+- Clicks: ${result.metrics.clicks.toLocaleString()}
+- CTR: ${formatMetricValue("ctr", ctr)}
+- Spend: $${result.metrics.spend.toFixed(2)}
+- CPM: ${formatMetricValue("cpm", cpm)}
+- Conversions: ${result.metrics.conversions}
+- Revenue: $${result.metrics.revenue.toFixed(2)}
+`,
+        },
+    ];
+}
+export const getCampaignDeliveryTool = {
+    name: TOOL_NAME,
+    title: TOOL_TITLE,
+    description: TOOL_DESCRIPTION,
+    inputSchema: GetCampaignDeliveryInputSchema,
+    outputSchema: GetCampaignDeliveryOutputSchema,
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        openWorldHint: false,
+        idempotentHint: true,
+    },
+    inputExamples: [
+        {
+            label: "Fetch last month's delivery for a campaign",
+            input: {
+                advertiserId: "1234567",
+                campaignId: "9876543",
+                startDate: "2026-01-01",
+                endDate: "2026-01-31",
+            },
+        },
+        {
+            label: "Fetch delivery for a short campaign burst",
+            input: {
+                advertiserId: "7654321",
+                campaignId: "1122334",
+                startDate: "2026-02-10",
+                endDate: "2026-02-17",
+            },
+        },
+        {
+            label: "Fetch Q4 delivery for a large advertiser campaign",
+            input: {
+                advertiserId: "9988776",
+                campaignId: "5544332",
+                startDate: "2025-10-01",
+                endDate: "2025-12-31",
+            },
+        },
+    ],
+    logic: getCampaignDeliveryLogic,
+    responseFormatter: getCampaignDeliveryResponseFormatter,
+};
+//# sourceMappingURL=get-campaign-delivery.tool.js.map

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

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

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

@@ -0,0 +1,155 @@
+import { z } from "zod";
+import type { RequestContext, McpTextContent } from "@cesteral/shared";
+import type { SdkContext, ToolDefinition } from "@cesteral/shared";
+export declare const GetHistoricalMetricsInputSchema: z.ZodObject<{
+    advertiserId: z.ZodString;
+    campaignId: z.ZodString;
+    startDate: z.ZodString;
+    endDate: z.ZodString;
+    granularity: z.ZodDefault<z.ZodEnum<["daily", "weekly", "monthly"]>>;
+}, "strip", z.ZodTypeAny, {
+    advertiserId: string;
+    campaignId: string;
+    startDate: string;
+    endDate: string;
+    granularity: "daily" | "weekly" | "monthly";
+}, {
+    advertiserId: string;
+    campaignId: string;
+    startDate: string;
+    endDate: string;
+    granularity?: "daily" | "weekly" | "monthly" | undefined;
+}>;
+export declare const GetHistoricalMetricsOutputSchema: z.ZodObject<{
+    advertiserId: z.ZodString;
+    campaignId: z.ZodString;
+    dateRange: z.ZodObject<{
+        startDate: z.ZodString;
+        endDate: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        startDate: string;
+        endDate: string;
+    }, {
+        startDate: string;
+        endDate: string;
+    }>;
+    granularity: z.ZodEnum<["daily", "weekly", "monthly"]>;
+    timeSeries: z.ZodArray<z.ZodObject<{
+        date: z.ZodString;
+        metrics: z.ZodObject<{
+            impressions: z.ZodNumber;
+            clicks: z.ZodNumber;
+            spend: z.ZodNumber;
+            conversions: z.ZodNumber;
+            revenue: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            impressions: number;
+            clicks: number;
+            spend: number;
+            conversions: number;
+            revenue: number;
+        }, {
+            impressions: number;
+            clicks: number;
+            spend: number;
+            conversions: number;
+            revenue: number;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        date: string;
+        metrics: {
+            impressions: number;
+            clicks: number;
+            spend: number;
+            conversions: number;
+            revenue: number;
+        };
+    }, {
+        date: string;
+        metrics: {
+            impressions: number;
+            clicks: number;
+            spend: number;
+            conversions: number;
+            revenue: number;
+        };
+    }>, "many">;
+    summary: z.ZodObject<{
+        totalImpressions: z.ZodNumber;
+        totalClicks: z.ZodNumber;
+        totalSpend: z.ZodNumber;
+        totalConversions: z.ZodNumber;
+        dataPoints: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        dataPoints: number;
+        totalImpressions: number;
+        totalClicks: number;
+        totalSpend: number;
+        totalConversions: number;
+    }, {
+        dataPoints: number;
+        totalImpressions: number;
+        totalClicks: number;
+        totalSpend: number;
+        totalConversions: number;
+    }>;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    advertiserId: string;
+    campaignId: string;
+    granularity: "daily" | "weekly" | "monthly";
+    dateRange: {
+        startDate: string;
+        endDate: string;
+    };
+    timestamp: string;
+    timeSeries: {
+        date: string;
+        metrics: {
+            impressions: number;
+            clicks: number;
+            spend: number;
+            conversions: number;
+            revenue: number;
+        };
+    }[];
+    summary: {
+        dataPoints: number;
+        totalImpressions: number;
+        totalClicks: number;
+        totalSpend: number;
+        totalConversions: number;
+    };
+}, {
+    advertiserId: string;
+    campaignId: string;
+    granularity: "daily" | "weekly" | "monthly";
+    dateRange: {
+        startDate: string;
+        endDate: string;
+    };
+    timestamp: string;
+    timeSeries: {
+        date: string;
+        metrics: {
+            impressions: number;
+            clicks: number;
+            spend: number;
+            conversions: number;
+            revenue: number;
+        };
+    }[];
+    summary: {
+        dataPoints: number;
+        totalImpressions: number;
+        totalClicks: number;
+        totalSpend: number;
+        totalConversions: number;
+    };
+}>;
+export type GetHistoricalMetricsInput = z.infer<typeof GetHistoricalMetricsInputSchema>;
+export type GetHistoricalMetricsOutput = z.infer<typeof GetHistoricalMetricsOutputSchema>;
+export declare function getHistoricalMetricsLogic(input: GetHistoricalMetricsInput, _context: RequestContext, sdkContext?: SdkContext): Promise<GetHistoricalMetricsOutput>;
+export declare function getHistoricalMetricsResponseFormatter(result: GetHistoricalMetricsOutput, input: GetHistoricalMetricsInput): McpTextContent[];
+export declare const getHistoricalMetricsTool: ToolDefinition<typeof GetHistoricalMetricsInputSchema, typeof GetHistoricalMetricsOutputSchema>;
+//# sourceMappingURL=get-historical-metrics.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-historical-metrics.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-historical-metrics.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,cAAc,EAAE,MAAM,kBAAkB,CAAC;AASnE,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;EAiBa,CAAC;AAK1D,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8BO,CAAC;AAErD,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AACxF,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAK1F,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,yBAAyB,EAChC,QAAQ,EAAE,cAAc,EACxB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,0BAA0B,CAAC,CAiDrC;AAKD,wBAAgB,qCAAqC,CACnD,MAAM,EAAE,0BAA0B,EAClC,KAAK,EAAE,yBAAyB,GAC/B,cAAc,EAAE,CAwBlB;AAKD,eAAO,MAAM,wBAAwB,EAAE,cAAc,CACnD,OAAO,+BAA+B,EACtC,OAAO,gCAAgC,CA+CxC,CAAC"}

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

@@ -0,0 +1,160 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+const TOOL_NAME = "dbm_get_historical_metrics";
+const TOOL_TITLE = "Get Historical Metrics";
+const TOOL_DESCRIPTION = "Fetch time-series historical metrics for trend analysis";
+export const GetHistoricalMetricsInputSchema = z
+    .object({
+    advertiserId: z.string().min(1).describe("DV360 Advertiser ID"),
+    campaignId: z.string().min(1).describe("The campaign ID to fetch historical data for"),
+    startDate: z
+        .string()
+        .regex(/^\d{4}-\d{2}-\d{2}$/, "Date must be in YYYY-MM-DD format")
+        .describe("Start date in YYYY-MM-DD format"),
+    endDate: z
+        .string()
+        .regex(/^\d{4}-\d{2}-\d{2}$/, "Date must be in YYYY-MM-DD format")
+        .describe("End date in YYYY-MM-DD format"),
+    granularity: z
+        .enum(["daily", "weekly", "monthly"])
+        .default("daily")
+        .describe("Time series granularity (default: daily)"),
+})
+    .describe("Parameters for fetching historical metrics");
+export const GetHistoricalMetricsOutputSchema = z
+    .object({
+    advertiserId: z.string(),
+    campaignId: z.string(),
+    dateRange: z.object({
+        startDate: z.string(),
+        endDate: z.string(),
+    }),
+    granularity: z.enum(["daily", "weekly", "monthly"]),
+    timeSeries: z.array(z.object({
+        date: z.string(),
+        metrics: z.object({
+            impressions: z.number(),
+            clicks: z.number(),
+            spend: z.number(),
+            conversions: z.number(),
+            revenue: z.number(),
+        }),
+    })),
+    summary: z.object({
+        totalImpressions: z.number(),
+        totalClicks: z.number(),
+        totalSpend: z.number(),
+        totalConversions: z.number(),
+        dataPoints: z.number(),
+    }),
+    timestamp: z.string().datetime(),
+})
+    .describe("Historical metrics time-series result");
+export async function getHistoricalMetricsLogic(input, _context, sdkContext) {
+    const { bidManagerService } = resolveSessionServices(sdkContext);
+    const historicalData = await bidManagerService.getHistoricalMetrics({
+        advertiserId: input.advertiserId,
+        campaignId: input.campaignId,
+        startDate: input.startDate,
+        endDate: input.endDate,
+        granularity: input.granularity,
+    });
+    const timeSeries = historicalData.map((point) => ({
+        date: point.date,
+        metrics: {
+            impressions: point.metrics.impressions,
+            clicks: point.metrics.clicks,
+            spend: point.metrics.spend,
+            conversions: point.metrics.conversions,
+            revenue: point.metrics.revenue,
+        },
+    }));
+    const summary = timeSeries.reduce((acc, point) => ({
+        totalImpressions: acc.totalImpressions + point.metrics.impressions,
+        totalClicks: acc.totalClicks + point.metrics.clicks,
+        totalSpend: acc.totalSpend + point.metrics.spend,
+        totalConversions: acc.totalConversions + point.metrics.conversions,
+        dataPoints: acc.dataPoints + 1,
+    }), { totalImpressions: 0, totalClicks: 0, totalSpend: 0, totalConversions: 0, dataPoints: 0 });
+    return {
+        advertiserId: input.advertiserId,
+        campaignId: input.campaignId,
+        dateRange: {
+            startDate: input.startDate,
+            endDate: input.endDate,
+        },
+        granularity: input.granularity,
+        timeSeries,
+        summary,
+        timestamp: new Date().toISOString(),
+    };
+}
+export function getHistoricalMetricsResponseFormatter(result, input) {
+    const trendsText = result.timeSeries
+        .slice(0, 5)
+        .map((point) => `  ${point.date}: ${point.metrics.impressions.toLocaleString()} impr, $${point.metrics.spend.toFixed(2)} spend`)
+        .join("\n");
+    return [
+        {
+            type: "text",
+            text: `Campaign ${input.campaignId} Historical Metrics (${input.startDate} to ${input.endDate}):
+
+Summary (${result.summary.dataPoints} data points, ${result.granularity}):
+• Total Impressions: ${result.summary.totalImpressions.toLocaleString()}
+• Total Clicks: ${result.summary.totalClicks.toLocaleString()}
+• Total Spend: $${result.summary.totalSpend.toFixed(2)}
+• Total Conversions: ${result.summary.totalConversions}
+
+Trend (first 5 periods):
+${trendsText}`,
+        },
+    ];
+}
+export const getHistoricalMetricsTool = {
+    name: TOOL_NAME,
+    title: TOOL_TITLE,
+    description: TOOL_DESCRIPTION,
+    inputSchema: GetHistoricalMetricsInputSchema,
+    outputSchema: GetHistoricalMetricsOutputSchema,
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        openWorldHint: false,
+        idempotentHint: true,
+    },
+    inputExamples: [
+        {
+            label: "Daily trend over the past 30 days",
+            input: {
+                advertiserId: "1234567",
+                campaignId: "9876543",
+                startDate: "2026-01-01",
+                endDate: "2026-01-31",
+                granularity: "daily",
+            },
+        },
+        {
+            label: "Weekly trend over a quarter",
+            input: {
+                advertiserId: "7654321",
+                campaignId: "1122334",
+                startDate: "2025-10-01",
+                endDate: "2025-12-31",
+                granularity: "weekly",
+            },
+        },
+        {
+            label: "Monthly trend over a full year",
+            input: {
+                advertiserId: "9988776",
+                campaignId: "5544332",
+                startDate: "2025-01-01",
+                endDate: "2025-12-31",
+                granularity: "monthly",
+            },
+        },
+    ],
+    logic: getHistoricalMetricsLogic,
+    responseFormatter: getHistoricalMetricsResponseFormatter,
+};
+//# sourceMappingURL=get-historical-metrics.tool.js.map

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

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