openai-ads-mcp 0.1.0

package/dist/tools/campaigns.js

@@ -0,0 +1,240 @@
+import { z } from "zod";
+import { badRequest, budgetGuard, coerceList, getClientOrError, handleApiError, isRecord, ok, optionalParams, usdToMicros, validateIntRange, validateNonEmpty, validateOption, validateUnixTime, } from "../core.js";
+const CAMPAIGN_STATES = new Set(["activate", "pause", "archive"]);
+const CAMPAIGN_STATUSES = new Set(["active", "paused", "archived"]);
+export function locationsPayload(locations) {
+    if (locations === undefined || locations === null)
+        return [null, null];
+    const [entries, error] = coerceList(locations, "locations");
+    if (error)
+        return [null, error];
+    const include = [];
+    for (const entry of entries ?? []) {
+        if (typeof entry === "string") {
+            include.push({ id: entry });
+        }
+        else if (isRecord(entry)) {
+            if (!entry.id)
+                return [null, badRequest("Each location object must include id.")];
+            include.push(entry);
+        }
+        else {
+            return [null, badRequest("locations must contain location ids or objects.")];
+        }
+    }
+    return [{ locations: { include } }, null];
+}
+export function buildCampaignBody(input) {
+    const body = {};
+    const create = input.create === true;
+    if (input.name !== undefined && input.name !== null) {
+        const error = validateNonEmpty("name", input.name, 3, 1000);
+        if (error)
+            return [null, error];
+        body.name = String(input.name).trim();
+    }
+    else if (create) {
+        return [null, badRequest("name is required.")];
+    }
+    const status = input.status ?? (create ? "paused" : undefined);
+    if (status !== undefined) {
+        if (!CAMPAIGN_STATUSES.has(status))
+            return [null, badRequest("status must be active, paused, or archived.")];
+        if (create && status !== "paused") {
+            return [null, badRequest("Create tools only create paused campaigns. Use set_campaign_state after review.")];
+        }
+        body.status = status;
+    }
+    if (input.budget_usd !== undefined && input.budget_usd !== null) {
+        const budgetUsd = Number(input.budget_usd);
+        const error = budgetGuard(budgetUsd, input.confirm_budget === true);
+        if (error)
+            return [null, error];
+        body.budget = { lifetime_spend_limit_micros: usdToMicros(budgetUsd) };
+    }
+    else if (create) {
+        return [null, badRequest("budget_usd is required.")];
+    }
+    if (input.description !== undefined)
+        body.description = input.description;
+    const startError = validateUnixTime("start_time", input.start_time);
+    if (startError)
+        return [null, startError];
+    const endError = validateUnixTime("end_time", input.end_time);
+    if (endError)
+        return [null, endError];
+    if (input.start_time !== undefined && input.start_time !== null)
+        body.start_time = Number(input.start_time);
+    if (input.end_time !== undefined && input.end_time !== null)
+        body.end_time = Number(input.end_time);
+    if (body.start_time !== undefined && body.end_time !== undefined && Number(body.end_time) <= Number(body.start_time)) {
+        return [null, badRequest("end_time must be after start_time.")];
+    }
+    if (input.mode !== undefined && input.mode !== null) {
+        if (input.mode !== "product_feed")
+            return [null, badRequest("mode must be product_feed when provided.")];
+        body.mode = input.mode;
+    }
+    const [targeting, targetingError] = locationsPayload(input.locations);
+    if (targetingError)
+        return [null, targetingError];
+    if (targeting)
+        body.targeting = targeting;
+    if (!Object.keys(body).length)
+        return [null, badRequest("Provide at least one field to update.")];
+    return [body, null];
+}
+async function listCampaigns(args) {
+    const limit = Number(args.limit ?? 20);
+    const limitError = validateIntRange("limit", limit, 1, 500);
+    if (limitError)
+        return limitError;
+    const { client, error } = getClientOrError();
+    if (error)
+        return error;
+    try {
+        return ok(await client.get("/campaigns", optionalParams({ limit, after: args.after, before: args.before, order: args.order ?? "desc" })));
+    }
+    catch (apiError) {
+        return handleApiError(apiError);
+    }
+}
+async function getCampaign(args) {
+    const error = validateNonEmpty("campaign_id", args.campaign_id);
+    if (error)
+        return error;
+    const { client, error: clientError } = getClientOrError();
+    if (clientError)
+        return clientError;
+    try {
+        return ok(await client.get(`/campaigns/${args.campaign_id}`));
+    }
+    catch (apiError) {
+        return handleApiError(apiError);
+    }
+}
+async function createCampaign(args) {
+    const [body, bodyError] = buildCampaignBody({ ...args, status: String(args.status ?? "paused"), create: true });
+    if (bodyError)
+        return bodyError;
+    const { client, error } = getClientOrError();
+    if (error)
+        return error;
+    try {
+        return ok(await client.post("/campaigns", body));
+    }
+    catch (apiError) {
+        return handleApiError(apiError);
+    }
+}
+async function updateCampaign(args) {
+    const campaignError = validateNonEmpty("campaign_id", args.campaign_id);
+    if (campaignError)
+        return campaignError;
+    const [body, bodyError] = buildCampaignBody(args);
+    if (bodyError)
+        return bodyError;
+    const { client, error } = getClientOrError();
+    if (error)
+        return error;
+    try {
+        return ok(await client.post(`/campaigns/${args.campaign_id}`, body));
+    }
+    catch (apiError) {
+        return handleApiError(apiError);
+    }
+}
+async function setCampaignState(args) {
+    const campaignError = validateNonEmpty("campaign_id", args.campaign_id);
+    if (campaignError)
+        return campaignError;
+    const state = String(args.state);
+    const stateError = validateOption("state", state, CAMPAIGN_STATES);
+    if (stateError)
+        return stateError;
+    const { client, error } = getClientOrError();
+    if (error)
+        return error;
+    try {
+        return ok(await client.post(`/campaigns/${args.campaign_id}/${state}`));
+    }
+    catch (apiError) {
+        return handleApiError(apiError);
+    }
+}
+const orderSchema = z.enum(["asc", "desc"]).default("desc");
+const campaignStatusSchema = z.enum(["paused", "active"]).default("paused");
+const updateCampaignStatusSchema = z.enum(["active", "paused", "archived"]).optional();
+export const campaignTools = [
+    {
+        name: "list_campaigns",
+        description: "List campaigns in the authenticated ad account with cursor pagination.",
+        inputSchema: {
+            limit: z.number().int().default(20),
+            after: z.string().optional(),
+            before: z.string().optional(),
+            order: orderSchema,
+        },
+        argNames: ["limit", "after", "before", "order"],
+        handler: listCampaigns,
+    },
+    {
+        name: "get_campaign",
+        description: "Get one campaign by id.",
+        inputSchema: { campaign_id: z.string() },
+        argNames: ["campaign_id"],
+        handler: getCampaign,
+    },
+    {
+        name: "create_campaign",
+        description: "Create an OpenAI Ads campaign, safely paused by default, with a guarded lifetime budget.",
+        inputSchema: {
+            name: z.string(),
+            budget_usd: z.number(),
+            status: campaignStatusSchema,
+            description: z.string().optional(),
+            start_time: z.number().int().optional(),
+            end_time: z.number().int().optional(),
+            mode: z.enum(["product_feed"]).optional(),
+            locations: z.any().optional(),
+            confirm_budget: z.boolean().default(false),
+        },
+        argNames: ["name", "budget_usd", "status", "description", "start_time", "end_time", "mode", "locations", "confirm_budget"],
+        writes: true,
+        destructive: true,
+        openWorld: true,
+        handler: createCampaign,
+    },
+    {
+        name: "update_campaign",
+        description: "Update campaign fields. Budget changes use the same ceiling guard as create_campaign.",
+        inputSchema: {
+            campaign_id: z.string(),
+            name: z.string().optional(),
+            budget_usd: z.number().optional(),
+            status: updateCampaignStatusSchema,
+            description: z.string().optional(),
+            start_time: z.number().int().optional(),
+            end_time: z.number().int().optional(),
+            mode: z.enum(["product_feed"]).optional(),
+            locations: z.any().optional(),
+            confirm_budget: z.boolean().default(false),
+        },
+        argNames: ["campaign_id", "name", "budget_usd", "status", "description", "start_time", "end_time", "mode", "locations", "confirm_budget"],
+        writes: true,
+        destructive: true,
+        openWorld: true,
+        handler: updateCampaign,
+    },
+    {
+        name: "set_campaign_state",
+        description: "Activate, pause, or archive a campaign. Activation can start real spend when child layers are active.",
+        inputSchema: { campaign_id: z.string(), state: z.enum(["activate", "pause", "archive"]) },
+        argNames: ["campaign_id", "state"],
+        writes: true,
+        destructive: true,
+        openWorld: true,
+        handler: setCampaignState,
+    },
+];
+//# sourceMappingURL=campaigns.js.map

package/dist/tools/campaigns.js.map

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

package/dist/tools/conversions.d.ts

@@ -0,0 +1,3 @@
+import { type AdsToolDefinition, type JsonRecord } from "../core.js";
+export declare function validateConversionEvents(events: unknown): [JsonRecord[] | null, string | null];
+export declare const conversionTools: AdsToolDefinition[];

package/dist/tools/conversions.js

@@ -0,0 +1,195 @@
+import { z } from "zod";
+import { badRequest, coerceList, coerceStringList, conversionTimeBoundsMs, getClientOrError, handleApiError, isRecord, ok, optionalParams, validateIntRange, validateNonEmpty, } from "../core.js";
+const ACTION_SOURCES = new Set(["web", "mobile_app", "offline", "physical_store", "phone_call", "email", "other"]);
+function sourceIdsPayload(sourceIds) {
+    const [ids, error] = coerceStringList(sourceIds, "source_ids");
+    if (error)
+        return [null, error];
+    if (!ids?.length)
+        return [null, badRequest("source_ids must include at least one id.")];
+    return [ids, null];
+}
+async function manageConversions(args) {
+    const { client, error } = getClientOrError();
+    if (error)
+        return error;
+    try {
+        if (args.action === "create_pixel") {
+            const nameError = validateNonEmpty("name", args.name, 3, 1000);
+            if (nameError)
+                return nameError;
+            return ok(await client.post("/conversions/pixels", { name: args.name, client_type: args.client_type ?? "web" }));
+        }
+        if (args.action === "create_api_key") {
+            const nameError = validateNonEmpty("name", args.name, 3, 1000);
+            if (nameError)
+                return nameError;
+            return ok(await client.post("/conversions/api_keys", { name: args.name }));
+        }
+        if (args.action === "get_event_settings") {
+            const limit = Number(args.limit ?? 20);
+            const limitError = validateIntRange("limit", limit, 1, 500);
+            if (limitError)
+                return limitError;
+            return ok(await client.get("/conversions/event_settings", optionalParams({
+                limit,
+                after: args.after,
+                before: args.before,
+                order: args.order ?? "desc",
+            })));
+        }
+        if (args.action === "set_event_settings") {
+            const nameError = validateNonEmpty("name", args.name, 1, 1000);
+            if (nameError)
+                return nameError;
+            const eventError = validateNonEmpty("event_type", args.event_type, 1, 100);
+            if (eventError)
+                return eventError;
+            const attributionWindowDays = Number(args.attribution_window_days);
+            if (!Number.isFinite(attributionWindowDays) || attributionWindowDays < 1) {
+                return badRequest("attribution_window_days must be at least 1.");
+            }
+            const [sourceIds, sourceIdsError] = sourceIdsPayload(args.source_ids);
+            if (sourceIdsError)
+                return sourceIdsError;
+            const body = {
+                name: args.name,
+                event_type: args.event_type,
+                attribution_window_days: attributionWindowDays,
+                source_ids: sourceIds,
+            };
+            if (args.custom_event_name)
+                body.custom_event_name = args.custom_event_name;
+            return ok(await client.post("/conversions/event_settings", body));
+        }
+        if (args.action === "get_insights") {
+            const levelError = validateNonEmpty("aggregation_level", args.aggregation_level, 1, 100);
+            if (levelError)
+                return levelError;
+            const [timeRanges, timeRangesError] = coerceStringList(args.time_ranges, "time_ranges");
+            if (timeRangesError)
+                return timeRangesError;
+            const [entityIds, entityIdsError] = coerceStringList(args.entity_ids, "entity_ids");
+            if (entityIdsError)
+                return entityIdsError;
+            if (!timeRanges?.length || !entityIds?.length) {
+                return badRequest("time_ranges and entity_ids are required for get_insights.");
+            }
+            return ok(await client.post("/conversions/insights", {
+                aggregation_level: args.aggregation_level,
+                time_ranges: timeRanges,
+                entity_ids: entityIds,
+            }));
+        }
+        return badRequest(`Unknown action: ${String(args.action)}`);
+    }
+    catch (apiError) {
+        return handleApiError(apiError);
+    }
+}
+export function validateConversionEvents(events) {
+    const [parsed, error] = coerceList(events, "events");
+    if (error)
+        return [null, error];
+    if (!parsed?.length)
+        return [null, badRequest("events must include at least one event.")];
+    if (parsed.length > 1000)
+        return [null, badRequest("send_conversions accepts at most 1000 events per call.")];
+    const [earliest, latest] = conversionTimeBoundsMs();
+    const out = [];
+    for (const [index, event] of parsed.entries()) {
+        if (!isRecord(event))
+            return [null, badRequest(`events[${index}] must be an object.`)];
+        if (!event.id)
+            return [null, badRequest(`events[${index}].id is required.`)];
+        if (!event.type)
+            return [null, badRequest(`events[${index}].type is required.`)];
+        if (!Number.isInteger(event.timestamp_ms)) {
+            return [null, badRequest(`events[${index}].timestamp_ms must be an integer.`)];
+        }
+        const timestampMs = event.timestamp_ms;
+        if (timestampMs < earliest)
+            return [null, badRequest("events include a timestamp older than 7 days.")];
+        if (timestampMs > latest)
+            return [null, badRequest("events include a timestamp more than 10 minutes in the future.")];
+        const actionSource = String(event.action_source);
+        if (!ACTION_SOURCES.has(actionSource)) {
+            return [null, badRequest(`events[${index}].action_source must be one of ${[...ACTION_SOURCES].sort().join(", ")}.`)];
+        }
+        if (actionSource === "web" && !event.source_url) {
+            return [null, badRequest("source_url is required for web conversion events.")];
+        }
+        out.push(event);
+    }
+    return [out, null];
+}
+async function sendConversions(args) {
+    const pixelError = validateNonEmpty("pixel_id", args.pixel_id);
+    if (pixelError)
+        return pixelError;
+    const [events, eventsError] = validateConversionEvents(args.events);
+    if (eventsError)
+        return eventsError;
+    const { client, error } = getClientOrError();
+    if (error)
+        return error;
+    try {
+        return ok(await client.postConversions(String(args.pixel_id), events ?? []));
+    }
+    catch (apiError) {
+        return handleApiError(apiError);
+    }
+}
+export const conversionTools = [
+    {
+        name: "manage_conversions",
+        description: "Manage conversion pixels, API keys, event settings, and conversion reporting.",
+        inputSchema: {
+            action: z.enum(["create_pixel", "create_api_key", "get_event_settings", "set_event_settings", "get_insights"]),
+            name: z.string().optional(),
+            client_type: z.enum(["web"]).default("web"),
+            event_type: z.string().optional(),
+            custom_event_name: z.string().optional(),
+            attribution_window_days: z.number().int().optional(),
+            source_ids: z.any().optional(),
+            aggregation_level: z.string().optional(),
+            time_ranges: z.any().optional(),
+            entity_ids: z.any().optional(),
+            limit: z.number().int().default(20),
+            after: z.string().optional(),
+            before: z.string().optional(),
+            order: z.enum(["asc", "desc"]).default("desc"),
+        },
+        argNames: [
+            "action",
+            "name",
+            "client_type",
+            "event_type",
+            "custom_event_name",
+            "attribution_window_days",
+            "source_ids",
+            "aggregation_level",
+            "time_ranges",
+            "entity_ids",
+            "limit",
+            "after",
+            "before",
+            "order",
+        ],
+        writes: true,
+        handler: manageConversions,
+    },
+    {
+        name: "send_conversions",
+        description: "Send conversion events to the OpenAI conversion ingest host after local privacy-safe validation.",
+        inputSchema: {
+            pixel_id: z.string(),
+            events: z.any(),
+        },
+        argNames: ["pixel_id", "events"],
+        writes: true,
+        openWorld: true,
+        handler: sendConversions,
+    },
+];
+//# sourceMappingURL=conversions.js.map

package/dist/tools/conversions.js.map

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

package/dist/tools/insights.d.ts

@@ -0,0 +1,2 @@
+import { type AdsToolDefinition } from "../core.js";
+export declare const insightTools: AdsToolDefinition[];

package/dist/tools/insights.js

@@ -0,0 +1,153 @@
+import { z } from "zod";
+import { badRequest, coerceJson, coerceStringList, getClientOrError, handleApiError, isRecord, jsonQueryList, okSized, optionalParams, validateIntRange, validateOption, } from "../core.js";
+const INSIGHT_SCOPES = new Set(["account", "campaign", "ad_group", "ad"]);
+const TIME_GRANULARITIES = new Set(["hourly", "daily", "monthly", "none"]);
+const SEGMENTS = new Set(["product", "country", "device"]);
+const FILTER_OPERATORS = new Set(["IN", "GREATER_THAN", "LESS_THAN"]);
+function insightsPath(scope, entityId) {
+    if (scope === "account")
+        return ["/ad_account/insights", null];
+    if (!entityId)
+        return [null, badRequest("entity_id is required for campaign, ad_group, and ad insights.")];
+    if (scope === "campaign")
+        return [`/campaigns/${entityId}/insights`, null];
+    if (scope === "ad_group")
+        return [`/ad_groups/${entityId}/insights`, null];
+    if (scope === "ad")
+        return [`/ads/${entityId}/insights`, null];
+    return [null, badRequest("scope must be account, campaign, ad_group, or ad.")];
+}
+function oneTimeRange(value) {
+    if (value === undefined || value === null)
+        return [null, null];
+    if (typeof value === "string") {
+        const [parsed, error] = coerceJson(value, "time_range");
+        if (error)
+            return [null, error];
+        value = parsed;
+    }
+    if (isRecord(value))
+        return [[JSON.stringify(value)], null];
+    if (Array.isArray(value)) {
+        if (value.length !== 1)
+            return [null, badRequest("time_range accepts one range object.")];
+        let item = value[0];
+        if (typeof item === "string") {
+            const [parsed, error] = coerceJson(item, "time_range");
+            if (error)
+                return [null, error];
+            item = parsed;
+        }
+        if (!isRecord(item))
+            return [null, badRequest("time_range must contain an object.")];
+        return [[JSON.stringify(item)], null];
+    }
+    return [null, badRequest("time_range must be an object or JSON object string.")];
+}
+function validateFilters(value) {
+    const [encoded, error] = jsonQueryList(value, "filters");
+    if (error || encoded === null)
+        return [null, error];
+    for (const item of encoded) {
+        const parsed = JSON.parse(item);
+        if (!FILTER_OPERATORS.has(String(parsed.operator)))
+            return [null, badRequest("filter operator must be IN, GREATER_THAN, or LESS_THAN.")];
+        if (!("field" in parsed) || !("value" in parsed))
+            return [null, badRequest("Each filter must include field, operator, and value.")];
+    }
+    return [encoded, null];
+}
+function validateSort(value) {
+    const [encoded, error] = jsonQueryList(value, "sort");
+    if (error || encoded === null)
+        return [null, error];
+    for (const item of encoded) {
+        const parsed = JSON.parse(item);
+        if (!["asc", "desc"].includes(String(parsed.direction)))
+            return [null, badRequest("sort direction must be asc or desc.")];
+        if (!("field" in parsed))
+            return [null, badRequest("Each sort entry must include field and direction.")];
+    }
+    return [encoded, null];
+}
+async function getInsights(args) {
+    const scope = String(args.scope);
+    const scopeError = validateOption("scope", scope, INSIGHT_SCOPES);
+    if (scopeError)
+        return scopeError;
+    const timeGranularity = String(args.time_granularity ?? "daily");
+    const granularityError = validateOption("time_granularity", timeGranularity, TIME_GRANULARITIES);
+    if (granularityError)
+        return granularityError;
+    const limit = Number(args.limit ?? 20);
+    const limitError = validateIntRange("limit", limit, 1, 2000);
+    if (limitError)
+        return limitError;
+    const [path, pathError] = insightsPath(scope, args.entity_id);
+    if (pathError)
+        return pathError;
+    const [timeRanges, timeError] = oneTimeRange(args.time_range);
+    if (timeError)
+        return timeError;
+    const [segments, segmentsError] = coerceStringList(args.segments, "segments");
+    if (segmentsError)
+        return segmentsError;
+    if (segments && segments.length > 1)
+        return badRequest("segments supports at most one value.");
+    if (segments) {
+        const unknown = segments.filter((segment) => !SEGMENTS.has(segment));
+        if (unknown.length)
+            return badRequest(`Invalid segments: ${unknown.join(", ")}.`);
+    }
+    const [fields, fieldsError] = coerceStringList(args.fields, "fields");
+    if (fieldsError)
+        return fieldsError;
+    const [filters, filtersError] = validateFilters(args.filters);
+    if (filtersError)
+        return filtersError;
+    const [sort, sortError] = validateSort(args.sort);
+    if (sortError)
+        return sortError;
+    const { client, error } = getClientOrError();
+    if (error)
+        return error;
+    try {
+        return okSized(await client.get(path, optionalParams({
+            time_granularity: timeGranularity,
+            time_ranges: timeRanges,
+            segments,
+            fields,
+            filters,
+            sort,
+            limit,
+            after: args.after,
+            before: args.before,
+        })), String(args.response_format ?? "concise"), "Use after or before cursors, narrow time_range, or request fewer fields.");
+    }
+    catch (apiError) {
+        return handleApiError(apiError);
+    }
+}
+export const insightTools = [
+    {
+        name: "get_insights",
+        description: "Get performance insights for account, campaign, ad group, or ad scope. Supports fields, filters, sort, product/country/device segments, time ranges, and cursor pagination.",
+        inputSchema: {
+            scope: z.enum(["account", "campaign", "ad_group", "ad"]),
+            entity_id: z.string().optional(),
+            time_granularity: z.enum(["hourly", "daily", "monthly", "none"]).default("daily"),
+            time_range: z.any().optional(),
+            segments: z.any().optional(),
+            fields: z.any().optional(),
+            filters: z.any().optional(),
+            sort: z.any().optional(),
+            limit: z.number().int().default(20),
+            after: z.string().optional(),
+            before: z.string().optional(),
+            response_format: z.enum(["concise", "detailed"]).default("concise"),
+        },
+        argNames: ["scope", "entity_id", "time_granularity", "time_range", "segments", "fields", "filters", "sort", "limit", "after", "before", "response_format"],
+        handler: getInsights,
+    },
+];
+//# sourceMappingURL=insights.js.map

package/dist/tools/insights.js.map

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