@cesteral/pinterest-mcp 1.0.0

package/dist/generated/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/generated/types.js.map

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

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,47 @@
+#!/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 { PinterestAccessTokenAdapter } from "./auth/pinterest-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("pinterest-mcp", transportMode, otelLogMixin());
+async function setupStdioCredentials(sessionId) {
+    const accessToken = mcpConfig.pinterestAccessToken;
+    const adAccountId = mcpConfig.pinterestAdAccountId;
+    if (!accessToken || !adAccountId) {
+        logger.warn("No Pinterest credentials found in env vars. " +
+            "Set PINTEREST_ACCESS_TOKEN and PINTEREST_AD_ACCOUNT_ID for stdio mode.");
+        return false;
+    }
+    const authAdapter = new PinterestAccessTokenAdapter(accessToken, adAccountId, mcpConfig.pinterestApiBaseUrl);
+    await authAdapter.validate();
+    const services = createSessionServices(authAdapter, {
+        baseUrl: mcpConfig.pinterestApiBaseUrl,
+        apiVersion: mcpConfig.pinterestApiVersion,
+        reportPollIntervalMs: mcpConfig.pinterestReportPollIntervalMs,
+        reportMaxPollAttempts: mcpConfig.pinterestReportMaxPollAttempts,
+    }, logger, rateLimiter);
+    sessionServiceStore.set(sessionId, services);
+    logger.info("Stdio session services created successfully");
+    return true;
+}
+bootstrapMcpServer({
+    serviceName: "pinterest-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 pinterest-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,kCAAkC,CAAC;AAC/E,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,eAAe,EAAE,aAAa,EAAE,YAAY,EAAE,CAAC,CAAC;AAMlF,KAAK,UAAU,qBAAqB,CAAC,SAAiB;IACpD,MAAM,WAAW,GAAG,SAAS,CAAC,oBAAoB,CAAC;IACnD,MAAM,WAAW,GAAG,SAAS,CAAC,oBAAoB,CAAC;IAEnD,IAAI,CAAC,WAAW,IAAI,CAAC,WAAW,EAAE,CAAC;QACjC,MAAM,CAAC,IAAI,CACT,8CAA8C;YAC5C,wEAAwE,CAC3E,CAAC;QACF,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,2BAA2B,CACjD,WAAW,EACX,WAAW,EACX,SAAS,CAAC,mBAAmB,CAC9B,CAAC;IAGF,MAAM,WAAW,CAAC,QAAQ,EAAE,CAAC;IAE7B,MAAM,QAAQ,GAAG,qBAAqB,CACpC,WAAW,EACX;QACE,OAAO,EAAE,SAAS,CAAC,mBAAmB;QACtC,UAAU,EAAE,SAAS,CAAC,mBAAmB;QACzC,oBAAoB,EAAE,SAAS,CAAC,6BAA6B;QAC7D,qBAAqB,EAAE,SAAS,CAAC,8BAA8B;KAChE,EACD,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,eAAe;IAC5B,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,+BAA+B,CAAC,CAAC;IACvD,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;AAEjE,eAAO,MAAM,4BAA4B,EAAE,MAgB1C,CAAC;AAEF,wBAAgB,gCAAgC,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CA4GtF"}

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

@@ -0,0 +1,125 @@
+export const bulkOperationsWorkflowPrompt = {
+    name: "pinterest_bulk_operations_workflow",
+    description: "Guide for performing bulk create, update, and status operations on Pinterest Ads entities",
+    arguments: [
+        {
+            name: "adAccountId",
+            description: "Pinterest Advertiser ID",
+            required: true,
+        },
+        {
+            name: "entityType",
+            description: "Entity type to operate on (campaign, adGroup, ad)",
+            required: false,
+        },
+    ],
+};
+export function getBulkOperationsWorkflowMessage(args) {
+    const adAccountId = args?.adAccountId || "{adAccountId}";
+    const entityType = args?.entityType || "campaign";
+    return `# Pinterest Bulk Operations Workflow
+
+## Advertiser ID: \`${adAccountId}\`
+## Entity Type: \`${entityType}\`
+
+---
+
+## Option 1: Bulk Status Update (most common)
+
+Pause, enable, or delete multiple entities in one call:
+
+\`\`\`json
+pinterest_bulk_update_status({
+  "entityType": "${entityType}",
+  "adAccountId": "${adAccountId}",
+  "entityIds": ["ID_1", "ID_2", "ID_3"],
+  "operationStatus": "PAUSED"
+})
+\`\`\`
+
+**Operation status values:**
+- \`ACTIVE\` — Activate entities
+- \`PAUSED\` — Pause entities
+- \`DELETE\` — Permanently delete (irreversible!)
+
+---
+
+## Option 2: Bulk Create Entities (up to 50)
+
+Create multiple entities of the same type in one call:
+
+\`\`\`json
+pinterest_bulk_create_entities({
+  "entityType": "${entityType}",
+  "adAccountId": "${adAccountId}",
+  "items": [
+    {
+      "name": "Campaign A",
+      "objective_type": "AWARENESS",
+      "daily_spend_cap": 50000000
+    },
+    {
+      "name": "Campaign B",
+      "objective_type": "CONVERSIONS",
+      "daily_spend_cap": 100000000
+    }
+  ]
+})
+\`\`\`
+
+---
+
+## Option 3: Bulk Update Entities (up to 50)
+
+Update specific fields on multiple entities:
+
+\`\`\`json
+pinterest_bulk_update_entities({
+  "entityType": "${entityType}",
+  "adAccountId": "${adAccountId}",
+  "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
+pinterest_adjust_bids({
+  "adAccountId": "${adAccountId}",
+  "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 \`pinterest_list_entities\` to get entity IDs before bulk operations
+2. **Validate first**: Use \`pinterest_validate_entity\` to check payloads before bulk create
+3. **Status update is batched**: Pinterest 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. pinterest_list_entities (get campaign IDs)
+2. pinterest_bulk_update_status (PAUSED all)
+3. pinterest_bulk_update_entities (adjust budgets/settings)
+4. pinterest_bulk_update_status (ACTIVE 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,oCAAoC;IAC1C,WAAW,EACT,2FAA2F;IAC7F,SAAS,EAAE;QACT;YACE,IAAI,EAAE,aAAa;YACnB,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,WAAW,GAAG,IAAI,EAAE,WAAW,IAAI,eAAe,CAAC;IACzD,MAAM,UAAU,GAAG,IAAI,EAAE,UAAU,IAAI,UAAU,CAAC;IAElD,OAAO;;sBAEa,WAAW;oBACb,UAAU;;;;;;;;;;mBAUX,UAAU;oBACT,WAAW;;;;;;;;;;;;;;;;;;;mBAmBZ,UAAU;oBACT,WAAW;;;;;;;;;;;;;;;;;;;;;;;;mBAwBZ,UAAU;oBACT,WAAW;;;;;;;;;;;;;;;;oBAgBX,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4B9B,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,CAwFrF"}

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

@@ -0,0 +1,105 @@
+export const campaignSetupWorkflowPrompt = {
+    name: "pinterest_campaign_setup_workflow",
+    description: "Step-by-step guide for creating a complete Pinterest Ads campaign structure (Campaign > Ad Group > Ad)",
+    arguments: [
+        {
+            name: "adAccountId",
+            description: "Pinterest Ad Account ID (e.g., 549755885175)",
+            required: true,
+        },
+        {
+            name: "objective",
+            description: "Campaign objective (e.g., AWARENESS, CONSIDERATION, VIDEO_VIEW, CATALOG_SALES, CONVERSIONS, APP_INSTALL, SHOPPING)",
+            required: false,
+        },
+    ],
+};
+export function getCampaignSetupWorkflowMessage(args) {
+    const adAccountId = args?.adAccountId || "{adAccountId}";
+    const objective = args?.objective || "AWARENESS";
+    return `# Pinterest Campaign Setup Workflow
+
+## Prerequisites
+- Ad Account ID: \`${adAccountId}\`
+- Verify access: \`pinterest_list_advertisers\`
+
+## Step 1: Create Campaign
+
+\`\`\`json
+pinterest_create_entity({
+  "entityType": "campaign",
+  "adAccountId": "${adAccountId}",
+  "data": {
+    "name": "Your Campaign Name",
+    "objective_type": "${objective}",
+    "status": "ACTIVE",
+    "daily_spend_cap": 50000000
+  }
+})
+\`\`\`
+
+**Campaign Objectives:** AWARENESS, CONSIDERATION, VIDEO_VIEW, CATALOG_SALES, CONVERSIONS, APP_INSTALL, SHOPPING
+
+**Status values:** ACTIVE, PAUSED, ARCHIVED
+
+## Step 2: Create Ad Group
+
+\`\`\`json
+pinterest_create_entity({
+  "entityType": "adGroup",
+  "adAccountId": "${adAccountId}",
+  "data": {
+    "name": "Your Ad Group Name",
+    "campaign_id": "CAMPAIGN_ID_FROM_STEP_1",
+    "status": "ACTIVE",
+    "budget_in_micro_currency": 10000000,
+    "pacing_delivery_type": "STANDARD",
+    "bid_strategy_type": "AUTOMATIC_BID",
+    "start_time": "2026-04-01T00:00:00",
+    "targeting_spec": {
+      "age_bucket": ["35-44", "45-49"],
+      "gender": ["female"],
+      "geo": [{ "country": "US" }],
+      "interest": ["food", "fashion"]
+    }
+  }
+})
+\`\`\`
+
+## Step 3: Create Ad(s)
+
+> ⚠️ **GOTCHA:** Ads reference Pinterest Pins by pin_id — create/upload the Pin first before creating the Ad.
+
+\`\`\`json
+pinterest_create_entity({
+  "entityType": "ad",
+  "adAccountId": "${adAccountId}",
+  "data": {
+    "name": "Your Ad Name",
+    "ad_group_id": "ADGROUP_ID_FROM_STEP_2",
+    "creative_type": "REGULAR",
+    "pin_id": "YOUR_PIN_ID",
+    "status": "ACTIVE"
+  }
+})
+\`\`\`
+
+**Creative types:** REGULAR, VIDEO, SHOPPING, CAROUSEL
+
+## Step 4: Verify & Activate
+
+1. Review: \`pinterest_get_entity\` for each created entity
+2. Preview ad: \`pinterest_get_ad_preview\`
+3. Activate: \`pinterest_bulk_update_status\` with status: "ACTIVE"
+
+## Common Gotchas
+
+- ⚠️ **GOTCHA: Pinterest budgets use micro-currency (1 USD = 1,000,000). $50/day → daily_spend_cap: 50000000**
+- ⚠️ **GOTCHA: Ads reference Pinterest Pins by pin_id — create/upload the Pin first before creating the Ad**
+- ⚠️ **GOTCHA: Status values are ACTIVE/PAUSED/ARCHIVED (not ENABLE/DISABLE)**
+- ⚠️ Ad group budget (\`budget_in_micro_currency\`) must also be in micro-currency
+- ⚠️ \`start_time\` and \`end_time\` use ISO 8601 datetime strings (e.g., "2026-04-01T00:00:00")
+- ⚠️ Reporting has a 24-48h lag for finalized data
+`;
+}
+//# 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,mCAAmC;IACzC,WAAW,EACT,wGAAwG;IAC1G,SAAS,EAAE;QACT;YACE,IAAI,EAAE,aAAa;YACnB,WAAW,EAAE,8CAA8C;YAC3D,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,WAAW;YACjB,WAAW,EACT,oHAAoH;YACtH,QAAQ,EAAE,KAAK;SAChB;KACF;CACF,CAAC;AAEF,MAAM,UAAU,+BAA+B,CAAC,IAA6B;IAC3E,MAAM,WAAW,GAAG,IAAI,EAAE,WAAW,IAAI,eAAe,CAAC;IACzD,MAAM,SAAS,GAAG,IAAI,EAAE,SAAS,IAAI,WAAW,CAAC;IAEjD,OAAO;;;qBAGY,WAAW;;;;;;;;oBAQZ,WAAW;;;yBAGN,SAAS;;;;;;;;;;;;;;;;oBAgBd,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;oBA0BX,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2B9B,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 pinterestCreativeUploadWorkflowPrompt: Prompt;
+export declare function getPinterestCreativeUploadWorkflowMessage(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,MAWnD,CAAC;AAEF,wBAAgB,yCAAyC,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAmF/F"}

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

@@ -0,0 +1,95 @@
+export const pinterestCreativeUploadWorkflowPrompt = {
+    name: "creative_upload_workflow",
+    description: "Step-by-step guide for uploading video creatives and creating Pinterest Ads. Image creatives reference a hosted image URL directly rather than uploading a file.",
+    arguments: [
+        {
+            name: "adAccountId",
+            description: "Pinterest Advertiser ID",
+            required: true,
+        },
+    ],
+};
+export function getPinterestCreativeUploadWorkflowMessage(args) {
+    const adAccountId = args?.adAccountId || "{adAccountId}";
+    return `# Pinterest Ads Creative Upload Workflow
+
+## Prerequisites
+- Advertiser ID: \`${adAccountId}\`
+- A publicly accessible URL for your video file (for image ads, a hosted image URL is used directly — Pinterest's \`/v5/media\` endpoint only accepts \`media_type="video"\`)
+
+## Overview
+Pinterest creative workflow: Upload video → Create Ad Group → Create Ad with creative
+
+---
+
+## Step 1: Upload Video
+
+\`\`\`json
+pinterest_upload_video({
+  "adAccountId": "${adAccountId}",
+  "mediaUrl": "https://example.com/your-video.mp4",
+  "videoName": "Campaign Video"
+})
+\`\`\`
+
+**Returns:** \`mediaId\`
+
+⚠️ **GOTCHA**: Video processing takes 20-120 seconds. The tool polls automatically (20s intervals, up to 10 min).
+When \`status == "succeeded"\`, 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 Ad
+
+\`\`\`json
+pinterest_create_entity({
+  "entityType": "ad",
+  "adAccountId": "${adAccountId}",
+  "data": {
+    "adgroup_id": "{your_adgroup_id}",
+    "ad_name": "Your Ad Name",
+    "ad_format": "SINGLE_VIDEO",
+    "video_id": "{mediaId_from_step_1}",
+    "ad_text": "Your ad copy here",
+    "landing_page_url": "https://yoursite.com",
+    "call_to_action": "LEARN_MORE",
+    "status": "DISABLE"
+  }
+})
+\`\`\`
+
+For image ads, pass \`image_url\` (a hosted URL) in the creative payload directly — no upload step.
+
+⚠️ **GOTCHA**: Pinterest ads go through a review process. Initial status should be DISABLE (paused) until ready to launch.
+
+## Step 3: Preview Ad
+
+\`\`\`json
+pinterest_get_ad_preview({
+  "adAccountId": "${adAccountId}",
+  "adId": "{ad_id_from_step_2}",
+  "adFormat": "FEED"
+})
+\`\`\`
+
+## Common Errors
+
+| Error | Cause | Fix |
+|-------|-------|-----|
+| "Video processing failed" | Unsupported codec | Re-encode to H.264 MP4 |
+| "Ad review rejected" | Policy violation | Review Pinterest ad policies |
+| "processing timeout" | Slow processing | Re-check media status via GET /v5/media/{mediaId} |
+
+## Success Criteria
+- [ ] Media uploaded (mediaId obtained and status succeeded)
+- [ ] Ad created with DISABLE status
+- [ ] Preview reviewed
+- [ ] Status changed to ENABLE 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,0BAA0B;IAChC,WAAW,EACT,kKAAkK;IACpK,SAAS,EAAE;QACT;YACE,IAAI,EAAE,aAAa;YACnB,WAAW,EAAE,yBAAyB;YACtC,QAAQ,EAAE,IAAI;SACf;KACF;CACF,CAAC;AAEF,MAAM,UAAU,yCAAyC,CAAC,IAA6B;IACrF,MAAM,WAAW,GAAG,IAAI,EAAE,WAAW,IAAI,eAAe,CAAC;IAEzD,OAAO;;;qBAGY,WAAW;;;;;;;;;;;;oBAYZ,WAAW;;;;;;;;;;;;;;;;;;;;;;oBAsBX,WAAW;;;;;;;;;;;;;;;;;;;;;;oBAsBX,WAAW;;;;;;;;;;;;;;;;;;;;CAoB9B,CAAC;AACF,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"cross-platform-campaign-setup.prompt.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/cross-platform-campaign-setup.prompt.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAQjE,eAAO,MAAM,gCAAgC,EAAE,MAiB9C,CAAC;AAEF,wBAAgB,oCAAoC,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CA4R1F"}