openai-ads-mcp 0.1.0

package/README.md

@@ -0,0 +1,35 @@
+# openai-ads-mcp for Node
+
+Node runtime for `openai-ads-mcp`, a typed MCP server for OpenAI's Advertiser API.
+
+It exposes the same tools, arguments, defaults, readonly mode, and budget guard as the Python package.
+
+## Quickstart
+
+```bash
+export OPENAI_ADS_API_KEY="..."
+export OPENAI_ADS_MCP_READONLY=1
+npx -y openai-ads-mcp
+```
+
+Readonly mode hides every write tool from `tools/list`. Unset `OPENAI_ADS_MCP_READONLY` only after you have confirmed the account and reviewed existing campaigns.
+
+## Local Development
+
+```bash
+npm install
+npm run build
+npm test
+OPENAI_ADS_MCP_READONLY=1 node dist/index.js
+```
+
+## Environment
+
+| Variable | Purpose |
+| --- | --- |
+| `OPENAI_ADS_API_KEY` | Required bearer key for `https://api.ads.openai.com/v1`. |
+| `OPENAI_ADS_API_BASE_URL` | Optional HTTPS override for tests or proxies. |
+| `OPENAI_ADS_MCP_READONLY` | Set to `1` or `true` to register read tools only. |
+| `OPENAI_ADS_BUDGET_CEILING_USD` | Optional budget guard. Default `100`. |
+
+Full docs live in the repository root README.

package/dist/client.d.ts

@@ -0,0 +1,19 @@
+export declare const API_BASE_URL = "https://api.ads.openai.com/v1";
+export declare const CONVERSIONS_BASE_URL = "https://bzr.openai.com/v1";
+export declare class OpenAIAdsAPIError extends Error {
+    readonly statusCode: number;
+    readonly detail: string;
+    constructor(statusCode: number, detail: string);
+}
+export type JsonRecord = Record<string, unknown>;
+export declare class OpenAIAdsClient {
+    private readonly apiKey;
+    private readonly baseUrl;
+    constructor(apiKey: string, baseUrl?: string);
+    static fromEnv(): OpenAIAdsClient;
+    get(path: string, params?: JsonRecord): Promise<JsonRecord>;
+    post(path: string, body?: JsonRecord): Promise<JsonRecord>;
+    uploadFile(path: string, filePath: string): Promise<JsonRecord>;
+    postConversions(pixelId: string, events: JsonRecord[]): Promise<JsonRecord>;
+    private request;
+}

package/dist/client.js

@@ -0,0 +1,145 @@
+import { readFile } from "node:fs/promises";
+import { basename } from "node:path";
+export const API_BASE_URL = "https://api.ads.openai.com/v1";
+export const CONVERSIONS_BASE_URL = "https://bzr.openai.com/v1";
+const USER_AGENT = "openai-ads-mcp/0.1.0";
+const FRIENDLY_ERRORS = {
+    401: "Invalid or expired OPENAI_ADS_API_KEY.",
+    403: "Access denied. Check whether this Ads account is eligible and has permission for this endpoint.",
+    404: "Resource not found. Check the id and try again.",
+    429: "Rate limited by the OpenAI Ads API. Wait a moment and retry.",
+};
+export class OpenAIAdsAPIError extends Error {
+    statusCode;
+    detail;
+    constructor(statusCode, detail) {
+        super(detail);
+        this.name = "OpenAIAdsAPIError";
+        this.statusCode = statusCode;
+        this.detail = detail;
+    }
+}
+export class OpenAIAdsClient {
+    apiKey;
+    baseUrl;
+    constructor(apiKey, baseUrl = API_BASE_URL) {
+        if (!apiKey.trim()) {
+            throw new Error("OPENAI_ADS_API_KEY is required.");
+        }
+        this.apiKey = apiKey;
+        this.baseUrl = validateBaseUrl(baseUrl, "OPENAI_ADS_API_BASE_URL");
+    }
+    static fromEnv() {
+        return new OpenAIAdsClient(process.env.OPENAI_ADS_API_KEY ?? "", process.env.OPENAI_ADS_API_BASE_URL ?? API_BASE_URL);
+    }
+    async get(path, params) {
+        return this.request(this.baseUrl, "GET", path, { params });
+    }
+    async post(path, body) {
+        return this.request(this.baseUrl, "POST", path, { json: body });
+    }
+    async uploadFile(path, filePath) {
+        const bytes = await readFile(filePath);
+        const form = new FormData();
+        form.append("file", new Blob([bytes]), basename(filePath));
+        return this.request(this.baseUrl, "POST", path, { body: form });
+    }
+    async postConversions(pixelId, events) {
+        return this.request(CONVERSIONS_BASE_URL, "POST", "/events", {
+            params: { pid: pixelId },
+            json: { events },
+            redactDetail: true,
+        });
+    }
+    async request(baseUrl, method, path, options = {}) {
+        const url = buildUrl(baseUrl, path, options.params);
+        const headers = new Headers({
+            Accept: "application/json",
+            Authorization: `Bearer ${this.apiKey}`,
+            "User-Agent": USER_AGENT,
+        });
+        let body = options.body;
+        if (options.json !== undefined) {
+            headers.set("Content-Type", "application/json");
+            body = JSON.stringify(options.json);
+        }
+        try {
+            const response = await fetch(url, { method, headers, body, redirect: "manual" });
+            if (!response.ok) {
+                throw await toApiError(response, options.redactDetail === true);
+            }
+            const text = await response.text();
+            if (!text) {
+                return {};
+            }
+            return JSON.parse(text);
+        }
+        catch (error) {
+            if (error instanceof OpenAIAdsAPIError) {
+                throw error;
+            }
+            throw new OpenAIAdsAPIError(0, `Network error contacting OpenAI Ads API: ${error instanceof Error ? error.name : "Error"}`);
+        }
+    }
+}
+async function toApiError(response, redactDetail) {
+    const friendly = FRIENDLY_ERRORS[response.status];
+    if (friendly) {
+        return new OpenAIAdsAPIError(response.status, friendly);
+    }
+    if (response.status >= 500) {
+        const requestId = response.headers.get("x-request-id");
+        let message = "OpenAI Ads API is temporarily unavailable. Please try again shortly.";
+        if (requestId) {
+            message = `${message} Request ID: ${requestId}`;
+        }
+        return new OpenAIAdsAPIError(response.status, message);
+    }
+    let detail = `HTTP ${response.status}`;
+    if (!redactDetail) {
+        try {
+            const body = (await response.json());
+            detail = String(body.detail ?? body.message ?? JSON.stringify(body));
+        }
+        catch {
+            detail = (await response.text()) || detail;
+        }
+    }
+    return new OpenAIAdsAPIError(response.status, `API error (${response.status}): ${detail}`);
+}
+function buildUrl(baseUrl, path, params) {
+    const url = new URL(path, `${baseUrl}/`);
+    for (const [key, value] of Object.entries(params ?? {})) {
+        if (value === undefined || value === null) {
+            continue;
+        }
+        if (Array.isArray(value)) {
+            for (const item of value) {
+                if (item !== undefined && item !== null) {
+                    url.searchParams.append(key, String(item));
+                }
+            }
+        }
+        else {
+            url.searchParams.set(key, String(value));
+        }
+    }
+    return url.toString();
+}
+function validateBaseUrl(baseUrl, envName) {
+    const parsed = new URL(baseUrl);
+    if (parsed.protocol !== "https:") {
+        throw new Error(`${envName} must use https.`);
+    }
+    if (!parsed.hostname) {
+        throw new Error(`${envName} must include a hostname.`);
+    }
+    if (parsed.username || parsed.password) {
+        throw new Error(`${envName} must not include credentials.`);
+    }
+    if (parsed.search || parsed.hash) {
+        throw new Error(`${envName} must not include query or fragment.`);
+    }
+    return baseUrl.replace(/\/+$/, "");
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/core.d.ts

@@ -0,0 +1,55 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import type { ZodRawShape } from "zod";
+import { OpenAIAdsClient, type JsonRecord } from "./client.js";
+export type { JsonRecord } from "./client.js";
+export declare const INSTRUCTIONS: string;
+export declare const RESPONSE_CHAR_BUDGET = 60000;
+export declare const CONCISE_LIST_HEAD = 50;
+export type AdsClientLike = Pick<OpenAIAdsClient, "get" | "post" | "uploadFile" | "postConversions">;
+export type ToolArgs = Record<string, unknown>;
+export type ToolHandler = (args: ToolArgs) => Promise<string>;
+export interface AdsToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: ZodRawShape;
+    argNames: string[];
+    writes?: boolean;
+    destructive?: boolean;
+    openWorld?: boolean;
+    idempotent?: boolean;
+    handler: ToolHandler;
+}
+export declare function setClientFactoryForTests(factory: () => AdsClientLike): void;
+export declare function resetClientFactoryForTests(): void;
+export declare function getClientOrError(): {
+    client?: AdsClientLike;
+    error?: string;
+};
+export declare function isReadonlyMode(): boolean;
+export declare function budgetCeilingUsd(): number;
+export declare function registerAdsTool(server: McpServer, definition: AdsToolDefinition): void;
+export declare function textResult(text: string): CallToolResult;
+export declare function compact(value: unknown): unknown;
+export declare function serialise(value: unknown): string;
+export declare function ok(value: unknown): string;
+export declare function okSized(value: unknown, responseFormat?: string, followUp?: string): string;
+export declare function handleApiError(error: unknown): string;
+export declare function badRequest(message: string): string;
+export declare function validateIntRange(name: string, value: number, minimum: number, maximum: number): string | null;
+export declare function validateFloatRange(name: string, value: number, minimum: number, maximum: number): string | null;
+export declare function validateNonEmpty(name: string, value: unknown, minimum?: number, maximum?: number): string | null;
+export declare function validateOption(name: string, value: string, allowed: Set<string>): string | null;
+export declare function coerceJson(value: unknown, name: string): [unknown, string | null];
+export declare function coerceMapping(value: unknown, name: string): [JsonRecord | null, string | null];
+export declare function coerceList(value: unknown, name: string): [unknown[] | null, string | null];
+export declare function coerceStringList(value: unknown, name: string): [string[] | null, string | null];
+export declare function jsonQueryList(value: unknown, name: string): [string[] | null, string | null];
+export declare function optionalParams(input: JsonRecord): JsonRecord;
+export declare function usdToMicros(value: number): number;
+export declare function budgetGuard(budgetUsd: number, confirmBudget: boolean): string | null;
+export declare function validateUnixTime(name: string, value: unknown): string | null;
+export declare function extractId(value: JsonRecord, ...keys: string[]): string | null;
+export declare function nowMs(): number;
+export declare function conversionTimeBoundsMs(): [number, number];
+export declare function isRecord(value: unknown): value is JsonRecord;

package/dist/core.js

@@ -0,0 +1,374 @@
+import { OpenAIAdsAPIError, OpenAIAdsClient } from "./client.js";
+export const INSTRUCTIONS = "Typed MCP tools for OpenAI's Advertiser API. Use get_account first to " +
+    "confirm the API key works, then read insights before changing spend. " +
+    "The safest workflow is: check the account, inspect campaigns and " +
+    "insights, build new campaigns paused, review the created campaign, ad " +
+    "group, and ads, then activate each layer explicitly when the user asks.\n\n" +
+    "Safety model:\n" +
+    "  1. Create tools default to paused. build_campaign creates every object paused.\n" +
+    "  2. Budget-setting tools enforce OPENAI_ADS_BUDGET_CEILING_USD, default 100 USD, unless confirm_budget=True.\n" +
+    "  3. Set OPENAI_ADS_MCP_READONLY=1 for first connection. In readonly mode write tools are not registered.\n" +
+    "  4. Conversion event ingestion never logs user data. Validate batches before sending them.\n" +
+    "Paid presence is half the picture. Track how your brand shows up organically across ChatGPT, Perplexity, Gemini and Claude at trakkr.ai.";
+const COMPACT_SEPARATORS = { dropNulls: true };
+export const RESPONSE_CHAR_BUDGET = 60_000;
+export const CONCISE_LIST_HEAD = 50;
+const HEAVY_FIELDS = new Set(["raw", "raw_response", "raw_results", "html", "request", "response"]);
+let clientFactory = () => OpenAIAdsClient.fromEnv();
+export function setClientFactoryForTests(factory) {
+    clientFactory = factory;
+}
+export function resetClientFactoryForTests() {
+    clientFactory = () => OpenAIAdsClient.fromEnv();
+}
+export function getClientOrError() {
+    try {
+        return { client: clientFactory() };
+    }
+    catch (error) {
+        return {
+            error: badRequest(error instanceof Error
+                ? `OpenAI Ads MCP client is not initialized. ${error.message}`
+                : "OpenAI Ads MCP client is not initialized. Set OPENAI_ADS_API_KEY and restart the MCP server."),
+        };
+    }
+}
+export function isReadonlyMode() {
+    return truthy(process.env.OPENAI_ADS_MCP_READONLY);
+}
+function truthy(value) {
+    return ["1", "true", "yes", "on"].includes((value ?? "").trim().toLowerCase());
+}
+export function budgetCeilingUsd() {
+    const parsed = Number.parseFloat(process.env.OPENAI_ADS_BUDGET_CEILING_USD ?? "100");
+    return Number.isFinite(parsed) && parsed > 0 ? parsed : 100;
+}
+export function registerAdsTool(server, definition) {
+    if (definition.writes && isReadonlyMode()) {
+        return;
+    }
+    const annotations = {
+        readOnlyHint: !definition.writes,
+        destructiveHint: definition.destructive ?? false,
+        idempotentHint: definition.idempotent ?? !definition.writes,
+        openWorldHint: definition.openWorld ?? false,
+    };
+    server.registerTool(definition.name, {
+        description: definition.description,
+        inputSchema: definition.inputSchema,
+        annotations,
+    }, async (args) => textResult(await definition.handler(args)));
+}
+export function textResult(text) {
+    return { content: [{ type: "text", text }] };
+}
+export function compact(value) {
+    if (Array.isArray(value)) {
+        return value.map((item) => compact(item));
+    }
+    if (value && typeof value === "object") {
+        const output = {};
+        for (const [key, item] of Object.entries(value)) {
+            if (item !== null && item !== undefined) {
+                output[key] = compact(item);
+            }
+        }
+        return output;
+    }
+    return value;
+}
+export function serialise(value) {
+    void COMPACT_SEPARATORS;
+    return JSON.stringify(compact(value));
+}
+export function ok(value) {
+    return serialise(value);
+}
+export function okSized(value, responseFormat = "detailed", followUp) {
+    if (!isRecord(value)) {
+        return ok(value);
+    }
+    let data = value;
+    const notes = [];
+    if (responseFormat === "concise") {
+        const [slimmed, note] = toConcise(data);
+        data = slimmed;
+        if (note) {
+            notes.push(note);
+        }
+    }
+    const [bounded, budgetNote] = enforceBudget(data);
+    data = bounded;
+    if (budgetNote) {
+        notes.push(budgetNote);
+    }
+    if (notes.length) {
+        data = {
+            ...data,
+            _response: {
+                note: notes.join(" "),
+                ...(followUp ? { more: followUp } : {}),
+            },
+        };
+    }
+    return ok(data);
+}
+function toConcise(data) {
+    const stats = { fields: 0, items: 0 };
+    const walk = (value) => {
+        if (Array.isArray(value)) {
+            let items = value;
+            if (items.length > CONCISE_LIST_HEAD) {
+                stats.items += items.length - CONCISE_LIST_HEAD;
+                items = items.slice(0, CONCISE_LIST_HEAD);
+            }
+            return items.map((item) => walk(item));
+        }
+        if (isRecord(value)) {
+            const out = {};
+            for (const [key, item] of Object.entries(value)) {
+                if (HEAVY_FIELDS.has(key)) {
+                    stats.fields += 1;
+                    continue;
+                }
+                out[key] = walk(item);
+            }
+            return out;
+        }
+        return value;
+    };
+    const slimmed = walk(data);
+    if (!stats.fields && !stats.items) {
+        return [slimmed, null];
+    }
+    const bits = [];
+    if (stats.items) {
+        bits.push(`capped long lists to the first ${CONCISE_LIST_HEAD} (${stats.items} items held back)`);
+    }
+    if (stats.fields) {
+        bits.push(`dropped ${stats.fields} verbose field(s)`);
+    }
+    return [slimmed, `Concise view: ${bits.join(" and ")}. Pass response_format='detailed' for the full payload.`];
+}
+function enforceBudget(data) {
+    if (serialise(data).length <= RESPONSE_CHAR_BUDGET) {
+        return [data, null];
+    }
+    let working = structuredClone(data);
+    const dropped = new Map();
+    for (let i = 0; i < 80; i += 1) {
+        const listFields = [...iterListFields(working)];
+        const best = listFields.sort((a, b) => serialise(b.list).length - serialise(a.list).length)[0];
+        if (!best || best.list.length <= 1) {
+            break;
+        }
+        const keep = Math.max(1, Math.floor(best.list.length / 2));
+        dropped.set(best.key, (dropped.get(best.key) ?? 0) + best.list.length - keep);
+        best.container[best.key] = best.list.slice(0, keep);
+        if (serialise(working).length <= RESPONSE_CHAR_BUDGET) {
+            break;
+        }
+    }
+    if (!dropped.size) {
+        return [working, null];
+    }
+    const detail = [...dropped.entries()].map(([key, count]) => `${count} from '${key}'`).join(", ");
+    return [working, `Trimmed to fit the context budget: dropped ${detail}. Narrow the query or page with cursors.`];
+}
+function* iterListFields(data) {
+    if (Array.isArray(data)) {
+        for (const item of data) {
+            yield* iterListFields(item);
+        }
+        return;
+    }
+    if (!isRecord(data)) {
+        return;
+    }
+    for (const [key, value] of Object.entries(data)) {
+        if (Array.isArray(value)) {
+            yield { container: data, key, list: value };
+            for (const item of value) {
+                yield* iterListFields(item);
+            }
+        }
+        else if (isRecord(value)) {
+            yield* iterListFields(value);
+        }
+    }
+}
+export function handleApiError(error) {
+    if (!(error instanceof OpenAIAdsAPIError)) {
+        throw error;
+    }
+    if (error.statusCode === 0 || error.statusCode === 401 || error.statusCode >= 500) {
+        throw error;
+    }
+    return JSON.stringify({ error: true, message: error.detail });
+}
+export function badRequest(message) {
+    return JSON.stringify({ error: true, message });
+}
+export function validateIntRange(name, value, minimum, maximum) {
+    if (value < minimum || value > maximum) {
+        return badRequest(`${name} must be between ${minimum} and ${maximum}.`);
+    }
+    return null;
+}
+export function validateFloatRange(name, value, minimum, maximum) {
+    if (value < minimum || value > maximum) {
+        return badRequest(`${name} must be between ${minimum} and ${maximum}.`);
+    }
+    return null;
+}
+export function validateNonEmpty(name, value, minimum = 1, maximum = 500) {
+    if (typeof value !== "string") {
+        return badRequest(`${name} is required.`);
+    }
+    const normalized = value.trim();
+    if (normalized.length < minimum || normalized.length > maximum) {
+        return badRequest(`${name} must be ${minimum}-${maximum} characters.`);
+    }
+    return null;
+}
+export function validateOption(name, value, allowed) {
+    if (!allowed.has(value)) {
+        return badRequest(`Invalid ${name}: ${value}. Allowed values: ${[...allowed].sort().join(", ")}.`);
+    }
+    return null;
+}
+export function coerceJson(value, name) {
+    if (typeof value !== "string") {
+        return [value, null];
+    }
+    try {
+        return [JSON.parse(value), null];
+    }
+    catch (error) {
+        return [null, badRequest(`${name} must be valid JSON when passed as a string: ${error instanceof Error ? error.message : "invalid JSON"}.`)];
+    }
+}
+export function coerceMapping(value, name) {
+    const [parsed, error] = coerceJson(value, name);
+    if (error) {
+        return [null, error];
+    }
+    if (!isRecord(parsed)) {
+        return [null, badRequest(`${name} must be an object.`)];
+    }
+    return [parsed, null];
+}
+export function coerceList(value, name) {
+    if (value === undefined || value === null) {
+        return [null, null];
+    }
+    if (typeof value === "string") {
+        const stripped = value.trim();
+        if (!stripped) {
+            return [[], null];
+        }
+        if (stripped.startsWith("[")) {
+            const [parsed, error] = coerceJson(stripped, name);
+            if (error) {
+                return [null, error];
+            }
+            value = parsed;
+        }
+        else {
+            return [stripped.split(",").map((part) => part.trim()).filter(Boolean), null];
+        }
+    }
+    if (!Array.isArray(value)) {
+        return [null, badRequest(`${name} must be a list or a comma-separated string.`)];
+    }
+    return [value, null];
+}
+export function coerceStringList(value, name) {
+    const [items, error] = coerceList(value, name);
+    if (error || items === null) {
+        return [null, error];
+    }
+    const out = [];
+    for (const item of items) {
+        if (typeof item !== "string" || !item.trim()) {
+            return [null, badRequest(`${name} must contain only non-empty strings.`)];
+        }
+        out.push(item.trim());
+    }
+    return [out, null];
+}
+export function jsonQueryList(value, name) {
+    const [items, error] = coerceList(value, name);
+    if (error || items === null) {
+        return [null, error];
+    }
+    const encoded = [];
+    for (const item of items) {
+        if (typeof item === "string") {
+            const stripped = item.trim();
+            if (stripped.startsWith("{") || stripped.startsWith("[")) {
+                const [parsed, parseError] = coerceJson(stripped, name);
+                if (parseError) {
+                    return [null, parseError];
+                }
+                encoded.push(JSON.stringify(parsed));
+            }
+            else {
+                encoded.push(stripped);
+            }
+        }
+        else if (isRecord(item)) {
+            encoded.push(JSON.stringify(item));
+        }
+        else {
+            return [null, badRequest(`${name} must contain strings or objects.`)];
+        }
+    }
+    return [encoded, null];
+}
+export function optionalParams(input) {
+    return Object.fromEntries(Object.entries(input).filter(([, value]) => value !== undefined && value !== null));
+}
+export function usdToMicros(value) {
+    return Math.round(value * 1_000_000);
+}
+export function budgetGuard(budgetUsd, confirmBudget) {
+    if (budgetUsd < 1) {
+        return badRequest("budget_usd must be at least 1.00 USD.");
+    }
+    const ceiling = budgetCeilingUsd();
+    if (budgetUsd > ceiling && !confirmBudget) {
+        return badRequest(`budget_usd is ${formatNumber(budgetUsd)}, above the configured ceiling of ${formatNumber(ceiling)} USD. ` +
+            "Pass confirm_budget=True to confirm this spend limit.");
+    }
+    return null;
+}
+export function validateUnixTime(name, value) {
+    if (value === undefined || value === null) {
+        return null;
+    }
+    return validateIntRange(name, Number(value), 946684800, 4102444800);
+}
+export function extractId(value, ...keys) {
+    for (const key of keys) {
+        const item = value[key];
+        if (typeof item === "string" && item) {
+            return item;
+        }
+    }
+    return null;
+}
+export function nowMs() {
+    return Date.now();
+}
+export function conversionTimeBoundsMs() {
+    const now = Date.now();
+    return [now - 7 * 24 * 60 * 60 * 1000, now + 10 * 60 * 1000];
+}
+export function isRecord(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function formatNumber(value) {
+    return Number.isInteger(value) ? String(value) : String(value);
+}
+//# sourceMappingURL=core.js.map

package/dist/core.js.map

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

package/dist/helpers.d.ts

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