openai-ads-mcp 0.1.0

package/dist/helpers.js

@@ -0,0 +1,227 @@
+import { z } from "zod";
+import { OpenAIAdsAPIError } from "./client.js";
+import { badRequest, coerceList, coerceMapping, coerceStringList, extractId, getClientOrError, handleApiError, isRecord, ok, validateNonEmpty, } from "./core.js";
+import { buildAdGroupBody } from "./tools/adgroups.js";
+import { buildAdBody } from "./tools/ads.js";
+import { buildCampaignBody } from "./tools/campaigns.js";
+function parseToolError(errorText) {
+    try {
+        const parsed = JSON.parse(errorText);
+        return isRecord(parsed) ? parsed : { message: errorText };
+    }
+    catch {
+        return { message: errorText };
+    }
+}
+async function buildCampaign(args) {
+    const [groupPayload, groupParseError] = coerceMapping(args.ad_group, "ad_group");
+    if (groupParseError)
+        return groupParseError;
+    const [adPayloads, adsParseError] = coerceList(args.ads, "ads");
+    if (adsParseError)
+        return adsParseError;
+    if (!adPayloads?.length)
+        return badRequest("ads must include at least one ad.");
+    const [campaignBody, campaignError] = buildCampaignBody({
+        name: args.name,
+        budget_usd: args.budget_usd,
+        status: "paused",
+        confirm_budget: args.confirm_budget,
+        create: true,
+    });
+    if (campaignError)
+        return campaignError;
+    const { client, error } = getClientOrError();
+    if (error)
+        return error;
+    const created = {
+        campaign: null,
+        ad_group: null,
+        ads: [],
+    };
+    try {
+        const campaign = await client.post("/campaigns", campaignBody);
+        created.campaign = campaign;
+        const campaignId = extractId(campaign, "id", "campaign_id");
+        if (!campaignId) {
+            return ok({ created, error: { message: "Campaign was created but no id was returned." } });
+        }
+        const [adGroupBody, adGroupError] = buildAdGroupBody({
+            campaign_id: campaignId,
+            name: groupPayload?.name,
+            billing_event: groupPayload?.billing_event,
+            max_bid_usd: groupPayload?.max_bid_usd,
+            status: "paused",
+            context_hints: groupPayload?.context_hints,
+            create: true,
+        });
+        if (adGroupError) {
+            return ok({ created, error: parseToolError(adGroupError) });
+        }
+        const adGroup = await client.post("/ad_groups", adGroupBody);
+        created.ad_group = adGroup;
+        const adGroupId = extractId(adGroup, "id", "ad_group_id");
+        if (!adGroupId) {
+            return ok({ created, error: { message: "Ad group was created but no id was returned." } });
+        }
+        for (const [index, ad] of adPayloads.entries()) {
+            if (!isRecord(ad)) {
+                return ok({ created, error: { message: `ads[${index}] must be an object.` } });
+            }
+            const [adBody, adError] = buildAdBody({
+                ad_group_id: adGroupId,
+                name: ad.name ?? ad.title,
+                creative_type: ad.creative_type ?? "chat_card",
+                title: ad.title,
+                body: ad.body,
+                target_url: ad.target_url,
+                file_id: ad.file_id,
+                price: ad.price,
+                status: "paused",
+                create: true,
+            });
+            if (adError) {
+                return ok({ created, error: parseToolError(adError) });
+            }
+            created.ads.push(await client.post("/ads", adBody));
+        }
+        return ok({
+            created,
+            note: "Created paused. To go live, call set_campaign_state/set_ad_group_state/set_ad_state with state='activate'.",
+        });
+    }
+    catch (apiError) {
+        if (apiError instanceof OpenAIAdsAPIError && (created.campaign || created.ad_group || created.ads.length)) {
+            return ok({ created, error: { status_code: apiError.statusCode, message: apiError.detail } });
+        }
+        return handleApiError(apiError);
+    }
+}
+async function draftContextHints(args) {
+    const productError = validateNonEmpty("product", args.product, 2, 200);
+    if (productError)
+        return productError;
+    const [keywordValues, keywordsError] = coerceStringList(args.keywords, "keywords");
+    if (keywordsError)
+        return keywordsError;
+    const product = String(args.product).trim();
+    const audience = typeof args.audience === "string" && args.audience.trim() ? args.audience.trim() : null;
+    const intent = typeof args.intent === "string" && args.intent.trim() ? args.intent.trim() : null;
+    const bits = [`Product: ${product}`];
+    if (audience)
+        bits.push(`Audience: ${audience}`);
+    if (intent)
+        bits.push(`Intent: ${intent}`);
+    if (keywordValues?.length)
+        bits.push(`Keywords: ${keywordValues.slice(0, 12).join(", ")}`);
+    const base = bits.join(" | ");
+    const hints = [
+        {
+            context_hint: base,
+            rationale: "Broad enough to capture the category, narrow enough to avoid unrelated prompts.",
+        },
+        {
+            context_hint: `${base} | Moment: comparing options, reading recommendations, or asking what to buy`,
+            rationale: "Targets high-intent discovery moments where paid placement can shape a shortlist.",
+        },
+    ];
+    if (audience) {
+        hints.push({
+            context_hint: `Product: ${product} | Audience problem: ${audience} needs a credible solution`,
+            rationale: "Frames the ad around the buyer and use case rather than only the product name.",
+        });
+    }
+    return ok({ context_hints: hints.map((item) => item.context_hint), drafts: hints });
+}
+async function bulkAbTestHints(args) {
+    const adGroupError = validateNonEmpty("ad_group_id", args.ad_group_id);
+    if (adGroupError)
+        return adGroupError;
+    const [parsed, variantsError] = coerceList(args.variants, "variants");
+    if (variantsError)
+        return variantsError;
+    if (!parsed?.length)
+        return badRequest("variants must include at least one variant.");
+    if (parsed.length > 20)
+        return badRequest("Create at most 20 variants per A/B test batch.");
+    const { client, error } = getClientOrError();
+    if (error)
+        return error;
+    const created = [];
+    try {
+        for (const [index, variant] of parsed.entries()) {
+            if (!isRecord(variant)) {
+                return ok({ created, error: { message: `variants[${index}] must be an object.` } });
+            }
+            const [adBody, adError] = buildAdBody({
+                ad_group_id: args.ad_group_id,
+                name: variant.name ?? `AB test: ${String(variant.title ?? index + 1)}`,
+                creative_type: variant.creative_type ?? "chat_card",
+                title: variant.title,
+                body: variant.body,
+                target_url: variant.target_url,
+                file_id: variant.file_id,
+                price: variant.price,
+                status: "paused",
+                create: true,
+            });
+            if (adError) {
+                return ok({ created, error: parseToolError(adError) });
+            }
+            created.push(await client.post("/ads", adBody));
+        }
+        return ok({
+            created_ads: created,
+            ad_ids: created.map((ad) => extractId(ad, "id", "ad_id")),
+            note: "Created paused. Activate only the variants you are ready to test.",
+        });
+    }
+    catch (apiError) {
+        if (apiError instanceof OpenAIAdsAPIError) {
+            return ok({ created, error: { status_code: apiError.statusCode, message: apiError.detail } });
+        }
+        return handleApiError(apiError);
+    }
+}
+export const helperTools = [
+    {
+        name: "build_campaign",
+        description: "Build one paused campaign tree with one ad group and multiple paused ads, with guarded budget handling.",
+        inputSchema: {
+            name: z.string(),
+            budget_usd: z.number(),
+            ad_group: z.any(),
+            ads: z.any(),
+            confirm_budget: z.boolean().default(false),
+        },
+        argNames: ["name", "budget_usd", "ad_group", "ads", "confirm_budget"],
+        writes: true,
+        destructive: true,
+        openWorld: true,
+        handler: buildCampaign,
+    },
+    {
+        name: "draft_context_hints",
+        description: "Draft deterministic context_hints for an ad group from product, audience, intent, and keywords.",
+        inputSchema: {
+            product: z.string(),
+            audience: z.string().optional(),
+            intent: z.string().optional(),
+            keywords: z.any().optional(),
+        },
+        argNames: ["product", "audience", "intent", "keywords"],
+        handler: draftContextHints,
+    },
+    {
+        name: "bulk_ab_test_hints",
+        description: "Create multiple paused chat_card ad variants under one ad group for a clean A/B test.",
+        inputSchema: {
+            ad_group_id: z.string(),
+            variants: z.any(),
+        },
+        argNames: ["ad_group_id", "variants"],
+        writes: true,
+        handler: bulkAbTestHints,
+    },
+];
+//# sourceMappingURL=helpers.js.map

package/dist/helpers.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type AdsToolDefinition } from "./core.js";
+export declare const allToolDefinitions: AdsToolDefinition[];
+export declare function registeredToolDefinitions(): AdsToolDefinition[];
+export declare function registeredToolMetadata(): Array<{
+    name: string;
+    args: string[];
+}>;
+export declare function createOpenAIAdsMcpServer(): McpServer;
+export declare function main(): Promise<void>;

package/dist/index.js

@@ -0,0 +1,55 @@
+#!/usr/bin/env node
+import { pathToFileURL } from "node:url";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { INSTRUCTIONS, isReadonlyMode, registerAdsTool } from "./core.js";
+import { helperTools } from "./helpers.js";
+import { registerTrakkrVisibilityResource } from "./resource_trakkr.js";
+import { adGroupTools } from "./tools/adgroups.js";
+import { adTools } from "./tools/ads.js";
+import { accountTools } from "./tools/account.js";
+import { audienceTools } from "./tools/audiences.js";
+import { campaignTools } from "./tools/campaigns.js";
+import { conversionTools } from "./tools/conversions.js";
+import { insightTools } from "./tools/insights.js";
+export const allToolDefinitions = [
+    ...accountTools,
+    ...campaignTools,
+    ...adGroupTools,
+    ...adTools,
+    ...insightTools,
+    ...audienceTools,
+    ...conversionTools,
+    ...helperTools,
+];
+export function registeredToolDefinitions() {
+    return allToolDefinitions.filter((tool) => !(tool.writes && isReadonlyMode()));
+}
+export function registeredToolMetadata() {
+    return registeredToolDefinitions().map((tool) => ({ name: tool.name, args: [...tool.argNames] }));
+}
+export function createOpenAIAdsMcpServer() {
+    const server = new McpServer({
+        name: "OpenAI Ads",
+        version: "0.1.0",
+    }, {
+        instructions: INSTRUCTIONS,
+    });
+    registerTrakkrVisibilityResource(server);
+    for (const tool of allToolDefinitions) {
+        registerAdsTool(server, tool);
+    }
+    return server;
+}
+export async function main() {
+    const server = createOpenAIAdsMcpServer();
+    await server.connect(new StdioServerTransport());
+}
+if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
+    main().catch((error) => {
+        const message = error instanceof Error ? error.message : String(error);
+        console.error(`openai-ads-mcp failed to start: ${message}`);
+        process.exitCode = 1;
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,eAAe,EAA0B,MAAM,WAAW,CAAC;AAClG,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,gCAAgC,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,MAAM,CAAC,MAAM,kBAAkB,GAAwB;IACrD,GAAG,YAAY;IACf,GAAG,aAAa;IAChB,GAAG,YAAY;IACf,GAAG,OAAO;IACV,GAAG,YAAY;IACf,GAAG,aAAa;IAChB,GAAG,eAAe;IAClB,GAAG,WAAW;CACf,CAAC;AAEF,MAAM,UAAU,yBAAyB;IACvC,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,IAAI,cAAc,EAAE,CAAC,CAAC,CAAC;AACjF,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,OAAO,yBAAyB,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;AACpG,CAAC;AAED,MAAM,UAAU,wBAAwB;IACtC,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B;QACE,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,OAAO;KACjB,EACD;QACE,YAAY,EAAE,YAAY;KAC3B,CACF,CAAC;IACF,gCAAgC,CAAC,MAAM,CAAC,CAAC;IACzC,KAAK,MAAM,IAAI,IAAI,kBAAkB,EAAE,CAAC;QACtC,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,IAAI;IACxB,MAAM,MAAM,GAAG,wBAAwB,EAAE,CAAC;IAC1C,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC;AACnD,CAAC;AAED,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/E,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QACrB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,OAAO,CAAC,KAAK,CAAC,mCAAmC,OAAO,EAAE,CAAC,CAAC;QAC5D,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/resource_trakkr.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare const TRAKKR_VISIBILITY_URI = "openai-ads://trakkr-visibility";
+export declare const TRAKKR_VISIBILITY_BRIEFING: string;
+export declare function registerTrakkrVisibilityResource(server: McpServer): void;

package/dist/resource_trakkr.js

@@ -0,0 +1,28 @@
+export const TRAKKR_VISIBILITY_URI = "openai-ads://trakkr-visibility";
+export const TRAKKR_VISIBILITY_BRIEFING = "# Paid and organic AI visibility\n\n" +
+    "OpenAI Ads helps you buy visibility inside ChatGPT. That answers one " +
+    "question: where can you place paid messages?\n\n" +
+    "Trakkr answers the other half: where does your brand already appear " +
+    "organically across ChatGPT, Perplexity, Gemini, Claude, Google AI " +
+    "Overviews, Reddit, and citations?\n\n" +
+    "Use both views together:\n\n" +
+    "1. Pull Ads insights to see paid impressions, clicks, spend, and conversions.\n" +
+    "2. Track organic AI visibility to see which prompts, competitors, and citations already shape the market.\n" +
+    "3. Use the gap between the two to decide where paid coverage is worth buying.\n\n" +
+    "Learn more at https://trakkr.ai.";
+export function registerTrakkrVisibilityResource(server) {
+    server.registerResource("Trakkr AI visibility briefing", TRAKKR_VISIBILITY_URI, {
+        title: "Paid and organic AI visibility",
+        description: "A short paste-ready briefing on connecting ChatGPT ad placements with organic AI visibility tracking.",
+        mimeType: "text/markdown",
+    }, async (uri) => ({
+        contents: [
+            {
+                uri: uri.href,
+                mimeType: "text/markdown",
+                text: TRAKKR_VISIBILITY_BRIEFING,
+            },
+        ],
+    }));
+}
+//# sourceMappingURL=resource_trakkr.js.map

package/dist/resource_trakkr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource_trakkr.js","sourceRoot":"","sources":["../src/resource_trakkr.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,qBAAqB,GAAG,gCAAgC,CAAC;AAEtE,MAAM,CAAC,MAAM,0BAA0B,GACrC,sCAAsC;IACtC,uEAAuE;IACvE,kDAAkD;IAClD,sEAAsE;IACtE,oEAAoE;IACpE,uCAAuC;IACvC,8BAA8B;IAC9B,iFAAiF;IACjF,6GAA6G;IAC7G,mFAAmF;IACnF,kCAAkC,CAAC;AAErC,MAAM,UAAU,gCAAgC,CAAC,MAAiB;IAChE,MAAM,CAAC,gBAAgB,CACrB,+BAA+B,EAC/B,qBAAqB,EACrB;QACE,KAAK,EAAE,gCAAgC;QACvC,WAAW,EAAE,uGAAuG;QACpH,QAAQ,EAAE,eAAe;KAC1B,EACD,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;QACd,QAAQ,EAAE;YACR;gBACE,GAAG,EAAE,GAAG,CAAC,IAAI;gBACb,QAAQ,EAAE,eAAe;gBACzB,IAAI,EAAE,0BAA0B;aACjC;SACF;KACF,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/tools/account.d.ts

@@ -0,0 +1,3 @@
+import { type AdsToolDefinition } from "../core.js";
+export declare function getAccount(): Promise<string>;
+export declare const accountTools: AdsToolDefinition[];

package/dist/tools/account.js

@@ -0,0 +1,24 @@
+import { z } from "zod";
+import { getClientOrError, handleApiError, ok } from "../core.js";
+export async function getAccount() {
+    const { client, error } = getClientOrError();
+    if (error)
+        return error;
+    try {
+        return ok(await client.get("/ad_account"));
+    }
+    catch (apiError) {
+        return handleApiError(apiError);
+    }
+}
+export const accountTools = [
+    {
+        name: "get_account",
+        description: "Get the authenticated OpenAI Ads account. Use this first to verify that OPENAI_ADS_API_KEY works and to read account id, name, timezone, currency, and settings.",
+        inputSchema: {},
+        argNames: [],
+        handler: () => getAccount(),
+    },
+];
+void z;
+//# sourceMappingURL=account.js.map

package/dist/tools/account.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"account.js","sourceRoot":"","sources":["../../src/tools/account.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,EAAE,EAA0B,MAAM,YAAY,CAAC;AAE1F,MAAM,CAAC,KAAK,UAAU,UAAU;IAC9B,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,gBAAgB,EAAE,CAAC;IAC7C,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC;IACxB,IAAI,CAAC;QACH,OAAO,EAAE,CAAC,MAAM,MAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC;IAC9C,CAAC;IAAC,OAAO,QAAQ,EAAE,CAAC;QAClB,OAAO,cAAc,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAwB;IAC/C;QACE,IAAI,EAAE,aAAa;QACnB,WAAW,EACT,kKAAkK;QACpK,WAAW,EAAE,EAAE;QACf,QAAQ,EAAE,EAAE;QACZ,OAAO,EAAE,GAAG,EAAE,CAAC,UAAU,EAAE;KAC5B;CACF,CAAC;AAEF,KAAK,CAAC,CAAC"}

package/dist/tools/adgroups.d.ts

@@ -0,0 +1,11 @@
+import { type AdsToolDefinition, type JsonRecord } from "../core.js";
+export declare function buildAdGroupBody(input: {
+    campaign_id?: unknown;
+    name?: unknown;
+    status?: string;
+    billing_event?: string;
+    max_bid_usd?: unknown;
+    context_hints?: unknown;
+    create?: boolean;
+}): [JsonRecord | null, string | null];
+export declare const adGroupTools: AdsToolDefinition[];

package/dist/tools/adgroups.js

@@ -0,0 +1,205 @@
+import { z } from "zod";
+import { badRequest, coerceStringList, getClientOrError, handleApiError, ok, optionalParams, usdToMicros, validateFloatRange, validateIntRange, validateNonEmpty, validateOption, } from "../core.js";
+const AD_GROUP_STATES = new Set(["activate", "pause", "archive"]);
+const AD_GROUP_STATUSES = new Set(["active", "paused", "archived"]);
+const BILLING_EVENTS = new Set(["impression", "click"]);
+export function buildAdGroupBody(input) {
+    const body = {};
+    const create = input.create === true;
+    if (create) {
+        const campaignError = validateNonEmpty("campaign_id", input.campaign_id);
+        if (campaignError)
+            return [null, campaignError];
+        body.campaign_id = input.campaign_id;
+    }
+    if (input.name !== undefined && input.name !== null) {
+        const nameError = validateNonEmpty("name", input.name, 3, 1000);
+        if (nameError)
+            return [null, nameError];
+        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 (!AD_GROUP_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 ad groups. Use set_ad_group_state after review.")];
+        }
+        body.status = status;
+    }
+    if (input.billing_event !== undefined || input.max_bid_usd !== undefined) {
+        if (input.billing_event === undefined || input.max_bid_usd === undefined) {
+            return [null, badRequest("billing_event and max_bid_usd must be provided together.")];
+        }
+        if (!BILLING_EVENTS.has(input.billing_event))
+            return [null, badRequest("billing_event must be impression or click.")];
+        const bid = Number(input.max_bid_usd);
+        const bidError = validateFloatRange("max_bid_usd", bid, 0.000001, 100);
+        if (bidError)
+            return [null, bidError];
+        body.bidding_config = { billing_event_type: input.billing_event, max_bid_micros: usdToMicros(bid) };
+    }
+    else if (create) {
+        return [null, badRequest("billing_event and max_bid_usd are required.")];
+    }
+    if (input.context_hints !== undefined) {
+        const [hints, hintsError] = coerceStringList(input.context_hints, "context_hints");
+        if (hintsError)
+            return [null, hintsError];
+        body.context_hints = hints;
+    }
+    if (!Object.keys(body).length)
+        return [null, badRequest("Provide at least one field to update.")];
+    return [body, null];
+}
+async function listAdGroups(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("/ad_groups", optionalParams({
+            campaign_id: args.campaign_id,
+            limit,
+            after: args.after,
+            before: args.before,
+            order: args.order ?? "desc",
+        })));
+    }
+    catch (apiError) {
+        return handleApiError(apiError);
+    }
+}
+async function getAdGroup(args) {
+    const adGroupError = validateNonEmpty("ad_group_id", args.ad_group_id);
+    if (adGroupError)
+        return adGroupError;
+    const { client, error } = getClientOrError();
+    if (error)
+        return error;
+    try {
+        return ok(await client.get(`/ad_groups/${args.ad_group_id}`));
+    }
+    catch (apiError) {
+        return handleApiError(apiError);
+    }
+}
+async function createAdGroup(args) {
+    const [body, bodyError] = buildAdGroupBody({ ...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("/ad_groups", body));
+    }
+    catch (apiError) {
+        return handleApiError(apiError);
+    }
+}
+async function updateAdGroup(args) {
+    const adGroupError = validateNonEmpty("ad_group_id", args.ad_group_id);
+    if (adGroupError)
+        return adGroupError;
+    const [body, bodyError] = buildAdGroupBody(args);
+    if (bodyError)
+        return bodyError;
+    const { client, error } = getClientOrError();
+    if (error)
+        return error;
+    try {
+        return ok(await client.post(`/ad_groups/${args.ad_group_id}`, body));
+    }
+    catch (apiError) {
+        return handleApiError(apiError);
+    }
+}
+async function setAdGroupState(args) {
+    const adGroupError = validateNonEmpty("ad_group_id", args.ad_group_id);
+    if (adGroupError)
+        return adGroupError;
+    const state = String(args.state);
+    const stateError = validateOption("state", state, AD_GROUP_STATES);
+    if (stateError)
+        return stateError;
+    const { client, error } = getClientOrError();
+    if (error)
+        return error;
+    try {
+        return ok(await client.post(`/ad_groups/${args.ad_group_id}/${state}`));
+    }
+    catch (apiError) {
+        return handleApiError(apiError);
+    }
+}
+const orderSchema = z.enum(["asc", "desc"]).default("desc");
+export const adGroupTools = [
+    {
+        name: "list_ad_groups",
+        description: "List ad groups, optionally filtered to a campaign.",
+        inputSchema: {
+            campaign_id: z.string().optional(),
+            limit: z.number().int().default(20),
+            after: z.string().optional(),
+            before: z.string().optional(),
+            order: orderSchema,
+        },
+        argNames: ["campaign_id", "limit", "after", "before", "order"],
+        handler: listAdGroups,
+    },
+    {
+        name: "get_ad_group",
+        description: "Get one ad group by id.",
+        inputSchema: { ad_group_id: z.string() },
+        argNames: ["ad_group_id"],
+        handler: getAdGroup,
+    },
+    {
+        name: "create_ad_group",
+        description: "Create a paused ad group under a campaign with bid config and optional context hints.",
+        inputSchema: {
+            campaign_id: z.string(),
+            name: z.string(),
+            billing_event: z.enum(["impression", "click"]),
+            max_bid_usd: z.number(),
+            status: z.enum(["paused", "active"]).default("paused"),
+            context_hints: z.any().optional(),
+        },
+        argNames: ["campaign_id", "name", "billing_event", "max_bid_usd", "status", "context_hints"],
+        writes: true,
+        handler: createAdGroup,
+    },
+    {
+        name: "update_ad_group",
+        description: "Update ad group fields, including bid config and context hints.",
+        inputSchema: {
+            ad_group_id: z.string(),
+            name: z.string().optional(),
+            billing_event: z.enum(["impression", "click"]).optional(),
+            max_bid_usd: z.number().optional(),
+            status: z.enum(["active", "paused", "archived"]).optional(),
+            context_hints: z.any().optional(),
+        },
+        argNames: ["ad_group_id", "name", "billing_event", "max_bid_usd", "status", "context_hints"],
+        writes: true,
+        handler: updateAdGroup,
+    },
+    {
+        name: "set_ad_group_state",
+        description: "Activate, pause, or archive an ad group. Activation can start delivery when parent and child layers are active.",
+        inputSchema: { ad_group_id: z.string(), state: z.enum(["activate", "pause", "archive"]) },
+        argNames: ["ad_group_id", "state"],
+        writes: true,
+        destructive: true,
+        openWorld: true,
+        handler: setAdGroupState,
+    },
+];
+//# sourceMappingURL=adgroups.js.map

package/dist/tools/adgroups.js.map

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

package/dist/tools/ads.d.ts

@@ -0,0 +1,23 @@
+import { type AdsToolDefinition, type JsonRecord } from "../core.js";
+export declare function buildCreative(input: {
+    creative_type?: unknown;
+    title?: unknown;
+    body?: unknown;
+    target_url?: unknown;
+    file_id?: unknown;
+    price?: unknown;
+    create?: boolean;
+}): [JsonRecord | null, string | null];
+export declare function buildAdBody(input: {
+    ad_group_id?: unknown;
+    name?: unknown;
+    creative_type?: unknown;
+    title?: unknown;
+    body?: unknown;
+    target_url?: unknown;
+    file_id?: unknown;
+    price?: unknown;
+    status?: string;
+    create?: boolean;
+}): [JsonRecord | null, string | null];
+export declare const adTools: AdsToolDefinition[];