@cesteral/gads-mcp 1.0.0

package/dist/config/index.d.ts

@@ -0,0 +1,100 @@
+import { z } from "zod";
+declare const ConfigSchema: z.ZodObject<{
+    host: z.ZodDefault<z.ZodString>;
+    nodeEnv: z.ZodDefault<z.ZodEnum<["development", "production", "test"]>>;
+    mcpStatefulSessionTimeoutMs: z.ZodDefault<z.ZodNumber>;
+    mcpAuthSecretKey: z.ZodOptional<z.ZodString>;
+    mcpAllowedOrigins: z.ZodOptional<z.ZodString>;
+    logLevel: z.ZodDefault<z.ZodEnum<["debug", "info", "notice", "warning", "error"]>>;
+    mcpLogLevel: z.ZodDefault<z.ZodEnum<["debug", "info", "notice", "warning", "error"]>>;
+    otelEnabled: z.ZodDefault<z.ZodBoolean>;
+    otelExporterOtlpTracesEndpoint: z.ZodOptional<z.ZodString>;
+    otelExporterOtlpMetricsEndpoint: z.ZodOptional<z.ZodString>;
+    gcsBucketName: z.ZodOptional<z.ZodString>;
+} & {
+    serviceName: z.ZodDefault<z.ZodString>;
+    port: z.ZodDefault<z.ZodNumber>;
+    otelServiceName: z.ZodDefault<z.ZodString>;
+    mcpAuthMode: z.ZodDefault<z.ZodEnum<["gads-headers", "jwt", "none"]>>;
+    gadsApiBaseUrl: z.ZodDefault<z.ZodString>;
+    gadsRateLimitPerMinute: z.ZodDefault<z.ZodNumber>;
+    gadsDeveloperToken: z.ZodOptional<z.ZodString>;
+    gadsClientId: z.ZodOptional<z.ZodString>;
+    gadsClientSecret: z.ZodOptional<z.ZodString>;
+    gadsRefreshToken: z.ZodOptional<z.ZodString>;
+    gadsLoginCustomerId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    serviceName: string;
+    port: number;
+    otelServiceName: string;
+    mcpAuthMode: "gads-headers" | "jwt" | "none";
+    gadsApiBaseUrl: string;
+    gadsRateLimitPerMinute: number;
+    host: string;
+    nodeEnv: "development" | "production" | "test";
+    mcpStatefulSessionTimeoutMs: number;
+    logLevel: "debug" | "info" | "notice" | "warning" | "error";
+    mcpLogLevel: "debug" | "info" | "notice" | "warning" | "error";
+    otelEnabled: boolean;
+    gadsDeveloperToken?: string | undefined;
+    gadsClientId?: string | undefined;
+    gadsClientSecret?: string | undefined;
+    gadsRefreshToken?: string | undefined;
+    gadsLoginCustomerId?: string | undefined;
+    mcpAuthSecretKey?: string | undefined;
+    mcpAllowedOrigins?: string | undefined;
+    otelExporterOtlpTracesEndpoint?: string | undefined;
+    otelExporterOtlpMetricsEndpoint?: string | undefined;
+    gcsBucketName?: string | undefined;
+}, {
+    serviceName?: string | undefined;
+    port?: number | undefined;
+    otelServiceName?: string | undefined;
+    mcpAuthMode?: "gads-headers" | "jwt" | "none" | undefined;
+    gadsApiBaseUrl?: string | undefined;
+    gadsRateLimitPerMinute?: number | undefined;
+    gadsDeveloperToken?: string | undefined;
+    gadsClientId?: string | undefined;
+    gadsClientSecret?: string | undefined;
+    gadsRefreshToken?: string | undefined;
+    gadsLoginCustomerId?: string | undefined;
+    host?: string | undefined;
+    nodeEnv?: "development" | "production" | "test" | undefined;
+    mcpStatefulSessionTimeoutMs?: number | undefined;
+    mcpAuthSecretKey?: string | undefined;
+    mcpAllowedOrigins?: string | undefined;
+    logLevel?: "debug" | "info" | "notice" | "warning" | "error" | undefined;
+    mcpLogLevel?: "debug" | "info" | "notice" | "warning" | "error" | undefined;
+    otelEnabled?: boolean | undefined;
+    otelExporterOtlpTracesEndpoint?: string | undefined;
+    otelExporterOtlpMetricsEndpoint?: string | undefined;
+    gcsBucketName?: string | undefined;
+}>;
+export type AppConfig = z.infer<typeof ConfigSchema>;
+export declare function parseConfig(): AppConfig;
+export declare const mcpConfig: {
+    serviceName: string;
+    port: number;
+    otelServiceName: string;
+    mcpAuthMode: "gads-headers" | "jwt" | "none";
+    gadsApiBaseUrl: string;
+    gadsRateLimitPerMinute: number;
+    host: string;
+    nodeEnv: "development" | "production" | "test";
+    mcpStatefulSessionTimeoutMs: number;
+    logLevel: "debug" | "info" | "notice" | "warning" | "error";
+    mcpLogLevel: "debug" | "info" | "notice" | "warning" | "error";
+    otelEnabled: boolean;
+    gadsDeveloperToken?: string | undefined;
+    gadsClientId?: string | undefined;
+    gadsClientSecret?: string | undefined;
+    gadsRefreshToken?: string | undefined;
+    gadsLoginCustomerId?: string | undefined;
+    mcpAuthSecretKey?: string | undefined;
+    mcpAllowedOrigins?: string | undefined;
+    otelExporterOtlpTracesEndpoint?: string | undefined;
+    otelExporterOtlpMetricsEndpoint?: string | undefined;
+    gcsBucketName?: string | undefined;
+};
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAYxB,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsBhB,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAErD,wBAAgB,WAAW,IAAI,SAAS,CA0BvC;AAED,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;CAAgB,CAAC"}

package/dist/config/index.js

@@ -0,0 +1,37 @@
+import { z } from "zod";
+import { loadDotEnv, BaseConfigSchema, getBaseEnvConfig, parseConfigWithSchema, getDefaultHost, } from "@cesteral/shared";
+loadDotEnv();
+const ConfigSchema = BaseConfigSchema.extend({
+    serviceName: z.string().default("gads-mcp"),
+    port: z.number().int().min(1).max(65535).default(3004),
+    otelServiceName: z.string().default("gads-mcp"),
+    mcpAuthMode: z.enum(["gads-headers", "jwt", "none"]).default("gads-headers"),
+    gadsApiBaseUrl: z.string().url().default("https://googleads.googleapis.com/v23"),
+    gadsRateLimitPerMinute: z.number().default(10),
+    gadsDeveloperToken: z.string().optional(),
+    gadsClientId: z.string().optional(),
+    gadsClientSecret: z.string().optional(),
+    gadsRefreshToken: z.string().optional(),
+    gadsLoginCustomerId: z.string().optional(),
+});
+export function parseConfig() {
+    const defaultHost = getDefaultHost();
+    const rawConfig = {
+        ...getBaseEnvConfig(defaultHost),
+        serviceName: process.env.SERVICE_NAME,
+        ...(process.env.GADS_MCP_PORT ? { port: Number(process.env.GADS_MCP_PORT) } : {}),
+        host: process.env.GADS_MCP_HOST || defaultHost,
+        gadsApiBaseUrl: process.env.GADS_API_BASE_URL,
+        gadsRateLimitPerMinute: process.env.GADS_RATE_LIMIT_PER_MINUTE
+            ? Number(process.env.GADS_RATE_LIMIT_PER_MINUTE)
+            : undefined,
+        gadsDeveloperToken: process.env.GADS_DEVELOPER_TOKEN,
+        gadsClientId: process.env.GADS_CLIENT_ID,
+        gadsClientSecret: process.env.GADS_CLIENT_SECRET,
+        gadsRefreshToken: process.env.GADS_REFRESH_TOKEN,
+        gadsLoginCustomerId: process.env.GADS_LOGIN_CUSTOMER_ID,
+    };
+    return parseConfigWithSchema(ConfigSchema, rawConfig);
+}
+export const mcpConfig = parseConfig();
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,cAAc,GACf,MAAM,kBAAkB,CAAC;AAG1B,UAAU,EAAE,CAAC;AAEb,MAAM,YAAY,GAAG,gBAAgB,CAAC,MAAM,CAAC;IAE3C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC;IAC3C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;IACtD,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC;IAG/C,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,cAAc,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC;IAG5E,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,sCAAsC,CAAC;IAIhF,sBAAsB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IAG9C,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACzC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACnC,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACvC,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACvC,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC3C,CAAC,CAAC;AAIH,MAAM,UAAU,WAAW;IACzB,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IAErC,MAAM,SAAS,GAA4B;QACzC,GAAG,gBAAgB,CAAC,WAAW,CAAC;QAGhC,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,YAAY;QACrC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjF,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,WAAW;QAG9C,cAAc,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB;QAC7C,sBAAsB,EAAE,OAAO,CAAC,GAAG,CAAC,0BAA0B;YAC5D,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC;YAChD,CAAC,CAAC,SAAS;QAGb,kBAAkB,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB;QACpD,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc;QACxC,gBAAgB,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB;QAChD,gBAAgB,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB;QAChD,mBAAmB,EAAE,OAAO,CAAC,GAAG,CAAC,sBAAsB;KACxD,CAAC;IAEF,OAAO,qBAAqB,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,CAAC,MAAM,SAAS,GAAG,WAAW,EAAE,CAAC"}

package/dist/container/index.d.ts

@@ -0,0 +1,5 @@
+import "reflect-metadata";
+import type { Logger } from "pino";
+export declare function composeContainer(logger?: Logger): void;
+export * as Tokens from "./tokens.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/container/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/container/index.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAMnC,wBAAgB,gBAAgB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAStD;AAED,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC"}

package/dist/container/index.js

@@ -0,0 +1,14 @@
+import "reflect-metadata";
+import { registerCoreServices } from "./registrations/core.js";
+import { registerMcpServices } from "./registrations/mcp.js";
+let isContainerComposed = false;
+export function composeContainer(logger) {
+    if (isContainerComposed) {
+        return;
+    }
+    registerCoreServices(logger);
+    registerMcpServices();
+    isContainerComposed = true;
+}
+export * as Tokens from "./tokens.js";
+//# sourceMappingURL=index.js.map

package/dist/container/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/container/index.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAE7D,IAAI,mBAAmB,GAAG,KAAK,CAAC;AAEhC,MAAM,UAAU,gBAAgB,CAAC,MAAe;IAC9C,IAAI,mBAAmB,EAAE,CAAC;QACxB,OAAO;IACT,CAAC;IAED,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,mBAAmB,EAAE,CAAC;IAEtB,mBAAmB,GAAG,IAAI,CAAC;AAC7B,CAAC;AAED,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC"}

package/dist/container/registrations/core.d.ts

@@ -0,0 +1,3 @@
+import type { Logger } from "pino";
+export declare function registerCoreServices(logger?: Logger): void;
+//# sourceMappingURL=core.d.ts.map

package/dist/container/registrations/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../src/container/registrations/core.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAOnC,wBAAgB,oBAAoB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAS1D"}

package/dist/container/registrations/core.js

@@ -0,0 +1,14 @@
+import { container } from "tsyringe";
+import { createLogger } from "@cesteral/shared";
+import { appConfig } from "../../config/index.js";
+import * as Tokens from "../tokens.js";
+import { rateLimiter } from "../../utils/security/rate-limiter.js";
+import { requestContextService } from "@cesteral/shared";
+export function registerCoreServices(logger) {
+    container.register(Tokens.AppConfig, { useValue: appConfig });
+    const loggerInstance = logger || createLogger("gads-mcp");
+    container.register(Tokens.Logger, { useValue: loggerInstance });
+    container.register(Tokens.RequestContextService, { useValue: requestContextService });
+    container.register(Tokens.RateLimiterService, { useValue: rateLimiter });
+}
+//# sourceMappingURL=core.js.map

package/dist/container/registrations/core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../../../src/container/registrations/core.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAErC,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,KAAK,MAAM,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AACnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,MAAM,UAAU,oBAAoB,CAAC,MAAe;IAClD,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC;IAE9D,MAAM,cAAc,GAAG,MAAM,IAAI,YAAY,CAAC,UAAU,CAAC,CAAC;IAC1D,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,cAAc,EAAE,CAAC,CAAC;IAEhE,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,qBAAqB,EAAE,EAAE,QAAQ,EAAE,qBAAqB,EAAE,CAAC,CAAC;IAEtF,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,kBAAkB,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC;AAC3E,CAAC"}

package/dist/container/registrations/mcp.d.ts

@@ -0,0 +1,2 @@
+export declare function registerMcpServices(): void;
+//# sourceMappingURL=mcp.d.ts.map

package/dist/container/registrations/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../../src/container/registrations/mcp.ts"],"names":[],"mappings":"AAGA,wBAAgB,mBAAmB,IAAI,IAAI,CAI1C"}

package/dist/container/registrations/mcp.js

@@ -0,0 +1,3 @@
+export function registerMcpServices() {
+}
+//# sourceMappingURL=mcp.js.map

package/dist/container/registrations/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../../src/container/registrations/mcp.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,mBAAmB;AAInC,CAAC"}

package/dist/container/tokens.d.ts

@@ -0,0 +1,6 @@
+export declare const AppConfig: unique symbol;
+export declare const Logger: unique symbol;
+export declare const RateLimiterService: unique symbol;
+export declare const RequestContextService: unique symbol;
+export declare const ResourceRegistry: unique symbol;
+//# sourceMappingURL=tokens.d.ts.map

package/dist/container/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../src/container/tokens.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,SAAS,eAAsB,CAAC;AAC7C,eAAO,MAAM,MAAM,eAAmB,CAAC;AAGvC,eAAO,MAAM,kBAAkB,eAA+B,CAAC;AAC/D,eAAO,MAAM,qBAAqB,eAAkC,CAAC;AAGrE,eAAO,MAAM,gBAAgB,eAA6B,CAAC"}

package/dist/container/tokens.js

@@ -0,0 +1,6 @@
+export const AppConfig = Symbol("AppConfig");
+export const Logger = Symbol("Logger");
+export const RateLimiterService = Symbol("RateLimiterService");
+export const RequestContextService = Symbol("RequestContextService");
+export const ResourceRegistry = Symbol("ResourceRegistry");
+//# sourceMappingURL=tokens.js.map

package/dist/container/tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../../src/container/tokens.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,SAAS,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;AAC7C,MAAM,CAAC,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;AAGvC,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,oBAAoB,CAAC,CAAC;AAC/D,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC,uBAAuB,CAAC,CAAC;AAGrE,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,kBAAkB,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+import { mcpConfig } from "./config/index.js";
+import { createMcpServer, runStdioServer } from "./mcp-server/server.js";
+import { startHttpServer } from "./mcp-server/transports/streamable-http-transport.js";
+import { initializeOpenTelemetry, otelLogMixin } from "@cesteral/shared";
+import { GAdsRefreshTokenAuthAdapter } from "./auth/gads-auth-adapter.js";
+import { detectTransportMode, createServerLogger, bootstrapMcpServer } from "@cesteral/shared";
+import { createSessionServices, sessionServiceStore } from "./services/session-services.js";
+import { rateLimiter } from "./utils/platform.js";
+const transportMode = detectTransportMode();
+const logger = createServerLogger("gads-mcp", transportMode, otelLogMixin());
+async function setupStdioCredentials(sessionId) {
+    const developerToken = mcpConfig.gadsDeveloperToken;
+    const clientId = mcpConfig.gadsClientId;
+    const clientSecret = mcpConfig.gadsClientSecret;
+    const refreshToken = mcpConfig.gadsRefreshToken;
+    if (!developerToken || !clientId || !clientSecret || !refreshToken) {
+        logger.warn("No Google Ads credentials found in env vars. " +
+            "Set GADS_DEVELOPER_TOKEN, GADS_CLIENT_ID, GADS_CLIENT_SECRET, and GADS_REFRESH_TOKEN for stdio mode.");
+        return false;
+    }
+    const authAdapter = new GAdsRefreshTokenAuthAdapter({
+        developerToken,
+        clientId,
+        clientSecret,
+        refreshToken,
+        loginCustomerId: mcpConfig.gadsLoginCustomerId,
+    });
+    await authAdapter.validate();
+    const services = createSessionServices(authAdapter, { baseUrl: mcpConfig.gadsApiBaseUrl }, logger, rateLimiter);
+    sessionServiceStore.set(sessionId, services);
+    logger.info("Stdio session services created successfully");
+    return true;
+}
+bootstrapMcpServer({
+    serviceName: "gads-mcp",
+    config: mcpConfig,
+    logger,
+    transportMode,
+    initOtel: initializeOpenTelemetry,
+    setupStdioSession: setupStdioCredentials,
+    createMcpServer,
+    runStdio: runStdioServer,
+    startHttp: startHttpServer,
+    onShutdown: () => rateLimiter.destroy(),
+}).catch((err) => {
+    logger.fatal({ err }, "Failed to start gads-mcp");
+    process.exit(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":";AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,sDAAsD,CAAC;AACvF,OAAO,EAAE,uBAAuB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAC1E,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC/F,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAC5F,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,MAAM,aAAa,GAAG,mBAAmB,EAAE,CAAC;AAC5C,MAAM,MAAM,GAAG,kBAAkB,CAAC,UAAU,EAAE,aAAa,EAAE,YAAY,EAAE,CAAC,CAAC;AAM7E,KAAK,UAAU,qBAAqB,CAAC,SAAiB;IACpD,MAAM,cAAc,GAAG,SAAS,CAAC,kBAAkB,CAAC;IACpD,MAAM,QAAQ,GAAG,SAAS,CAAC,YAAY,CAAC;IACxC,MAAM,YAAY,GAAG,SAAS,CAAC,gBAAgB,CAAC;IAChD,MAAM,YAAY,GAAG,SAAS,CAAC,gBAAgB,CAAC;IAEhD,IAAI,CAAC,cAAc,IAAI,CAAC,QAAQ,IAAI,CAAC,YAAY,IAAI,CAAC,YAAY,EAAE,CAAC;QACnE,MAAM,CAAC,IAAI,CACT,+CAA+C;YAC7C,sGAAsG,CACzG,CAAC;QACF,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,2BAA2B,CAAC;QAClD,cAAc;QACd,QAAQ;QACR,YAAY;QACZ,YAAY;QACZ,eAAe,EAAE,SAAS,CAAC,mBAAmB;KAC/C,CAAC,CAAC;IAGH,MAAM,WAAW,CAAC,QAAQ,EAAE,CAAC;IAE7B,MAAM,QAAQ,GAAG,qBAAqB,CACpC,WAAW,EACX,EAAE,OAAO,EAAE,SAAS,CAAC,cAAc,EAAE,EACrC,MAAM,EACN,WAAW,CACZ,CAAC;IAEF,mBAAmB,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC7C,MAAM,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;IAC3D,OAAO,IAAI,CAAC;AACd,CAAC;AAED,kBAAkB,CAAC;IACjB,WAAW,EAAE,UAAU;IACvB,MAAM,EAAE,SAAS;IACjB,MAAM;IACN,aAAa;IACb,QAAQ,EAAE,uBAAuB;IACjC,iBAAiB,EAAE,qBAAqB;IACxC,eAAe;IACf,QAAQ,EAAE,cAAc;IACxB,SAAS,EAAE,eAAe;IAC1B,UAAU,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE;CACxC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACf,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,EAAE,0BAA0B,CAAC,CAAC;IAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.d.ts

@@ -0,0 +1,4 @@
+import type { Prompt } from "@modelcontextprotocol/sdk/types.js";
+export declare const bulkOperationsWorkflowPrompt: Prompt;
+export declare function getBulkOperationsWorkflowMessage(args?: Record<string, string>): string;
+//# sourceMappingURL=bulk-operations-workflow.prompt.d.ts.map

package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulk-operations-workflow.prompt.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAQjE,eAAO,MAAM,4BAA4B,EAAE,MAgB1C,CAAC;AAEF,wBAAgB,gCAAgC,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAqNtF"}

package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.js

@@ -0,0 +1,230 @@
+export const bulkOperationsWorkflowPrompt = {
+    name: "gads_bulk_operations_workflow",
+    description: "Step-by-step guide for Google Ads bulk operations: batch mutate (create+update+remove), batch status changes, batch bid adjustments, and entity removal. Covers atomic vs partial failure, micros conversion, and verification.",
+    arguments: [
+        {
+            name: "customerId",
+            description: "Google Ads customer ID (no dashes)",
+            required: true,
+        },
+        {
+            name: "operation",
+            description: "Operation type: 'mutate', 'status', 'bids', or 'remove' (default: status)",
+            required: false,
+        },
+    ],
+};
+export function getBulkOperationsWorkflowMessage(args) {
+    const customerId = args?.customerId || "{customerId}";
+    const operation = args?.operation || "status";
+    return `# Google Ads Bulk Operations Workflow
+
+Customer ID: \`${customerId}\`
+Operation: \`${operation}\`
+
+---
+
+## Overview
+
+Google Ads supports these bulk operation tools:
+
+| Tool | Purpose | Max Items | Default Behavior |
+|------|---------|-----------|-----------------|
+| \`gads_bulk_mutate\` | Multi-operation mutate (create+update+remove) | 5,000 | Atomic (all-or-nothing) |
+| \`gads_bulk_update_status\` | Batch enable/pause/remove entities | 100 | Partial success |
+| \`gads_adjust_bids\` | Batch adjust ad group CPC/CPM bids | 50 | Per-item results |
+| \`gads_remove_entity\` | Remove a single entity | 1 | N/A |
+
+---
+
+## Bulk Status Updates
+
+The simplest bulk operation. Use to enable, pause, or remove multiple entities.
+
+### Step 1: Identify Entities
+
+\`\`\`json
+{
+  "tool": "gads_list_entities",
+  "params": {
+    "entityType": "adGroup",
+    "customerId": "${customerId}",
+    "filters": "campaign.id = {campaignId}"
+  }
+}
+\`\`\`
+
+### Step 2: Execute Status Change
+
+\`\`\`json
+{
+  "tool": "gads_bulk_update_status",
+  "params": {
+    "entityType": "adGroup",
+    "customerId": "${customerId}",
+    "entityIds": ["{adGroupId1}", "{adGroupId2}", "{adGroupId3}"],
+    "status": "PAUSED"
+  }
+}
+\`\`\`
+
+Valid statuses:
+- \`ENABLED\` — active and eligible for delivery
+- \`PAUSED\` — temporarily stopped, can be re-enabled
+- \`REMOVED\` — permanently removed, **cannot be un-removed**
+
+⚠️ **GOTCHA**: \`REMOVED\` is permanent and irreversible. Always prefer \`PAUSED\` unless you truly want to delete. Entity data is retained but the entity becomes permanently inactive.
+
+### Step 3: Review Results
+
+Check \`results\` array for per-entity success/failure, \`totalSucceeded\` / \`totalFailed\` counts.
+
+---
+
+## Bulk Mutate (Create + Update + Remove)
+
+The most powerful bulk tool — execute mixed operations in a single call.
+
+### Step 1: Fetch Schemas
+
+**Resource:** \`entity-schema://{entityType}\` and \`entity-examples://{entityType}\`
+
+### Step 2: Build Operations
+
+Each operation must be exactly ONE of: \`create\`, \`update\`, or \`remove\`.
+
+\`\`\`json
+{
+  "tool": "gads_bulk_mutate",
+  "params": {
+    "entityType": "adGroup",
+    "customerId": "${customerId}",
+    "operations": [
+      {
+        "create": {
+          "name": "New Ad Group - US",
+          "campaign": "customers/${customerId}/campaigns/{campaignId}",
+          "status": "PAUSED",
+          "type": "SEARCH_STANDARD",
+          "cpcBidMicros": "2000000"
+        }
+      },
+      {
+        "update": {
+          "resourceName": "customers/${customerId}/adGroups/{adGroupId}",
+          "cpcBidMicros": "2500000"
+        },
+        "updateMask": "cpcBidMicros"
+      },
+      {
+        "remove": "customers/${customerId}/adGroups/{oldAdGroupId}"
+      }
+    ],
+    "partialFailure": true
+  }
+}
+\`\`\`
+
+### Atomic vs Partial Failure
+
+- **\`partialFailure: false\`** (default): All operations succeed or all fail. Use when operations are interdependent.
+- **\`partialFailure: true\`**: Each operation succeeds or fails independently. Use for batch processing where individual failures are acceptable.
+
+⚠️ **GOTCHA**: The \`updateMask\` must exactly match the fields in the \`update\` object. Missing fields in the mask = fields not updated.
+
+⚠️ **GOTCHA**: \`resourceName\` format is \`customers/{customerId}/{entityType}/{entityId}\`. Entity type in resource name is plural (e.g., \`adGroups\`, \`campaigns\`, \`ads\`).
+
+---
+
+## Batch Bid Adjustments
+
+### Step 1: Review Current Bids
+
+\`\`\`json
+{
+  "tool": "gads_list_entities",
+  "params": {
+    "entityType": "adGroup",
+    "customerId": "${customerId}",
+    "filters": "campaign.id = {campaignId}"
+  }
+}
+\`\`\`
+
+### Step 2: Calculate New Bids
+
+All Google Ads bid amounts are in **micros**: 1,000,000 micros = $1.00 USD.
+
+| Current Bid | Micros | +20% | New Micros |
+|---|---|---|---|
+| $2.00 CPC | 2,000,000 | $2.40 | 2,400,000 |
+| $5.00 CPM | 5,000,000 | $6.00 | 6,000,000 |
+
+### Step 3: Execute
+
+\`\`\`json
+{
+  "tool": "gads_adjust_bids",
+  "params": {
+    "customerId": "${customerId}",
+    "adjustments": [
+      {
+        "adGroupId": "{adGroupId1}",
+        "cpcBidMicros": "2400000"
+      },
+      {
+        "adGroupId": "{adGroupId2}",
+        "cpcBidMicros": "3000000",
+        "cpmBidMicros": "6000000"
+      }
+    ],
+    "reason": "Increasing bids on top-performing ad groups by 20%"
+  }
+}
+\`\`\`
+
+### Step 4: Verify
+
+Each successful adjustment shows \`previousCpcBidMicros\` / \`previousCpmBidMicros\` and new values.
+
+⚠️ **GOTCHA**: Bid values must be strings (e.g., \`"2400000"\`), not numbers. The Google Ads API uses string representation for micros.
+
+⚠️ **GOTCHA**: At least one of \`cpcBidMicros\` or \`cpmBidMicros\` must be provided per adjustment.
+
+---
+
+## Entity Removal
+
+For removing a single entity:
+
+\`\`\`json
+{
+  "tool": "gads_remove_entity",
+  "params": {
+    "entityType": "keyword",
+    "customerId": "${customerId}",
+    "entityId": "{keywordId}"
+  }
+}
+\`\`\`
+
+For bulk removal, use \`gads_bulk_mutate\` with \`remove\` operations, or \`gads_bulk_update_status\` with status \`REMOVED\`.
+
+⚠️ **GOTCHA**: Removal is permanent. For campaigns and ad groups, prefer \`PAUSED\` status instead of removing.
+
+---
+
+## Safety Checklist
+
+- [ ] Correct \`customerId\` (no dashes)
+- [ ] Entity IDs verified by listing first
+- [ ] Bid amounts in micros (not dollars) — multiply by 1,000,000
+- [ ] Bid values as strings, not numbers
+- [ ] For updates: \`updateMask\` matches fields exactly
+- [ ] For removes: confirmed permanence with user
+- [ ] \`partialFailure\` flag set appropriately (atomic vs independent)
+- [ ] Resource names use correct plural entity type format
+- [ ] For \`gads_bulk_mutate\`: keep operation count under 100 for best performance (API supports 5,000 but latency degrades significantly above 100)
+`;
+}
+//# sourceMappingURL=bulk-operations-workflow.prompt.js.map

package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulk-operations-workflow.prompt.js","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.ts"],"names":[],"mappings":"AAWA,MAAM,CAAC,MAAM,4BAA4B,GAAW;IAClD,IAAI,EAAE,+BAA+B;IACrC,WAAW,EACT,iOAAiO;IACnO,SAAS,EAAE;QACT;YACE,IAAI,EAAE,YAAY;YAClB,WAAW,EAAE,oCAAoC;YACjD,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,WAAW;YACjB,WAAW,EAAE,2EAA2E;YACxF,QAAQ,EAAE,KAAK;SAChB;KACF;CACF,CAAC;AAEF,MAAM,UAAU,gCAAgC,CAAC,IAA6B;IAC5E,MAAM,UAAU,GAAG,IAAI,EAAE,UAAU,IAAI,cAAc,CAAC;IACtD,MAAM,SAAS,GAAG,IAAI,EAAE,SAAS,IAAI,QAAQ,CAAC;IAE9C,OAAO;;iBAEQ,UAAU;eACZ,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBA4BH,UAAU;;;;;;;;;;;;;qBAaV,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAqCV,UAAU;;;;;mCAKI,UAAU;;;;;;;;uCAQN,UAAU;;;;;;+BAMlB,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBA4BpB,UAAU;;;;;;;;;;;;;;;;;;;;;qBAqBV,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAoCV,UAAU;;;;;;;;;;;;;;;;;;;;;;;CAuB9B,CAAC;AACF,CAAC"}

package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.d.ts

@@ -0,0 +1,4 @@
+import type { Prompt } from "@modelcontextprotocol/sdk/types.js";
+export declare const campaignSetupWorkflowPrompt: Prompt;
+export declare function getCampaignSetupWorkflowMessage(args?: Record<string, string>): string;
+//# sourceMappingURL=campaign-setup-workflow.prompt.d.ts.map

package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"campaign-setup-workflow.prompt.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAEjE,eAAO,MAAM,2BAA2B,EAAE,MAWzC,CAAC;AAEF,wBAAgB,+BAA+B,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAiOrF"}