@cesteral/amazon-dsp-mcp 1.0.0

package/dist/config/index.d.ts

@@ -0,0 +1,116 @@
+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<["amazon-dsp-bearer", "jwt", "none"]>>;
+    amazonDspApiBaseUrl: z.ZodDefault<z.ZodString>;
+    amazonDspApiVersion: z.ZodDefault<z.ZodString>;
+    amazonDspRateLimitPerMinute: z.ZodDefault<z.ZodNumber>;
+    amazonDspAccessToken: z.ZodOptional<z.ZodString>;
+    amazonDspProfileId: z.ZodOptional<z.ZodString>;
+    amazonDspClientId: z.ZodOptional<z.ZodString>;
+    amazonDspAppId: z.ZodOptional<z.ZodString>;
+    amazonDspAppSecret: z.ZodOptional<z.ZodString>;
+    amazonDspRefreshToken: z.ZodOptional<z.ZodString>;
+    amazonDspReportPollIntervalMs: z.ZodDefault<z.ZodNumber>;
+    amazonDspReportMaxPollAttempts: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    serviceName: string;
+    port: number;
+    otelServiceName: string;
+    mcpAuthMode: "amazon-dsp-bearer" | "jwt" | "none";
+    amazonDspApiBaseUrl: string;
+    amazonDspApiVersion: string;
+    amazonDspRateLimitPerMinute: number;
+    amazonDspReportPollIntervalMs: number;
+    amazonDspReportMaxPollAttempts: number;
+    host: string;
+    nodeEnv: "development" | "production" | "test";
+    mcpStatefulSessionTimeoutMs: number;
+    logLevel: "debug" | "info" | "notice" | "warning" | "error";
+    mcpLogLevel: "debug" | "info" | "notice" | "warning" | "error";
+    otelEnabled: boolean;
+    amazonDspAccessToken?: string | undefined;
+    amazonDspProfileId?: string | undefined;
+    amazonDspClientId?: string | undefined;
+    amazonDspAppId?: string | undefined;
+    amazonDspAppSecret?: string | undefined;
+    amazonDspRefreshToken?: 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?: "amazon-dsp-bearer" | "jwt" | "none" | undefined;
+    amazonDspApiBaseUrl?: string | undefined;
+    amazonDspApiVersion?: string | undefined;
+    amazonDspRateLimitPerMinute?: number | undefined;
+    amazonDspAccessToken?: string | undefined;
+    amazonDspProfileId?: string | undefined;
+    amazonDspClientId?: string | undefined;
+    amazonDspAppId?: string | undefined;
+    amazonDspAppSecret?: string | undefined;
+    amazonDspRefreshToken?: string | undefined;
+    amazonDspReportPollIntervalMs?: number | undefined;
+    amazonDspReportMaxPollAttempts?: number | 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: "amazon-dsp-bearer" | "jwt" | "none";
+    amazonDspApiBaseUrl: string;
+    amazonDspApiVersion: string;
+    amazonDspRateLimitPerMinute: number;
+    amazonDspReportPollIntervalMs: number;
+    amazonDspReportMaxPollAttempts: number;
+    host: string;
+    nodeEnv: "development" | "production" | "test";
+    mcpStatefulSessionTimeoutMs: number;
+    logLevel: "debug" | "info" | "notice" | "warning" | "error";
+    mcpLogLevel: "debug" | "info" | "notice" | "warning" | "error";
+    otelEnabled: boolean;
+    amazonDspAccessToken?: string | undefined;
+    amazonDspProfileId?: string | undefined;
+    amazonDspClientId?: string | undefined;
+    amazonDspAppId?: string | undefined;
+    amazonDspAppSecret?: string | undefined;
+    amazonDspRefreshToken?: 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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8BhB,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAErD,wBAAgB,WAAW,IAAI,SAAS,CAsCvC;AAED,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAgB,CAAC"}

package/dist/config/index.js

@@ -0,0 +1,49 @@
+import { z } from "zod";
+import { loadDotEnv, BaseConfigSchema, getBaseEnvConfig, parseConfigWithSchema, getDefaultHost, } from "@cesteral/shared";
+loadDotEnv();
+const ConfigSchema = BaseConfigSchema.extend({
+    serviceName: z.string().default("amazon-dsp-mcp"),
+    port: z.number().int().min(1).max(65535).default(3012),
+    otelServiceName: z.string().default("amazon-dsp-mcp"),
+    mcpAuthMode: z.enum(["amazon-dsp-bearer", "jwt", "none"]).default("amazon-dsp-bearer"),
+    amazonDspApiBaseUrl: z.string().url().default("https://advertising-api.amazon.com"),
+    amazonDspApiVersion: z.string().default("dsp"),
+    amazonDspRateLimitPerMinute: z.number().default(10),
+    amazonDspAccessToken: z.string().optional(),
+    amazonDspProfileId: z.string().optional(),
+    amazonDspClientId: z.string().optional(),
+    amazonDspAppId: z.string().optional(),
+    amazonDspAppSecret: z.string().optional(),
+    amazonDspRefreshToken: z.string().optional(),
+    amazonDspReportPollIntervalMs: z.number().default(2_000),
+    amazonDspReportMaxPollAttempts: z.number().default(30),
+});
+export function parseConfig() {
+    const defaultHost = getDefaultHost();
+    const rawConfig = {
+        ...getBaseEnvConfig(defaultHost),
+        serviceName: process.env.SERVICE_NAME,
+        ...(process.env.AMAZON_DSP_MCP_PORT ? { port: Number(process.env.AMAZON_DSP_MCP_PORT) } : {}),
+        host: process.env.AMAZON_DSP_MCP_HOST || defaultHost,
+        amazonDspApiBaseUrl: process.env.AMAZON_DSP_API_BASE_URL,
+        amazonDspApiVersion: process.env.AMAZON_DSP_API_VERSION,
+        amazonDspRateLimitPerMinute: process.env.AMAZON_DSP_RATE_LIMIT_PER_MINUTE
+            ? Number(process.env.AMAZON_DSP_RATE_LIMIT_PER_MINUTE)
+            : undefined,
+        amazonDspAccessToken: process.env.AMAZON_DSP_ACCESS_TOKEN,
+        amazonDspProfileId: process.env.AMAZON_DSP_PROFILE_ID,
+        amazonDspClientId: process.env.AMAZON_DSP_CLIENT_ID,
+        amazonDspAppId: process.env.AMAZON_DSP_APP_ID,
+        amazonDspAppSecret: process.env.AMAZON_DSP_APP_SECRET,
+        amazonDspRefreshToken: process.env.AMAZON_DSP_REFRESH_TOKEN,
+        amazonDspReportPollIntervalMs: process.env.AMAZON_DSP_REPORT_POLL_INTERVAL_MS
+            ? Number(process.env.AMAZON_DSP_REPORT_POLL_INTERVAL_MS)
+            : undefined,
+        amazonDspReportMaxPollAttempts: process.env.AMAZON_DSP_REPORT_MAX_POLL_ATTEMPTS
+            ? Number(process.env.AMAZON_DSP_REPORT_MAX_POLL_ATTEMPTS)
+            : undefined,
+    };
+    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":"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"}

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,65 @@
+#!/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 { AmazonDspAccessTokenAdapter, AmazonDspRefreshTokenAdapter, } from "./auth/amazon-dsp-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("amazon-dsp-mcp", transportMode, otelLogMixin());
+async function setupStdioCredentials(sessionId) {
+    const profileId = mcpConfig.amazonDspProfileId;
+    if (!profileId) {
+        logger.warn("No AmazonDsp credentials found in env vars. " +
+            "Set AMAZON_DSP_PROFILE_ID plus either (AMAZON_DSP_APP_ID + AMAZON_DSP_APP_SECRET + " +
+            "AMAZON_DSP_REFRESH_TOKEN) for the refresh-token flow, or AMAZON_DSP_ACCESS_TOKEN " +
+            "for a short-lived static token.");
+        return false;
+    }
+    let authAdapter;
+    if (mcpConfig.amazonDspAppId && mcpConfig.amazonDspAppSecret && mcpConfig.amazonDspRefreshToken) {
+        authAdapter = new AmazonDspRefreshTokenAdapter({
+            appId: mcpConfig.amazonDspAppId,
+            appSecret: mcpConfig.amazonDspAppSecret,
+            refreshToken: mcpConfig.amazonDspRefreshToken,
+        }, profileId, mcpConfig.amazonDspApiBaseUrl);
+        logger.info("Using LwA refresh-token flow (auto-refreshing access tokens)");
+    }
+    else if (mcpConfig.amazonDspAccessToken) {
+        authAdapter = new AmazonDspAccessTokenAdapter(mcpConfig.amazonDspAccessToken, profileId, mcpConfig.amazonDspApiBaseUrl, mcpConfig.amazonDspClientId);
+        logger.warn("Using static access-token flow — token expires after 60 minutes. " +
+            "For long-running sessions, configure AMAZON_DSP_APP_ID + AMAZON_DSP_APP_SECRET + AMAZON_DSP_REFRESH_TOKEN instead.");
+    }
+    else {
+        logger.warn("No AmazonDsp credentials found. Set AMAZON_DSP_APP_ID + AMAZON_DSP_APP_SECRET + " +
+            "AMAZON_DSP_REFRESH_TOKEN (recommended) or AMAZON_DSP_ACCESS_TOKEN.");
+        return false;
+    }
+    await authAdapter.validate();
+    const services = createSessionServices(authAdapter, {
+        baseUrl: mcpConfig.amazonDspApiBaseUrl,
+        reportPollIntervalMs: mcpConfig.amazonDspReportPollIntervalMs,
+        reportMaxPollAttempts: mcpConfig.amazonDspReportMaxPollAttempts,
+    }, logger, rateLimiter);
+    sessionServiceStore.set(sessionId, services);
+    logger.info("Stdio session services created successfully");
+    return true;
+}
+bootstrapMcpServer({
+    serviceName: "amazon-dsp-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 amazon-dsp-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":"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"}

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;AAEjE,eAAO,MAAM,4BAA4B,EAAE,MAgB1C,CAAC;AAEF,wBAAgB,gCAAgC,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CA8GtF"}

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

@@ -0,0 +1,127 @@
+export const bulkOperationsWorkflowPrompt = {
+    name: "amazon_dsp_bulk_operations_workflow",
+    description: "Guide for performing bulk create, update, and status operations on AmazonDsp Ads entities",
+    arguments: [
+        {
+            name: "profileId",
+            description: "AmazonDsp Advertiser ID",
+            required: true,
+        },
+        {
+            name: "entityType",
+            description: "Entity type to operate on (campaign, adGroup, ad)",
+            required: false,
+        },
+    ],
+};
+export function getBulkOperationsWorkflowMessage(args) {
+    const profileId = args?.profileId || "{profileId}";
+    const entityType = args?.entityType || "campaign";
+    return `# AmazonDsp Bulk Operations Workflow
+
+## Advertiser ID: \`${profileId}\`
+## Entity Type: \`${entityType}\`
+
+---
+
+## Option 1: Bulk Status Update (most common)
+
+Pause, enable, or delete multiple entities in one call:
+
+\`\`\`json
+amazon_dsp_bulk_update_status({
+  "entityType": "${entityType}",
+  "profileId": "${profileId}",
+  "entityIds": ["ID_1", "ID_2", "ID_3"],
+  "operationStatus": "PAUSED"
+})
+\`\`\`
+
+**Operation status values:**
+- \`ENABLED\` — Activate entities
+- \`PAUSED\` — Pause entities
+- \`ARCHIVED\` — Soft delete (Amazon DSP has no hard delete)
+
+---
+
+## Option 2: Bulk Create Entities (up to 50)
+
+Create multiple entities of the same type in one call:
+
+\`\`\`json
+amazon_dsp_bulk_create_entities({
+  "entityType": "${entityType}",
+  "profileId": "${profileId}",
+  "items": [
+    {
+      "campaign_name": "Campaign A",
+      "objective_type": "TRAFFIC",
+      "budget_mode": "BUDGET_MODE_DAY",
+      "budget": 100
+    },
+    {
+      "campaign_name": "Campaign B",
+      "objective_type": "CONVERSIONS",
+      "budget_mode": "BUDGET_MODE_DAY",
+      "budget": 200
+    }
+  ]
+})
+\`\`\`
+
+---
+
+## Option 3: Bulk Update Entities (up to 50)
+
+Update specific fields on multiple entities:
+
+\`\`\`json
+amazon_dsp_bulk_update_entities({
+  "entityType": "${entityType}",
+  "profileId": "${profileId}",
+  "items": [
+    { "entityId": "ID_1", "data": { "budget": 150 } },
+    { "entityId": "ID_2", "data": { "budget": 250 } }
+  ]
+})
+\`\`\`
+
+---
+
+## Option 4: Bulk Bid Adjustment (ad groups only)
+
+Safe read-modify-write bid adjustment:
+
+\`\`\`json
+amazon_dsp_adjust_bids({
+  "profileId": "${profileId}",
+  "adjustments": [
+    { "adGroupId": "ADGROUP_ID_1", "bidPrice": 1.5 },
+    { "adGroupId": "ADGROUP_ID_2", "bidPrice": 2.0 }
+  ],
+  "reason": "Increase bids to improve delivery"
+})
+\`\`\`
+
+---
+
+## Tips for Bulk Operations
+
+1. **List first**: Use \`amazon_dsp_list_entities\` to get entity IDs before bulk operations
+2. **Validate first**: Use \`amazon_dsp_validate_entity\` to check payloads before bulk create
+3. **Status update is batched**: AmazonDsp accepts IDs array in one API call
+4. **Create/Update is sequential**: Processed concurrently (5 at a time) by the MCP tool
+5. **Max 50 items**: Per bulk create/update call (more = multiple calls)
+6. **Error handling**: Partial failures are reported — some may succeed while others fail
+
+## Workflow: Pause all campaigns → Adjust → Re-enable
+
+\`\`\`
+1. amazon_dsp_list_entities (get campaign IDs)
+2. amazon_dsp_bulk_update_status (DISABLE all)
+3. amazon_dsp_bulk_update_entities (adjust budgets/settings)
+4. amazon_dsp_bulk_update_status (ENABLE selected)
+\`\`\`
+`;
+}
+//# 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":"AAKA,MAAM,CAAC,MAAM,4BAA4B,GAAW;IAClD,IAAI,EAAE,qCAAqC;IAC3C,WAAW,EACT,2FAA2F;IAC7F,SAAS,EAAE;QACT;YACE,IAAI,EAAE,WAAW;YACjB,WAAW,EAAE,yBAAyB;YACtC,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,YAAY;YAClB,WAAW,EAAE,mDAAmD;YAChE,QAAQ,EAAE,KAAK;SAChB;KACF;CACF,CAAC;AAEF,MAAM,UAAU,gCAAgC,CAAC,IAA6B;IAC5E,MAAM,SAAS,GAAG,IAAI,EAAE,SAAS,IAAI,aAAa,CAAC;IACnD,MAAM,UAAU,GAAG,IAAI,EAAE,UAAU,IAAI,UAAU,CAAC;IAElD,OAAO;;sBAEa,SAAS;oBACX,UAAU;;;;;;;;;;mBAUX,UAAU;kBACX,SAAS;;;;;;;;;;;;;;;;;;;mBAmBR,UAAU;kBACX,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;mBA0BR,UAAU;kBACX,SAAS;;;;;;;;;;;;;;;;kBAgBT,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4B1B,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":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAEjE,eAAO,MAAM,2BAA2B,EAAE,MAiBzC,CAAC;AAEF,wBAAgB,+BAA+B,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAuGrF"}

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

@@ -0,0 +1,120 @@
+export const campaignSetupWorkflowPrompt = {
+    name: "amazon_dsp_campaign_setup_workflow",
+    description: "Step-by-step guide for creating a complete Amazon DSP campaign structure (Order > Line Item > Creative)",
+    arguments: [
+        {
+            name: "profileId",
+            description: "Amazon DSP Entity ID / Profile ID (from Amazon-Advertising-API-Scope header)",
+            required: true,
+        },
+        {
+            name: "objective",
+            description: "Campaign goal (e.g., REACH, REMARKETING, BEHAVIORAL_RETARGETING, CONTEXTUAL_TARGETING)",
+            required: false,
+        },
+    ],
+};
+export function getCampaignSetupWorkflowMessage(args) {
+    const profileId = args?.profileId || "{profileId}";
+    const objective = args?.objective || "REACH";
+    return `# Amazon DSP Campaign Setup Workflow
+
+## Prerequisites
+- DSP Entity ID (Profile ID): \`${profileId}\`
+- Ensure \`Amazon-Advertising-API-Scope\` header is set to your DSP entity ID
+- Verify advertiser access: \`amazon_dsp_list_advertisers\`
+
+⚠️ **GOTCHA: Amazon-Advertising-API-Scope header must contain your DSP entity ID (profile ID).**
+⚠️ **GOTCHA: Budget amounts are numeric values, not micro-currency. Keep them aligned with the advertiser account currency returned by Amazon.**
+⚠️ **GOTCHA: Amazon DSP has no DELETE endpoint. Use state: "ARCHIVED" to remove entities.**
+
+## Step 1: Create Order (Campaign)
+
+Orders are the top-level campaign entity in Amazon DSP.
+
+\`\`\`json
+amazon_dsp_create_entity({
+  "entityType": "order",
+  "profileId": "${profileId}",
+  "data": {
+    "name": "Q1 Brand Awareness Campaign",
+    "advertiserId": "ADVERTISER_ID",
+    "budget": 50000.00,
+    "startDateTime": "2026-01-01T00:00:00Z",
+    "endDateTime": "2026-03-31T23:59:59Z",
+    "state": "ENABLED"
+  }
+})
+\`\`\`
+
+**Campaign Goals / Objectives:** REACH, REMARKETING, BEHAVIORAL_RETARGETING, CONTEXTUAL_TARGETING
+
+## Step 2: Create Line Item (Ad Group)
+
+Line Items define targeting, bidding, and budget allocation within an Order.
+
+\`\`\`json
+amazon_dsp_create_entity({
+  "entityType": "lineItem",
+  "profileId": "${profileId}",
+  "data": {
+    "name": "Prospecting - Desktop Display",
+    "orderId": "ORDER_ID_FROM_STEP_1",
+    "budget": { "budgetType": "DAILY", "budget": 10000.00 },
+    "state": "ENABLED",
+    "bidding": {
+      "bidOptimization": "${objective === "REACH" ? "AUTO" : "MANUAL"}",
+      "bidAmount": 2.50
+    },
+    "targetingCriteria": {
+      "audience": {
+        "include": [{ "type": "BEHAVIORAL", "value": ["in-market-auto"] }]
+      }
+    }
+  }
+})
+\`\`\`
+
+## Step 3: Create Creative
+
+Creatives define the ad format and click-through destination.
+
+\`\`\`json
+amazon_dsp_create_entity({
+  "entityType": "creative",
+  "profileId": "${profileId}",
+  "data": {
+    "name": "300x250 Banner - Brand",
+    "advertiserId": "ADVERTISER_ID",
+    "clickThroughUrl": "https://example.com/landing",
+    "creativeType": "STANDARD_DISPLAY",
+    "state": "ENABLED"
+  }
+})
+\`\`\`
+
+**Creative Types:** STANDARD_DISPLAY, VIDEO, RICH_MEDIA
+
+## Step 4: Verify & Activate
+
+1. Review entities: \`amazon_dsp_get_entity\` for each created entity
+2. Activate if paused: \`amazon_dsp_bulk_update_status\` with operationStatus: "ENABLED"
+
+## Common Errors
+
+| Error | Cause | Fix |
+|-------|-------|-----|
+| 401 Unauthorized | Missing or invalid access token | Check Authorization: Bearer header |
+| 403 Forbidden | Missing API scope header | Set Amazon-Advertising-API-Scope to your DSP entity ID |
+| 400 Bad Request | Invalid date format | Use ISO 8601: YYYY-MM-DDTHH:mm:ssZ |
+| 400 Bad Request | Budget too low | Amazon DSP requires minimum budget thresholds |
+
+## Success Criteria
+
+- [ ] Order created with correct budget and date range
+- [ ] Line Item linked to Order via orderId
+- [ ] Creative linked to correct advertiserId
+- [ ] All entities in ENABLED state
+`;
+}
+//# sourceMappingURL=campaign-setup-workflow.prompt.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"campaign-setup-workflow.prompt.js","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,2BAA2B,GAAW;IACjD,IAAI,EAAE,oCAAoC;IAC1C,WAAW,EACT,yGAAyG;IAC3G,SAAS,EAAE;QACT;YACE,IAAI,EAAE,WAAW;YACjB,WAAW,EAAE,8EAA8E;YAC3F,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,WAAW;YACjB,WAAW,EACT,wFAAwF;YAC1F,QAAQ,EAAE,KAAK;SAChB;KACF;CACF,CAAC;AAEF,MAAM,UAAU,+BAA+B,CAAC,IAA6B;IAC3E,MAAM,SAAS,GAAG,IAAI,EAAE,SAAS,IAAI,aAAa,CAAC;IACnD,MAAM,SAAS,GAAG,IAAI,EAAE,SAAS,IAAI,OAAO,CAAC;IAE7C,OAAO;;;kCAGyB,SAAS;;;;;;;;;;;;;;;kBAezB,SAAS;;;;;;;;;;;;;;;;;;;;;kBAqBT,SAAS;;;;;;;4BAOC,SAAS,KAAK,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ;;;;;;;;;;;;;;;;;;;kBAmBnD,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiC1B,CAAC;AACF,CAAC"}

package/dist/mcp-server/prompts/definitions/creative-upload-workflow.prompt.d.ts

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

package/dist/mcp-server/prompts/definitions/creative-upload-workflow.prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"creative-upload-workflow.prompt.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/creative-upload-workflow.prompt.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAEjE,eAAO,MAAM,qCAAqC,EAAE,MAgBnD,CAAC;AAEF,wBAAgB,yCAAyC,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAqG/F"}

package/dist/mcp-server/prompts/definitions/creative-upload-workflow.prompt.js

@@ -0,0 +1,116 @@
+export const amazonDspCreativeUploadWorkflowPrompt = {
+    name: "amazon_dsp_creative_upload_workflow",
+    description: "Step-by-step guide for uploading creative assets and creating AmazonDsp Ads creatives",
+    arguments: [
+        {
+            name: "profileId",
+            description: "AmazonDsp Advertiser ID",
+            required: true,
+        },
+        {
+            name: "creativeType",
+            description: "Type of creative: image or video",
+            required: false,
+        },
+    ],
+};
+export function getAmazonDspCreativeUploadWorkflowMessage(args) {
+    const profileId = args?.profileId || "{profileId}";
+    const creativeType = args?.creativeType || "video";
+    return `# AmazonDsp Ads Creative Upload Workflow
+
+## Prerequisites
+- Advertiser ID: \`${profileId}\`
+- A publicly accessible URL for your media file
+
+## Overview
+AmazonDsp creative workflow: Upload media → Create Ad Group → Create Ad with creative
+
+---
+
+## Step 1: Upload ${creativeType === "image" ? "Image" : "Video"}
+
+${creativeType === "image"
+        ? `
+\`\`\`json
+amazon_dsp_upload_image({
+  "profileId": "${profileId}",
+  "mediaUrl": "https://example.com/your-image.jpg"
+})
+\`\`\`
+
+**Returns:** \`imageId\`
+
+**Image requirements:**
+- Formats: JPEG, PNG
+- Max 100KB for feed ads
+- Recommended: 1200x628px, 1080x1080px, 720x1280px
+`
+        : `
+\`\`\`json
+amazon_dsp_upload_video({
+  "profileId": "${profileId}",
+  "mediaUrl": "https://example.com/your-video.mp4",
+  "videoName": "Campaign Video"
+})
+\`\`\`
+
+**Returns:** \`videoId\`
+
+⚠️ **GOTCHA**: Video processing takes 20-120 seconds. The tool polls automatically (20s intervals, up to 10 min).
+When \`video_status == "bind_success"\`, the video is ready.
+
+**Video requirements:**
+- Formats: MP4, MOV, AVI
+- Max 500MB
+- Min resolution: 540x960 (9:16), 960x540 (16:9), or 640x640 (1:1)
+- Duration: 5-60 seconds for In-Feed ads
+`}
+
+## Step 2: Create Creative
+
+\`\`\`json
+amazon_dsp_create_entity({
+  "entityType": "creative",
+  "advertiserId": "${profileId}",
+  "data": {
+    "name": "Your Creative Name",
+    "advertiserId": "${profileId}",
+    "creativeType": "${creativeType === "image" ? "IMAGE" : "VIDEO"}",
+    ${creativeType === "image" ? `"imageId": "{imageId_from_step_1}",` : `"videoId": "{videoId_from_step_1}",`}
+    "clickUrl": "https://yoursite.com",
+    "state": "paused"
+  }
+})
+\`\`\`
+
+⚠️ **GOTCHA**: Amazon DSP creatives go through a review process. Initial state should be \`paused\` until ready to launch.
+
+## Step 3: Preview Creative
+
+\`\`\`json
+amazon_dsp_get_ad_preview({
+  "advertiserId": "${profileId}",
+  "adId": "{creative_id_from_step_2}",
+  "adFormat": "DISPLAY"
+})
+\`\`\`
+
+## Common Errors
+
+| Error | Cause | Fix |
+|-------|-------|-----|
+| "Video processing failed" | Unsupported codec | Re-encode to H.264 MP4 |
+| "Image size exceeded" | File too large | Compress to < 100KB |
+| "Ad review rejected" | Policy violation | Review AmazonDsp ad policies |
+| "bind_success timeout" | Slow processing | Check video_status manually |
+
+## Success Criteria
+- [ ] Media uploaded (imageId or videoId obtained)
+- [ ] Creative created with paused state
+- [ ] Preview reviewed
+- [ ] State changed to delivering when ready to launch
+
+`;
+}
+//# sourceMappingURL=creative-upload-workflow.prompt.js.map

package/dist/mcp-server/prompts/definitions/creative-upload-workflow.prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"creative-upload-workflow.prompt.js","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/creative-upload-workflow.prompt.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,qCAAqC,GAAW;IAC3D,IAAI,EAAE,qCAAqC;IAC3C,WAAW,EACT,uFAAuF;IACzF,SAAS,EAAE;QACT;YACE,IAAI,EAAE,WAAW;YACjB,WAAW,EAAE,yBAAyB;YACtC,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,cAAc;YACpB,WAAW,EAAE,kCAAkC;YAC/C,QAAQ,EAAE,KAAK;SAChB;KACF;CACF,CAAC;AAEF,MAAM,UAAU,yCAAyC,CAAC,IAA6B;IACrF,MAAM,SAAS,GAAG,IAAI,EAAE,SAAS,IAAI,aAAa,CAAC;IACnD,MAAM,YAAY,GAAG,IAAI,EAAE,YAAY,IAAI,OAAO,CAAC;IAEnD,OAAO;;;qBAGY,SAAS;;;;;;;;oBAQV,YAAY,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO;;EAG9D,YAAY,KAAK,OAAO;QACtB,CAAC,CAAC;;;kBAGY,SAAS;;;;;;;;;;;CAW1B;QACG,CAAC,CAAC;;;kBAGY,SAAS;;;;;;;;;;;;;;;;CAiB3B;;;;;;;qBAOqB,SAAS;;;uBAGP,SAAS;uBACT,YAAY,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO;MAC7D,YAAY,KAAK,OAAO,CAAC,CAAC,CAAC,qCAAqC,CAAC,CAAC,CAAC,qCAAqC;;;;;;;;;;;;;qBAazF,SAAS;;;;;;;;;;;;;;;;;;;;;CAqB7B,CAAC;AACF,CAAC"}