@cesteral/pinterest-mcp 1.0.0

package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.js

@@ -0,0 +1,111 @@
+export const pinterestTroubleshootEntityPrompt = {
+    name: "pinterest_troubleshoot_entity",
+    description: "Diagnostic workflow for troubleshooting Pinterest Ads entity issues",
+    arguments: [
+        {
+            name: "entityType",
+            description: "Entity type (campaign, adGroup, ad, creative)",
+            required: true,
+        },
+        {
+            name: "entityId",
+            description: "Numeric entity ID to troubleshoot",
+            required: true,
+        },
+        {
+            name: "adAccountId",
+            description: "Pinterest Advertiser ID",
+            required: true,
+        },
+    ],
+};
+export function getPinterestTroubleshootEntityMessage(args) {
+    const entityType = args?.entityType || "{entityType}";
+    const entityId = args?.entityId || "{entityId}";
+    const adAccountId = args?.adAccountId || "{adAccountId}";
+    return `# Pinterest Entity Troubleshoot Workflow
+
+## Target: ${entityType} ${entityId} (Advertiser: ${adAccountId})
+
+## Step 1: Fetch Entity Details
+
+\`\`\`json
+pinterest_get_entity({
+  "entityType": "${entityType}",
+  "adAccountId": "${adAccountId}",
+  "entityId": "${entityId}"
+})
+\`\`\`
+
+Check: operation_status, primary_status, secondary_status, and any rejection reasons.
+
+## Step 2: Check Recent Performance
+
+\`\`\`json
+pinterest_get_report({
+  "adAccountId": "${adAccountId}",
+  "dimensions": ["campaign_id", "stat_time_day"],
+  "metrics": ["impressions", "clicks", "spend", "conversions"],
+  "startDate": "2026-02-01",
+  "endDate": "2026-03-07"
+})
+\`\`\`
+
+## Step 3: Check Parent Entity
+
+If ad group or ad, check parent entity status:
+\`\`\`json
+pinterest_get_entity({
+  "entityType": "campaign",
+  "adAccountId": "${adAccountId}",
+  "entityId": "{parentCampaignId}"
+})
+\`\`\`
+
+## Common Issues
+
+| Symptom | Likely Cause | Fix |
+|---------|-------------|-----|
+| No delivery | Entity PAUSED | Use \`pinterest_bulk_update_status\` with operationStatus: "ACTIVE" |
+| No delivery, ACTIVE | Parent paused | Enable parent campaign or ad group |
+| No delivery, all ACTIVE | Budget exhausted | Increase budget |
+| No delivery, budget OK | Targeting too narrow | Check audience estimate |
+| Ad under review | Pinterest ad review in progress | Allow 24-48h for review |
+| Ad rejected | Policy violation | Review Pinterest creative guidelines |
+| Video not playing | Video upload incomplete | Check video status in Creative Library |
+| Low reach | Targeting too narrow | Broaden age, interests, or geos |
+
+## Step 4: Audience Estimate
+
+\`\`\`json
+pinterest_get_audience_estimate({
+  "adAccountId": "${adAccountId}",
+  "targetingConfig": { ... targeting from adGroup ... }
+})
+\`\`\`
+
+## Step 5: Validate Entity Payload
+
+\`\`\`json
+pinterest_validate_entity({
+  "entityType": "${entityType}",
+  "mode": "update",
+  "data": { ... current entity data ... }
+})
+\`\`\`
+
+## Status Update Tool
+
+Pinterest uses a separate status endpoint — do NOT use \`pinterest_update_entity\` for status changes:
+
+\`\`\`json
+pinterest_bulk_update_status({
+  "entityType": "${entityType}",
+  "adAccountId": "${adAccountId}",
+  "entityIds": ["${entityId}"],
+  "operationStatus": "ACTIVE"
+})
+\`\`\`
+`;
+}
+//# sourceMappingURL=troubleshoot-entity.prompt.js.map

package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"troubleshoot-entity.prompt.js","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/troubleshoot-entity.prompt.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,iCAAiC,GAAW;IACvD,IAAI,EAAE,+BAA+B;IACrC,WAAW,EAAE,qEAAqE;IAClF,SAAS,EAAE;QACT;YACE,IAAI,EAAE,YAAY;YAClB,WAAW,EAAE,+CAA+C;YAC5D,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,UAAU;YAChB,WAAW,EAAE,mCAAmC;YAChD,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,aAAa;YACnB,WAAW,EAAE,yBAAyB;YACtC,QAAQ,EAAE,IAAI;SACf;KACF;CACF,CAAC;AAEF,MAAM,UAAU,qCAAqC,CAAC,IAA6B;IACjF,MAAM,UAAU,GAAG,IAAI,EAAE,UAAU,IAAI,cAAc,CAAC;IACtD,MAAM,QAAQ,GAAG,IAAI,EAAE,QAAQ,IAAI,YAAY,CAAC;IAChD,MAAM,WAAW,GAAG,IAAI,EAAE,WAAW,IAAI,eAAe,CAAC;IAEzD,OAAO;;aAEI,UAAU,IAAI,QAAQ,iBAAiB,WAAW;;;;;;mBAM5C,UAAU;oBACT,WAAW;iBACd,QAAQ;;;;;;;;;;oBAUL,WAAW;;;;;;;;;;;;;;oBAcX,WAAW;;;;;;;;;;;;;;;;;;;;;;oBAsBX,WAAW;;;;;;;;;mBASZ,UAAU;;;;;;;;;;;;mBAYV,UAAU;oBACT,WAAW;mBACZ,QAAQ;;;;CAI1B,CAAC;AACF,CAAC"}

package/dist/mcp-server/prompts/index.d.ts

@@ -0,0 +1,9 @@
+import type { Prompt } from "@modelcontextprotocol/sdk/types.js";
+export interface PromptDefinition {
+    prompt: Prompt;
+    generateMessage: (args?: Record<string, string>) => string;
+}
+export declare const promptRegistry: Map<string, PromptDefinition>;
+export declare function getAllPrompts(): Prompt[];
+export declare function getPromptDefinition(name: string): PromptDefinition | undefined;
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp-server/prompts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/prompts/index.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AA8CjE,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,MAAM,CAAC;CAC5D;AAED,eAAO,MAAM,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CA8EvD,CAAC;AAEH,wBAAgB,aAAa,IAAI,MAAM,EAAE,CAExC;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAE9E"}

package/dist/mcp-server/prompts/index.js

@@ -0,0 +1,97 @@
+import { campaignSetupWorkflowPrompt, getCampaignSetupWorkflowMessage, } from "./definitions/campaign-setup-workflow.prompt.js";
+import { bulkOperationsWorkflowPrompt, getBulkOperationsWorkflowMessage, } from "./definitions/bulk-operations-workflow.prompt.js";
+import { pinterestToolSchemaExplorationPrompt, getPinterestToolSchemaExplorationMessage, } from "./definitions/tool-schema-exploration.prompt.js";
+import { pinterestTroubleshootEntityPrompt, getPinterestTroubleshootEntityMessage, } from "./definitions/troubleshoot-entity.prompt.js";
+import { pinterestReportingWorkflowPrompt, getPinterestReportingWorkflowMessage, } from "./definitions/reporting-workflow.prompt.js";
+import { pinterestEntityUpdateWorkflowPrompt, getPinterestEntityUpdateWorkflowMessage, } from "./definitions/entity-update-workflow.prompt.js";
+import { pinterestTargetingDiscoveryWorkflowPrompt, getPinterestTargetingDiscoveryWorkflowMessage, } from "./definitions/targeting-discovery-workflow.prompt.js";
+import { pinterestEntityDuplicationWorkflowPrompt, getPinterestEntityDuplicationWorkflowMessage, } from "./definitions/entity-duplication-workflow.prompt.js";
+import { crossPlatformPerformancePrompt, getCrossPlatformPerformanceMessage, } from "./definitions/cross-platform-performance.prompt.js";
+import { crossPlatformCampaignSetupPrompt, getCrossPlatformCampaignSetupMessage, } from "./definitions/cross-platform-campaign-setup.prompt.js";
+import { pinterestCreativeUploadWorkflowPrompt, getPinterestCreativeUploadWorkflowMessage, } from "./definitions/creative-upload-workflow.prompt.js";
+export const promptRegistry = new Map([
+    [
+        campaignSetupWorkflowPrompt.name,
+        {
+            prompt: campaignSetupWorkflowPrompt,
+            generateMessage: getCampaignSetupWorkflowMessage,
+        },
+    ],
+    [
+        bulkOperationsWorkflowPrompt.name,
+        {
+            prompt: bulkOperationsWorkflowPrompt,
+            generateMessage: getBulkOperationsWorkflowMessage,
+        },
+    ],
+    [
+        pinterestToolSchemaExplorationPrompt.name,
+        {
+            prompt: pinterestToolSchemaExplorationPrompt,
+            generateMessage: getPinterestToolSchemaExplorationMessage,
+        },
+    ],
+    [
+        pinterestTroubleshootEntityPrompt.name,
+        {
+            prompt: pinterestTroubleshootEntityPrompt,
+            generateMessage: getPinterestTroubleshootEntityMessage,
+        },
+    ],
+    [
+        pinterestReportingWorkflowPrompt.name,
+        {
+            prompt: pinterestReportingWorkflowPrompt,
+            generateMessage: getPinterestReportingWorkflowMessage,
+        },
+    ],
+    [
+        pinterestEntityUpdateWorkflowPrompt.name,
+        {
+            prompt: pinterestEntityUpdateWorkflowPrompt,
+            generateMessage: getPinterestEntityUpdateWorkflowMessage,
+        },
+    ],
+    [
+        pinterestTargetingDiscoveryWorkflowPrompt.name,
+        {
+            prompt: pinterestTargetingDiscoveryWorkflowPrompt,
+            generateMessage: getPinterestTargetingDiscoveryWorkflowMessage,
+        },
+    ],
+    [
+        pinterestEntityDuplicationWorkflowPrompt.name,
+        {
+            prompt: pinterestEntityDuplicationWorkflowPrompt,
+            generateMessage: getPinterestEntityDuplicationWorkflowMessage,
+        },
+    ],
+    [
+        crossPlatformPerformancePrompt.name,
+        {
+            prompt: crossPlatformPerformancePrompt,
+            generateMessage: getCrossPlatformPerformanceMessage,
+        },
+    ],
+    [
+        crossPlatformCampaignSetupPrompt.name,
+        {
+            prompt: crossPlatformCampaignSetupPrompt,
+            generateMessage: getCrossPlatformCampaignSetupMessage,
+        },
+    ],
+    [
+        pinterestCreativeUploadWorkflowPrompt.name,
+        {
+            prompt: pinterestCreativeUploadWorkflowPrompt,
+            generateMessage: getPinterestCreativeUploadWorkflowMessage,
+        },
+    ],
+]);
+export function getAllPrompts() {
+    return Array.from(promptRegistry.values()).map((def) => def.prompt);
+}
+export function getPromptDefinition(name) {
+    return promptRegistry.get(name);
+}
+//# sourceMappingURL=index.js.map

package/dist/mcp-server/prompts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mcp-server/prompts/index.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,2BAA2B,EAC3B,+BAA+B,GAChC,MAAM,iDAAiD,CAAC;AACzD,OAAO,EACL,4BAA4B,EAC5B,gCAAgC,GACjC,MAAM,kDAAkD,CAAC;AAC1D,OAAO,EACL,oCAAoC,EACpC,wCAAwC,GACzC,MAAM,iDAAiD,CAAC;AACzD,OAAO,EACL,iCAAiC,EACjC,qCAAqC,GACtC,MAAM,6CAA6C,CAAC;AACrD,OAAO,EACL,gCAAgC,EAChC,oCAAoC,GACrC,MAAM,4CAA4C,CAAC;AACpD,OAAO,EACL,mCAAmC,EACnC,uCAAuC,GACxC,MAAM,gDAAgD,CAAC;AACxD,OAAO,EACL,yCAAyC,EACzC,6CAA6C,GAC9C,MAAM,sDAAsD,CAAC;AAC9D,OAAO,EACL,wCAAwC,EACxC,4CAA4C,GAC7C,MAAM,qDAAqD,CAAC;AAC7D,OAAO,EACL,8BAA8B,EAC9B,kCAAkC,GACnC,MAAM,oDAAoD,CAAC;AAC5D,OAAO,EACL,gCAAgC,EAChC,oCAAoC,GACrC,MAAM,uDAAuD,CAAC;AAC/D,OAAO,EACL,qCAAqC,EACrC,yCAAyC,GAC1C,MAAM,kDAAkD,CAAC;AAO1D,MAAM,CAAC,MAAM,cAAc,GAAkC,IAAI,GAAG,CAAC;IACnE;QACE,2BAA2B,CAAC,IAAI;QAChC;YACE,MAAM,EAAE,2BAA2B;YACnC,eAAe,EAAE,+BAA+B;SACjD;KACF;IACD;QACE,4BAA4B,CAAC,IAAI;QACjC;YACE,MAAM,EAAE,4BAA4B;YACpC,eAAe,EAAE,gCAAgC;SAClD;KACF;IACD;QACE,oCAAoC,CAAC,IAAI;QACzC;YACE,MAAM,EAAE,oCAAoC;YAC5C,eAAe,EAAE,wCAAwC;SAC1D;KACF;IACD;QACE,iCAAiC,CAAC,IAAI;QACtC;YACE,MAAM,EAAE,iCAAiC;YACzC,eAAe,EAAE,qCAAqC;SACvD;KACF;IACD;QACE,gCAAgC,CAAC,IAAI;QACrC;YACE,MAAM,EAAE,gCAAgC;YACxC,eAAe,EAAE,oCAAoC;SACtD;KACF;IACD;QACE,mCAAmC,CAAC,IAAI;QACxC;YACE,MAAM,EAAE,mCAAmC;YAC3C,eAAe,EAAE,uCAAuC;SACzD;KACF;IACD;QACE,yCAAyC,CAAC,IAAI;QAC9C;YACE,MAAM,EAAE,yCAAyC;YACjD,eAAe,EAAE,6CAA6C;SAC/D;KACF;IACD;QACE,wCAAwC,CAAC,IAAI;QAC7C;YACE,MAAM,EAAE,wCAAwC;YAChD,eAAe,EAAE,4CAA4C;SAC9D;KACF;IACD;QACE,8BAA8B,CAAC,IAAI;QACnC;YACE,MAAM,EAAE,8BAA8B;YACtC,eAAe,EAAE,kCAAkC;SACpD;KACF;IACD;QACE,gCAAgC,CAAC,IAAI;QACrC;YACE,MAAM,EAAE,gCAAgC;YACxC,eAAe,EAAE,oCAAoC;SACtD;KACF;IACD;QACE,qCAAqC,CAAC,IAAI;QAC1C;YACE,MAAM,EAAE,qCAAqC;YAC7C,eAAe,EAAE,yCAAyC;SAC3D;KACF;CACF,CAAC,CAAC;AAEH,MAAM,UAAU,aAAa;IAC3B,OAAO,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,OAAO,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAClC,CAAC"}

package/dist/mcp-server/resources/definitions/entity-examples.resource.d.ts

@@ -0,0 +1,4 @@
+import type { Resource } from "../types.js";
+export declare const entityExampleResources: Resource[];
+export declare const entityExampleAllResource: Resource;
+//# sourceMappingURL=entity-examples.resource.d.ts.map

package/dist/mcp-server/resources/definitions/entity-examples.resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-examples.resource.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/entity-examples.resource.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AA8K5C,eAAO,MAAM,sBAAsB,EAAE,QAAQ,EAQ1C,CAAC;AAEJ,eAAO,MAAM,wBAAwB,EAAE,QAMtC,CAAC"}

package/dist/mcp-server/resources/definitions/entity-examples.resource.js

@@ -0,0 +1,180 @@
+import { getSupportedEntityTypes, } from "../../tools/utils/entity-mapping.js";
+const ENTITY_EXAMPLE_CONTENT = {
+    campaign: `# Pinterest Campaign Examples
+
+## Create an Awareness Campaign (daily budget $50/day)
+\`\`\`json
+{
+  "entityType": "campaign",
+  "adAccountId": "549755885175",
+  "data": {
+    "name": "Spring Sale Awareness",
+    "objective_type": "AWARENESS",
+    "status": "ACTIVE",
+    "daily_spend_cap": 50000000
+  }
+}
+\`\`\`
+
+## Create a Conversions Campaign (lifetime budget)
+\`\`\`json
+{
+  "entityType": "campaign",
+  "adAccountId": "549755885175",
+  "data": {
+    "name": "Q2 2026 Conversions",
+    "objective_type": "CONVERSIONS",
+    "status": "ACTIVE",
+    "lifetime_spend_cap": 1000000000
+  }
+}
+\`\`\`
+
+## Pause a Campaign
+\`\`\`json
+{
+  "entityType": "campaign",
+  "adAccountId": "549755885175",
+  "entityId": "549755885175",
+  "data": {
+    "status": "PAUSED"
+  }
+}
+\`\`\`
+
+> **Budget note:** Pinterest uses micro-currency. $50/day = \`daily_spend_cap: 50000000\`
+`,
+    adGroup: `# Pinterest Ad Group Examples
+
+## Create an Ad Group with Audience Targeting
+\`\`\`json
+{
+  "entityType": "adGroup",
+  "adAccountId": "549755885175",
+  "data": {
+    "name": "Women 25-34 US",
+    "campaign_id": "549755885175",
+    "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": ["fashion", "beauty", "lifestyle"]
+    }
+  }
+}
+\`\`\`
+
+## Create an Always-On Ad Group (no end time)
+\`\`\`json
+{
+  "entityType": "adGroup",
+  "adAccountId": "549755885175",
+  "data": {
+    "name": "Retargeting - Site Visitors",
+    "campaign_id": "549755885175",
+    "status": "ACTIVE",
+    "budget_in_micro_currency": 5000000,
+    "pacing_delivery_type": "STANDARD",
+    "bid_strategy_type": "MAX_BID",
+    "start_time": "2026-04-01T00:00:00"
+  }
+}
+\`\`\`
+`,
+    ad: `# Pinterest Ad Examples
+
+## Create a Regular (static image) Ad
+\`\`\`json
+{
+  "entityType": "ad",
+  "adAccountId": "549755885175",
+  "data": {
+    "name": "Spring Pin Ad",
+    "ad_group_id": "2680060704746",
+    "creative_type": "REGULAR",
+    "pin_id": "1234567890",
+    "status": "ACTIVE"
+  }
+}
+\`\`\`
+
+## Create a Video Ad
+\`\`\`json
+{
+  "entityType": "ad",
+  "adAccountId": "549755885175",
+  "data": {
+    "name": "Product Video Ad",
+    "ad_group_id": "2680060704746",
+    "creative_type": "VIDEO",
+    "pin_id": "9876543210",
+    "status": "ACTIVE"
+  }
+}
+\`\`\`
+
+> **Note:** Ads reference Pinterest Pins by pin_id. Create/upload the Pin before creating the Ad.
+`,
+    creative: `# Pinterest Creative (Pin) Examples
+
+## Create an Image Creative
+\`\`\`json
+{
+  "entityType": "creative",
+  "adAccountId": "549755885175",
+  "data": {
+    "title": "Spring Sale - 50% Off",
+    "description": "Shop our Spring Sale collection — up to 50% off select items",
+    "link": "https://example.com/spring-sale",
+    "media": {
+      "source_type": "image_url",
+      "url": "https://example.com/spring-banner.jpg"
+    }
+  }
+}
+\`\`\`
+
+## Create a Video Creative
+\`\`\`json
+{
+  "entityType": "creative",
+  "adAccountId": "549755885175",
+  "data": {
+    "title": "New Collection Highlight",
+    "description": "Discover our newest arrivals for the season",
+    "link": "https://example.com/new-arrivals",
+    "media": {
+      "source_type": "video_url",
+      "url": "https://example.com/product-video.mp4"
+    }
+  }
+}
+\`\`\`
+`,
+};
+function buildAllExamplesMarkdown() {
+    return getSupportedEntityTypes()
+        .map((t) => ENTITY_EXAMPLE_CONTENT[t])
+        .join("\n\n---\n\n");
+}
+export const entityExampleResources = getSupportedEntityTypes().map((entityType) => ({
+    uri: `entity-examples://pinterest/${entityType}`,
+    name: `Pinterest ${entityType} Examples`,
+    description: `Example payloads for creating and updating Pinterest ${entityType} entities`,
+    mimeType: "text/markdown",
+    getContent: () => ENTITY_EXAMPLE_CONTENT[entityType] ??
+        `# Pinterest ${entityType} Examples\n\nNo examples available.\n`,
+}));
+export const entityExampleAllResource = {
+    uri: "entity-examples://pinterest/all",
+    name: "Pinterest All Entity Examples",
+    description: "Combined example payloads for all Pinterest Ads entity types",
+    mimeType: "text/markdown",
+    getContent: buildAllExamplesMarkdown,
+};
+//# sourceMappingURL=entity-examples.resource.js.map

package/dist/mcp-server/resources/definitions/entity-examples.resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-examples.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/entity-examples.resource.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,uBAAuB,GAExB,MAAM,qCAAqC,CAAC;AAE7C,MAAM,sBAAsB,GAAwC;IAClE,QAAQ,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2CX;IAEC,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyCV;IAEC,EAAE,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiCL;IAEC,QAAQ,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmCX;CACA,CAAC;AAEF,SAAS,wBAAwB;IAC/B,OAAO,uBAAuB,EAAE;SAC7B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;SACrC,IAAI,CAAC,aAAa,CAAC,CAAC;AACzB,CAAC;AAED,MAAM,CAAC,MAAM,sBAAsB,GAAe,uBAAuB,EAAE,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC/F,GAAG,EAAE,+BAA+B,UAAU,EAAE;IAChD,IAAI,EAAE,aAAa,UAAU,WAAW;IACxC,WAAW,EAAE,wDAAwD,UAAU,WAAW;IAC1F,QAAQ,EAAE,eAAe;IACzB,UAAU,EAAE,GAAG,EAAE,CACf,sBAAsB,CAAC,UAAU,CAAC;QAClC,eAAe,UAAU,uCAAuC;CACnE,CAAC,CAAC,CAAC;AAEJ,MAAM,CAAC,MAAM,wBAAwB,GAAa;IAChD,GAAG,EAAE,iCAAiC;IACtC,IAAI,EAAE,+BAA+B;IACrC,WAAW,EAAE,8DAA8D;IAC3E,QAAQ,EAAE,eAAe;IACzB,UAAU,EAAE,wBAAwB;CACrC,CAAC"}

package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.d.ts

@@ -0,0 +1,3 @@
+import type { Resource } from "../types.js";
+export declare const entityHierarchyResource: Resource;
+//# sourceMappingURL=entity-hierarchy.resource.d.ts.map

package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-hierarchy.resource.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/entity-hierarchy.resource.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAqI5C,eAAO,MAAM,uBAAuB,EAAE,QAUrC,CAAC"}

package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.js

@@ -0,0 +1,140 @@
+let cachedContent;
+function formatEntityHierarchyMarkdown() {
+    return `# Pinterest Ads Entity Hierarchy
+
+## Relationship Diagram
+
+\`\`\`
+Advertiser (ad_account_id: XXXXXXXXXX)
+  ├── Campaign (campaign_id)
+  │     └── Ad Group (adgroup_id)
+  │           └── Ad (ad_id)  ← references Creative
+  └── Creative (creative_id, reusable across ads)
+\`\`\`
+
+## Entity Types (4 total)
+
+| Entity Type | List Endpoint | Create Endpoint | ID Field |
+|-------------|---------------|-----------------|----------|
+| **campaign** | \`GET /v5/ad_accounts/{ad_account_id}/campaigns\` | \`POST /v5/ad_accounts/{ad_account_id}/campaigns\` | id |
+| **adGroup** | \`GET /v5/ad_accounts/{ad_account_id}/ad_groups\` | \`POST /v5/ad_accounts/{ad_account_id}/ad_groups\` | id |
+| **ad** | \`GET /v5/ad_accounts/{ad_account_id}/ads\` | \`POST /v5/ad_accounts/{ad_account_id}/ads\` | id |
+| **creative** | \`GET /v5/pins/{pin_id}\` | \`POST /v5/pins\` | id |
+
+## Key Relationships
+
+### Core Hierarchy: Advertiser → Campaign → Ad Group → Ad
+- A campaign has one or more ad groups.
+- An ad group has one or more ads.
+- An ad references creative assets (video_id or image_ids).
+
+### Reusable Entities
+- **Creatives** can be referenced by multiple ads within the same advertiser.
+
+## Creation Order
+
+Full campaign structure (top-down):
+
+1. **Advertiser** — pre-exists; discover with \`pinterest_list_ad_accounts\`
+2. **Creative(s)** — optional; can upload via Creative Library or reference video/image IDs
+3. **Campaign** — requires \`campaign_name\`, \`objective_type\`, \`budget_mode\`, \`budget\`
+4. **Ad Group(s)** — requires \`campaign_id\`, \`adgroup_name\`, \`placement_type\`, \`budget\`
+5. **Ad(s)** — requires \`adgroup_id\`, \`ad_name\`, \`creative_type\`, creative assets
+
+## Pinterest API Patterns
+
+### Read: GET with ad_account_id in URL path
+\`\`\`
+GET /v5/ad_accounts/123/campaigns?page_size=25&bookmark=<cursor>
+Authorization: Bearer <token>
+\`\`\`
+
+### Create: POST with entity fields in JSON body
+\`\`\`
+POST /v5/ad_accounts/123/campaigns
+{ "name": "My Campaign", "objective_type": "TRAFFIC", "status": "ACTIVE", ... }
+\`\`\`
+
+### Update: PATCH with changed fields in JSON body
+\`\`\`
+PATCH /v5/ad_accounts/123/campaigns
+{ "items": [{ "id": "456", "name": "Updated Name", "status": "PAUSED" }] }
+\`\`\`
+
+### Delete: DELETE with IDs in query params
+\`\`\`
+DELETE /v5/ad_accounts/123/campaigns?campaign_ids=456&campaign_ids=789
+\`\`\`
+
+### Response Shape
+List responses use cursor-based pagination:
+\`\`\`json
+{
+  "items": [...],
+  "bookmark": "<next_cursor>"
+}
+\`\`\`
+- \`bookmark\` is absent when there are no more pages
+- Single-entity responses return the entity object directly
+
+## Pagination
+
+Pinterest uses cursor-based pagination (NOT page-number based):
+- \`page_size\` — items per page (default 25, max 250)
+- \`bookmark\` — cursor token for next page (pass from previous response)
+- Response: no \`bookmark\` = last page
+
+## Available Tools Summary
+
+| Tool | Purpose | Batch? |
+|------|---------|--------|
+| \`pinterest_list_entities\` | List entities with filters | |
+| \`pinterest_get_entity\` | Get single entity | |
+| \`pinterest_create_entity\` | Create single entity | |
+| \`pinterest_update_entity\` | Update single entity | |
+| \`pinterest_delete_entity\` | Delete entities | ✓ |
+| \`pinterest_list_ad_accounts\` | List accessible advertisers | |
+| \`pinterest_get_report\` | Async report with polling | |
+| \`pinterest_get_report_breakdowns\` | Report with breakdown dimensions | |
+| \`pinterest_bulk_update_status\` | Batch status update | ✓ |
+| \`pinterest_bulk_create_entities\` | Batch entity creation | ✓ |
+| \`pinterest_bulk_update_entities\` | Batch entity updates | ✓ |
+| \`pinterest_adjust_bids\` | Batch bid adjustment | ✓ |
+| \`pinterest_search_targeting\` | Search targeting options | |
+| \`pinterest_get_targeting_options\` | Browse targeting categories | |
+| \`pinterest_duplicate_entity\` | Duplicate campaign/adGroup/ad | |
+| \`pinterest_get_audience_estimate\` | Audience size estimation | |
+| \`pinterest_get_ad_preview\` | Ad preview data | |
+| \`pinterest_validate_entity\` | Client-side payload validation | |
+
+## Budget Notes
+
+- Budget values are in the advertiser's account currency (no cents conversion)
+- \`budget_mode\`: BUDGET_MODE_DAY (daily) or BUDGET_MODE_TOTAL (lifetime)
+- Minimum budget varies by objective and market
+
+## Campaign Objectives
+
+| Objective | Use Case |
+|-----------|----------|
+| TRAFFIC | Drive website/app traffic |
+| APP_INSTALLS | Drive app downloads |
+| CONVERSIONS | Optimize for conversion events |
+| AWARENESS | Brand awareness / reach |
+| VIDEO_VIEWS | Maximize video plays |
+| LEAD_GENERATION | In-app lead forms |
+| CATALOG_SALES | Dynamic product ads |
+| COMMUNITY_INTERACTION | Profile visits, follows |
+`;
+}
+export const entityHierarchyResource = {
+    uri: "entity-hierarchy://pinterest/all",
+    name: "Pinterest Entity Hierarchy",
+    description: "Parent-child relationships between Pinterest Ads entities, API patterns, and creation ordering",
+    mimeType: "text/markdown",
+    getContent: () => {
+        cachedContent ??= formatEntityHierarchyMarkdown();
+        return cachedContent;
+    },
+};
+//# sourceMappingURL=entity-hierarchy.resource.js.map

package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-hierarchy.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/entity-hierarchy.resource.ts"],"names":[],"mappings":"AAQA,IAAI,aAAiC,CAAC;AAEtC,SAAS,6BAA6B;IACpC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6HR,CAAC;AACF,CAAC;AAED,MAAM,CAAC,MAAM,uBAAuB,GAAa;IAC/C,GAAG,EAAE,kCAAkC;IACvC,IAAI,EAAE,4BAA4B;IAClC,WAAW,EACT,gGAAgG;IAClG,QAAQ,EAAE,eAAe;IACzB,UAAU,EAAE,GAAG,EAAE;QACf,aAAa,KAAK,6BAA6B,EAAE,CAAC;QAClD,OAAO,aAAa,CAAC;IACvB,CAAC;CACF,CAAC"}

package/dist/mcp-server/resources/definitions/entity-schemas.resource.d.ts

@@ -0,0 +1,4 @@
+import type { Resource } from "../types.js";
+export declare const entitySchemaResources: Resource[];
+export declare const entitySchemaAllResource: Resource;
+//# sourceMappingURL=entity-schemas.resource.d.ts.map

package/dist/mcp-server/resources/definitions/entity-schemas.resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-schemas.resource.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/entity-schemas.resource.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AA2H5C,eAAO,MAAM,qBAAqB,EAAE,QAAQ,EAMzC,CAAC;AAEJ,eAAO,MAAM,uBAAuB,EAAE,QAMrC,CAAC"}