@cesteral/pinterest-mcp 1.0.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"entity-duplication-workflow.prompt.js","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/entity-duplication-workflow.prompt.ts"],"names":[],"mappings":"AAWA,MAAM,CAAC,MAAM,wCAAwC,GAAW;IAC9D,IAAI,EAAE,uCAAuC;IAC7C,WAAW,EACT,qKAAqK;IACvK,SAAS,EAAE;QACT;YACE,IAAI,EAAE,YAAY;YAClB,WAAW,EAAE,oDAAoD;YACjE,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,UAAU;YAChB,WAAW,EAAE,uCAAuC;YACpD,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,aAAa;YACnB,WAAW,EAAE,yBAAyB;YACtC,QAAQ,EAAE,IAAI;SACf;KACF;CACF,CAAC;AAEF,MAAM,UAAU,4CAA4C,CAC1D,IAA6B;IAE7B,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;;iBAEQ,UAAU;eACZ,QAAQ;mBACJ,WAAW;;;;;;;;;;;;;;;;;;;;;;;;qBAwBT,UAAU;sBACT,WAAW;mBACd,QAAQ;;;;;;;;;;;;;;;qBAeN,UAAU;sBACT,WAAW;mBACd,QAAQ;;4BAEC,UAAU,IAAI,QAAQ;;;;;;;;;;;;;;;;;;;;;;qBAsB7B,UAAU;sBACT,WAAW;;;;;;;;;;;;;;;;;sBAiBX,WAAW;;;;;;;;;;;;;;;;;;;;;;;qBAuBZ,UAAU;sBACT,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBA0CZ,UAAU;sBACT,WAAW;;;;;;;;;;;;;;CAchC,CAAC;AACF,CAAC"}

package/dist/mcp-server/prompts/definitions/entity-update-workflow.prompt.d.ts

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

package/dist/mcp-server/prompts/definitions/entity-update-workflow.prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-update-workflow.prompt.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/entity-update-workflow.prompt.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AASjE,eAAO,MAAM,mCAAmC,EAAE,MAqBjD,CAAC;AAEF,wBAAgB,uCAAuC,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAsK7F"}

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

@@ -0,0 +1,188 @@
+export const pinterestEntityUpdateWorkflowPrompt = {
+    name: "pinterest_entity_update_workflow",
+    description: "Step-by-step guide for safely updating Pinterest Ads entities — covers field updates vs status changes (separate endpoints), budget values in account currency, and verification.",
+    arguments: [
+        {
+            name: "entityType",
+            description: "Entity type to update: campaign, adGroup, or ad",
+            required: true,
+        },
+        {
+            name: "entityId",
+            description: "Numeric ID of the entity to update",
+            required: true,
+        },
+        {
+            name: "adAccountId",
+            description: "Pinterest Advertiser ID",
+            required: true,
+        },
+    ],
+};
+export function getPinterestEntityUpdateWorkflowMessage(args) {
+    const entityType = args?.entityType || "{entityType}";
+    const entityId = args?.entityId || "{entityId}";
+    const adAccountId = args?.adAccountId || "{adAccountId}";
+    return `# Pinterest Ads Entity Update Workflow
+
+Entity Type: \`${entityType}\`
+Entity ID: \`${entityId}\`
+Advertiser ID: \`${adAccountId}\`
+
+---
+
+## Step 1: Fetch Current State
+
+Before updating, always read the entity's current configuration:
+
+\`\`\`json
+{
+  "tool": "pinterest_get_entity",
+  "params": {
+    "entityType": "${entityType}",
+    "adAccountId": "${adAccountId}",
+    "entityId": "${entityId}"
+  }
+}
+\`\`\`
+
+Review the current values. Save the current state for rollback reference.
+
+**Resource reference:** Fetch \`entity-schema://pinterest/${entityType}\` for the full field schema and \`entity-examples://pinterest/${entityType}\` for common update patterns.
+
+---
+
+## Step 2: Update Entity Fields
+
+Use \`pinterest_update_entity\` for **field changes** (name, budget, bid, targeting):
+
+### Campaign Updates
+
+\`\`\`json
+{
+  "tool": "pinterest_update_entity",
+  "params": {
+    "entityType": "campaign",
+    "adAccountId": "${adAccountId}",
+    "entityId": "${entityId}",
+    "data": {
+      "name": "Updated Campaign Name",
+      "daily_spend_cap": 100000000
+    }
+  }
+}
+\`\`\`
+
+### Ad Group Updates
+
+\`\`\`json
+{
+  "tool": "pinterest_update_entity",
+  "params": {
+    "entityType": "adGroup",
+    "adAccountId": "${adAccountId}",
+    "entityId": "${entityId}",
+    "data": {
+      "name": "Updated Ad Group",
+      "budget": 100,
+      "bid_price": 0.8,
+      "age": ["AGE_25_34", "AGE_35_44"],
+      "gender": ["GENDER_UNLIMITED"],
+      "location_ids": ["US", "GB"]
+    }
+  }
+}
+\`\`\`
+
+### Ad Updates
+
+\`\`\`json
+{
+  "tool": "pinterest_update_entity",
+  "params": {
+    "entityType": "ad",
+    "adAccountId": "${adAccountId}",
+    "entityId": "${entityId}",
+    "data": {
+      "ad_name": "Updated Ad Name",
+      "ad_text": "New ad copy (max 100 chars)",
+      "call_to_action": "SHOP_NOW",
+      "landing_page_url": "https://example.com/new-page"
+    }
+  }
+}
+\`\`\`
+
+---
+
+## Step 3: Update Status (Separate Endpoint)
+
+⚠️ **CRITICAL GOTCHA**: Pinterest uses a **separate endpoint** for status changes. Do NOT include \`operation_status\` in \`pinterest_update_entity\` — it won't work.
+
+Use \`pinterest_bulk_update_status\` for all status changes:
+
+\`\`\`json
+{
+  "tool": "pinterest_bulk_update_status",
+  "params": {
+    "entityType": "${entityType}",
+    "adAccountId": "${adAccountId}",
+    "entityIds": ["${entityId}"],
+    "operationStatus": "ACTIVE"
+  }
+}
+\`\`\`
+
+Valid status values: \`"ACTIVE"\`, \`"PAUSED"\`, \`"ARCHIVED"\`
+
+---
+
+## Step 4: Verify Changes
+
+After the update call succeeds, verify the changes:
+
+\`\`\`json
+{
+  "tool": "pinterest_get_entity",
+  "params": {
+    "entityType": "${entityType}",
+    "adAccountId": "${adAccountId}",
+    "entityId": "${entityId}"
+  }
+}
+\`\`\`
+
+---
+
+## Gotchas
+
+- **Status changes use a different tool**: Never use \`pinterest_update_entity\` for enabling/disabling entities — use \`pinterest_bulk_update_status\`.
+- **Budget values are in account currency**: \`budget: 100\` means $100.00 (not cents, not micros).
+- **Targeting replaces on ad group**: When updating targeting fields on an ad group, include all targeting you want to keep.
+- **Video IDs are immutable**: You cannot change the video on an existing ad. Delete and recreate instead.
+- **Ad review re-triggered**: Updating ad copy or creative may trigger a new review cycle (24-48h).
+
+---
+
+## Rollback
+
+If an update causes issues, reverse it by sending the original values:
+
+\`\`\`json
+{
+  "tool": "pinterest_update_entity",
+  "params": {
+    "entityType": "${entityType}",
+    "adAccountId": "${adAccountId}",
+    "entityId": "${entityId}",
+    "data": {
+      "field_that_was_changed": "{original_value}"
+    }
+  }
+}
+\`\`\`
+
+Report the rollback hint (original values) whenever you make a change so the user can revert if needed.
+`;
+}
+//# sourceMappingURL=entity-update-workflow.prompt.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"entity-update-workflow.prompt.js","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/entity-update-workflow.prompt.ts"],"names":[],"mappings":"AAYA,MAAM,CAAC,MAAM,mCAAmC,GAAW;IACzD,IAAI,EAAE,kCAAkC;IACxC,WAAW,EACT,mLAAmL;IACrL,SAAS,EAAE;QACT;YACE,IAAI,EAAE,YAAY;YAClB,WAAW,EAAE,iDAAiD;YAC9D,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,UAAU;YAChB,WAAW,EAAE,oCAAoC;YACjD,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,aAAa;YACnB,WAAW,EAAE,yBAAyB;YACtC,QAAQ,EAAE,IAAI;SACf;KACF;CACF,CAAC;AAEF,MAAM,UAAU,uCAAuC,CAAC,IAA6B;IACnF,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;;iBAEQ,UAAU;eACZ,QAAQ;mBACJ,WAAW;;;;;;;;;;;;qBAYT,UAAU;sBACT,WAAW;mBACd,QAAQ;;;;;;;4DAOiC,UAAU,kEAAkE,UAAU;;;;;;;;;;;;;;;sBAe5H,WAAW;mBACd,QAAQ;;;;;;;;;;;;;;;;sBAgBL,WAAW;mBACd,QAAQ;;;;;;;;;;;;;;;;;;;;sBAoBL,WAAW;mBACd,QAAQ;;;;;;;;;;;;;;;;;;;;;;;qBAuBN,UAAU;sBACT,WAAW;qBACZ,QAAQ;;;;;;;;;;;;;;;;;;qBAkBR,UAAU;sBACT,WAAW;mBACd,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;qBAyBN,UAAU;sBACT,WAAW;mBACd,QAAQ;;;;;;;;;CAS1B,CAAC;AACF,CAAC"}

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

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

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

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

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

@@ -0,0 +1,126 @@
+export const pinterestReportingWorkflowPrompt = {
+    name: "pinterest_reporting_workflow",
+    description: "Guide for submitting and retrieving Pinterest Ads async reports with dimensions, metrics, and breakdowns",
+    arguments: [
+        {
+            name: "adAccountId",
+            description: "Pinterest Advertiser ID",
+            required: true,
+        },
+        {
+            name: "reportLevel",
+            description: "Report level: AUCTION, RESERVATION (default: AUCTION)",
+            required: false,
+        },
+    ],
+};
+export function getPinterestReportingWorkflowMessage(args) {
+    const adAccountId = args?.adAccountId || "{adAccountId}";
+    const reportLevel = args?.reportLevel || "AUCTION";
+    return `# Pinterest Reporting Workflow
+
+Advertiser: \`${adAccountId}\`
+Report Level: \`${reportLevel}\`
+
+---
+
+## Overview
+
+Pinterest reports are **async** — \`pinterest_get_report\` submits the job, polls for completion, and returns the results when ready.
+
+---
+
+## Step 1: Basic Campaign Report
+
+\`\`\`json
+pinterest_get_report({
+  "adAccountId": "${adAccountId}",
+  "dimensions": ["campaign_id", "stat_time_day"],
+  "metrics": ["impressions", "clicks", "spend", "ctr", "cpc", "conversions", "cost_per_conversion"],
+  "startDate": "2026-02-01",
+  "endDate": "2026-03-07"
+})
+\`\`\`
+
+## Step 2: Ad Group Level Report
+
+\`\`\`json
+pinterest_get_report({
+  "adAccountId": "${adAccountId}",
+  "dimensions": ["adgroup_id", "stat_time_day"],
+  "metrics": ["impressions", "clicks", "spend", "video_play_actions", "video_watched_2s", "video_watched_6s"],
+  "startDate": "2026-02-01",
+  "endDate": "2026-03-07"
+})
+\`\`\`
+
+## Step 3: Breakdown Report
+
+Add demographic and contextual breakdowns to your report:
+
+\`\`\`json
+pinterest_get_report_breakdowns({
+  "adAccountId": "${adAccountId}",
+  "dimensions": ["campaign_id"],
+  "breakdowns": ["gender", "age"],
+  "metrics": ["impressions", "clicks", "spend", "conversions"],
+  "startDate": "2026-02-01",
+  "endDate": "2026-03-07"
+})
+\`\`\`
+
+## Step 4: Video Engagement Report
+
+\`\`\`json
+pinterest_get_report({
+  "adAccountId": "${adAccountId}",
+  "dimensions": ["ad_id"],
+  "metrics": [
+    "impressions", "video_play_actions", "video_watched_2s",
+    "video_watched_6s", "video_views_p25", "video_views_p50",
+    "video_views_p75", "video_views_p100"
+  ],
+  "startDate": "2026-02-01",
+  "endDate": "2026-03-07"
+})
+\`\`\`
+
+## Resource References
+
+- Fetch \`reporting-reference://pinterest\` for full metrics and dimensions list
+- Fetch \`entity-hierarchy://pinterest/all\` for entity relationships
+
+## Common Dimensions
+
+| Dimension | Level |
+|-----------|-------|
+| \`campaign_id\` | Campaign |
+| \`adgroup_id\` | Ad Group |
+| \`ad_id\` | Ad |
+| \`stat_time_day\` | Daily breakdown |
+| \`stat_time_hour\` | Hourly breakdown |
+
+## Common Metrics
+
+| Metric | Description |
+|--------|-------------|
+| \`impressions\` | Total impressions |
+| \`clicks\` | Total clicks |
+| \`spend\` | Total spend (account currency) |
+| \`ctr\` | Click-through rate |
+| \`cpc\` | Cost per click |
+| \`conversions\` | Total conversions |
+| \`cost_per_conversion\` | CPA |
+| \`video_play_actions\` | Video starts |
+| \`video_watched_2s\` | 2-second video views |
+| \`video_watched_6s\` | 6-second video views |
+
+## Tips
+
+- Reports may take **30 seconds to several minutes** depending on date range and data volume
+- Data has a **24-48 hour lag** for finalized metrics
+- Max date range per report is **180 days**
+- Budget and spend values are in **account currency** (not cents, not micros)
+`;
+}
+//# sourceMappingURL=reporting-workflow.prompt.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reporting-workflow.prompt.js","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/reporting-workflow.prompt.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,gCAAgC,GAAW;IACtD,IAAI,EAAE,8BAA8B;IACpC,WAAW,EACT,0GAA0G;IAC5G,SAAS,EAAE;QACT;YACE,IAAI,EAAE,aAAa;YACnB,WAAW,EAAE,yBAAyB;YACtC,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,aAAa;YACnB,WAAW,EAAE,uDAAuD;YACpE,QAAQ,EAAE,KAAK;SAChB;KACF;CACF,CAAC;AAEF,MAAM,UAAU,oCAAoC,CAAC,IAA6B;IAChF,MAAM,WAAW,GAAG,IAAI,EAAE,WAAW,IAAI,eAAe,CAAC;IACzD,MAAM,WAAW,GAAG,IAAI,EAAE,WAAW,IAAI,SAAS,CAAC;IAEnD,OAAO;;gBAEO,WAAW;kBACT,WAAW;;;;;;;;;;;;;;oBAcT,WAAW;;;;;;;;;;;;oBAYX,WAAW;;;;;;;;;;;;;;oBAcX,WAAW;;;;;;;;;;;;;oBAaX,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgD9B,CAAC;AACF,CAAC"}

package/dist/mcp-server/prompts/definitions/targeting-discovery-workflow.prompt.d.ts

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

package/dist/mcp-server/prompts/definitions/targeting-discovery-workflow.prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"targeting-discovery-workflow.prompt.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/targeting-discovery-workflow.prompt.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAQjE,eAAO,MAAM,yCAAyC,EAAE,MAiBvD,CAAC;AAEF,wBAAgB,6CAA6C,CAC3D,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC5B,MAAM,CAoLR"}

package/dist/mcp-server/prompts/definitions/targeting-discovery-workflow.prompt.js

@@ -0,0 +1,197 @@
+export const pinterestTargetingDiscoveryWorkflowPrompt = {
+    name: "pinterest_targeting_discovery_workflow",
+    description: "Step-by-step guide for researching Pinterest audiences: search interest categories, browse behaviors, build targeting configs, and estimate audience size before ad group creation.",
+    arguments: [
+        {
+            name: "adAccountId",
+            description: "Pinterest Advertiser ID",
+            required: true,
+        },
+        {
+            name: "goal",
+            description: "Research goal: 'search' (find by keyword), 'browse' (explore options), or 'build' (assemble targeting). Default: search",
+            required: false,
+        },
+    ],
+};
+export function getPinterestTargetingDiscoveryWorkflowMessage(args) {
+    const adAccountId = args?.adAccountId || "{adAccountId}";
+    const goal = args?.goal || "search";
+    return `# Pinterest Targeting Discovery Workflow
+
+Advertiser: \`${adAccountId}\`
+Goal: \`${goal}\`
+
+---
+
+## Overview
+
+Before creating ad groups, you need to build a **targeting configuration** — the fields that define your Pinterest audience. This workflow helps you discover and validate targeting options.
+
+| Tool | Purpose | Use When |
+|------|---------|----------|
+| \`pinterest_search_targeting\` | Search by keyword | You know the audience you want |
+| \`pinterest_get_targeting_options\` | Browse available targeting | You want to explore what's available |
+| \`pinterest_get_audience_estimate\` | Estimate audience size | Before committing to targeting |
+
+---
+
+## Step 1: Search Targeting Options
+
+Search for interest categories by keyword:
+
+\`\`\`json
+{
+  "tool": "pinterest_search_targeting",
+  "params": {
+    "adAccountId": "${adAccountId}",
+    "targetingType": "INTEREST_KEYWORD",
+    "query": "fitness"
+  }
+}
+\`\`\`
+
+Each result includes:
+- \`id\` — The targeting ID to use in your ad group
+- \`name\` — Human-readable label
+
+### Key Targeting Types
+
+| Targeting Type | What It Searches | Example |
+|----------------|-----------------|---------|
+| \`INTEREST_KEYWORD\` | Interest categories | "fitness", "gaming" |
+| \`BEHAVIOR\` | Behavioral segments | App engagement behaviors |
+| \`HASHTAG\` | Hashtag interest groups | "DIY", "travel" |
+
+---
+
+## Step 2: Browse Targeting Categories
+
+To explore all available targeting options for your account:
+
+\`\`\`json
+{
+  "tool": "pinterest_get_targeting_options",
+  "params": {
+    "adAccountId": "${adAccountId}"
+  }
+}
+\`\`\`
+
+Filter by type:
+
+\`\`\`json
+{
+  "tool": "pinterest_get_targeting_options",
+  "params": {
+    "adAccountId": "${adAccountId}",
+    "targetingType": "INTEREST"
+  }
+}
+\`\`\`
+
+---
+
+## Step 3: Build Ad Group Targeting
+
+Combine your research into an ad group payload:
+
+\`\`\`json
+{
+  "age": ["AGE_18_24", "AGE_25_34", "AGE_35_44"],
+  "gender": ["GENDER_UNLIMITED"],
+  "location_ids": ["US", "GB"],
+  "interest_keyword_ids": ["123456", "789012"],
+  "operating_systems": ["IOS", "ANDROID"],
+  "placement_type": "PLACEMENT_TYPE_NORMAL",
+  "bid_type": "BID_TYPE_CUSTOM",
+  "bid_price": 0.5,
+  "optimize_goal": "CLICK"
+}
+\`\`\`
+
+### Key Targeting Fields
+
+| Field | Type | Description |
+|-------|------|-------------|
+| \`age\` | Array | Age groups: AGE_13_17 through AGE_55_PLUS |
+| \`gender\` | Array | GENDER_MALE, GENDER_FEMALE, GENDER_UNLIMITED |
+| \`location_ids\` | Array | Country codes or location IDs |
+| \`interest_keyword_ids\` | Array | Interest keyword IDs from search |
+| \`operating_systems\` | Array | IOS, ANDROID |
+| \`placement_type\` | String | PLACEMENT_TYPE_NORMAL (auto), PLACEMENT_TYPE_SEARCH |
+| \`bid_price\` | Number | Bid in account currency |
+
+⚠️ **GOTCHA**: Age group values are enum strings — use exact values like \`AGE_18_24\`, not ranges like \`18-24\`.
+
+⚠️ **GOTCHA**: Location IDs can be country codes (e.g., "US") or numeric IDs for cities/regions — use \`pinterest_search_targeting\` to find valid values.
+
+---
+
+## Step 4: Estimate Audience Size
+
+Before creating the ad group, verify your targeting reaches a viable audience:
+
+\`\`\`json
+{
+  "tool": "pinterest_get_audience_estimate",
+  "params": {
+    "adAccountId": "${adAccountId}",
+    "targetingConfig": {
+      "age": ["AGE_18_24", "AGE_25_34"],
+      "gender": ["GENDER_UNLIMITED"],
+      "location_ids": ["US"],
+      "interest_keyword_ids": ["123456"]
+    }
+  }
+}
+\`\`\`
+
+Interpret results:
+- **Too narrow** (< 50K reach) → Broaden age groups or add more interests
+- **Too broad** (> 100M reach) → Add more specific interests or narrow demographics
+- **Sweet spot**: 1M–50M for most Pinterest campaigns
+
+---
+
+## Step 5: Apply to Ad Group
+
+Use the targeting when creating or updating an ad group:
+
+\`\`\`json
+{
+  "tool": "pinterest_create_entity",
+  "params": {
+    "entityType": "adGroup",
+    "adAccountId": "${adAccountId}",
+    "data": {
+      "campaign_id": "{campaignId}",
+      "name": "US Fitness Enthusiasts 18-34",
+      "placement_type": "PLACEMENT_TYPE_NORMAL",
+      "daily_spend_cap": 50000000,
+      "schedule_type": "SCHEDULE_START_END",
+      "schedule_start_time": "2026-03-10 00:00:00",
+      "schedule_end_time": "2026-12-31 23:59:59",
+      "optimize_goal": "CLICK",
+      "bid_type": "BID_TYPE_CUSTOM",
+      "bid_price": 0.5,
+      "age": ["AGE_18_24", "AGE_25_34"],
+      "gender": ["GENDER_UNLIMITED"],
+      "location_ids": ["US"],
+      "interest_keyword_ids": ["123456"]
+    }
+  }
+}
+\`\`\`
+
+⚠️ **GOTCHA**: Budget values are in **account currency** — \`budget: 50\` means $50.00.
+
+---
+
+## Related Resources
+- \`reporting-reference://pinterest\` — Reporting metrics and dimensions
+- \`entity-schema://pinterest/adGroup\` — Ad Group fields including all targeting parameters
+- \`entity-examples://pinterest/adGroup\` — Example ad group payloads with targeting
+`;
+}
+//# sourceMappingURL=targeting-discovery-workflow.prompt.js.map

package/dist/mcp-server/prompts/definitions/targeting-discovery-workflow.prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"targeting-discovery-workflow.prompt.js","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/targeting-discovery-workflow.prompt.ts"],"names":[],"mappings":"AAWA,MAAM,CAAC,MAAM,yCAAyC,GAAW;IAC/D,IAAI,EAAE,wCAAwC;IAC9C,WAAW,EACT,qLAAqL;IACvL,SAAS,EAAE;QACT;YACE,IAAI,EAAE,aAAa;YACnB,WAAW,EAAE,yBAAyB;YACtC,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,MAAM;YACZ,WAAW,EACT,yHAAyH;YAC3H,QAAQ,EAAE,KAAK;SAChB;KACF;CACF,CAAC;AAEF,MAAM,UAAU,6CAA6C,CAC3D,IAA6B;IAE7B,MAAM,WAAW,GAAG,IAAI,EAAE,WAAW,IAAI,eAAe,CAAC;IACzD,MAAM,IAAI,GAAG,IAAI,EAAE,IAAI,IAAI,QAAQ,CAAC;IAEpC,OAAO;;gBAEO,WAAW;UACjB,IAAI;;;;;;;;;;;;;;;;;;;;;;;;sBAwBQ,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBA6BX,WAAW;;;;;;;;;;;sBAWX,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAoDX,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;sBA2BX,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6BhC,CAAC;AACF,CAAC"}

package/dist/mcp-server/prompts/definitions/tool-schema-exploration.prompt.d.ts

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

package/dist/mcp-server/prompts/definitions/tool-schema-exploration.prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-schema-exploration.prompt.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/tool-schema-exploration.prompt.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAEjE,eAAO,MAAM,oCAAoC,EAAE,MAYlD,CAAC;AAEF,wBAAgB,wCAAwC,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAiF9F"}

package/dist/mcp-server/prompts/definitions/tool-schema-exploration.prompt.js

@@ -0,0 +1,93 @@
+export const pinterestToolSchemaExplorationPrompt = {
+    name: "pinterest_tool_schema_exploration",
+    description: "Guide for discovering and understanding Pinterest MCP tools, resources, and schemas",
+    arguments: [
+        {
+            name: "objective",
+            description: "Exploration objective (e.g., campaign management, reporting, targeting, bulk operations)",
+            required: false,
+        },
+    ],
+};
+export function getPinterestToolSchemaExplorationMessage(args) {
+    const objective = args?.objective || "general capability discovery";
+    return `# Pinterest MCP Tool & Schema Exploration Guide
+
+## Context
+- Server: pinterest-mcp (Pinterest Ads Campaign Management)
+- Objective: ${objective}
+
+Use this workflow to discover Pinterest MCP capabilities while minimizing token usage.
+
+---
+
+## Available MCP Resources
+
+Fetch these resources for detailed schema information:
+
+| Resource URI | Content |
+|-------------|---------|
+| \`entity-hierarchy://pinterest/all\` | Entity relationships, API patterns, creation order |
+| \`entity-schema://pinterest/campaign\` | Campaign fields |
+| \`entity-schema://pinterest/adGroup\` | Ad Group fields + targeting |
+| \`entity-schema://pinterest/ad\` | Ad fields |
+| \`entity-schema://pinterest/creative\` | Creative fields |
+| \`entity-examples://pinterest/all\` | All entity examples |
+| \`entity-examples://pinterest/{type}\` | Examples for specific type |
+| \`reporting-reference://pinterest\` | Metrics, dimensions, and breakdown options |
+
+## Tool Categories
+
+### Read Operations
+- \`pinterest_list_ad_accounts\` — List accessible advertiser accounts
+- \`pinterest_list_entities\` — List entities with page pagination
+- \`pinterest_get_entity\` — Get single entity by ID
+
+### Write Operations
+- \`pinterest_create_entity\` — Create entity
+- \`pinterest_update_entity\` — Update entity fields
+- \`pinterest_delete_entity\` — Delete entities
+
+### Reporting (Async)
+- \`pinterest_get_report\` — Submit async report and download results
+- \`pinterest_get_report_breakdowns\` — Report with breakdown dimensions
+
+### Bulk Operations
+- \`pinterest_bulk_update_status\` — Batch enable/disable/delete entities
+- \`pinterest_bulk_create_entities\` — Batch creation (up to 50)
+- \`pinterest_bulk_update_entities\` — Batch updates (up to 50)
+- \`pinterest_adjust_bids\` — Batch adjust ad group bid prices
+
+### Targeting
+- \`pinterest_search_targeting\` — Search interest categories, behaviors, demographics
+- \`pinterest_get_targeting_options\` — Browse targeting categories
+
+### Specialized
+- \`pinterest_duplicate_entity\` — Copy campaigns, ad groups, ads
+- \`pinterest_get_audience_estimate\` — Audience size estimation
+- \`pinterest_get_ad_preview\` — Ad preview for video/image ads
+
+### Validation
+- \`pinterest_validate_entity\` — Client-side entity validation
+
+## Workflow Prompts
+
+| Task | Prompt |
+|------|--------|
+| Create a full campaign structure | \`pinterest_campaign_setup_workflow\` |
+| Research audiences & build targeting | \`pinterest_targeting_discovery_workflow\` |
+| Update entities safely | \`pinterest_entity_update_workflow\` |
+| Duplicate campaigns/ad groups/ads | \`pinterest_entity_duplication_workflow\` |
+| Bulk create/update/status/bids | \`pinterest_bulk_operations_workflow\` |
+| Async reporting & breakdowns | \`pinterest_reporting_workflow\` |
+| Troubleshoot entity issues | \`pinterest_troubleshoot_entity\` |
+
+## Recommended Exploration Order
+
+1. Start with \`pinterest_list_ad_accounts\` to find your account
+2. Fetch \`entity-hierarchy://pinterest/all\` for API patterns
+3. Fetch \`entity-schema://pinterest/{type}\` for field details
+4. Fetch \`entity-examples://pinterest/{type}\` for payload templates
+`;
+}
+//# sourceMappingURL=tool-schema-exploration.prompt.js.map

package/dist/mcp-server/prompts/definitions/tool-schema-exploration.prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-schema-exploration.prompt.js","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/tool-schema-exploration.prompt.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,oCAAoC,GAAW;IAC1D,IAAI,EAAE,mCAAmC;IACzC,WAAW,EACT,qFAAqF;IACvF,SAAS,EAAE;QACT;YACE,IAAI,EAAE,WAAW;YACjB,WAAW,EACT,0FAA0F;YAC5F,QAAQ,EAAE,KAAK;SAChB;KACF;CACF,CAAC;AAEF,MAAM,UAAU,wCAAwC,CAAC,IAA6B;IACpF,MAAM,SAAS,GAAG,IAAI,EAAE,SAAS,IAAI,8BAA8B,CAAC;IAEpE,OAAO;;;;eAIM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyEvB,CAAC;AACF,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"troubleshoot-entity.prompt.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/troubleshoot-entity.prompt.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAEjE,eAAO,MAAM,iCAAiC,EAAE,MAoB/C,CAAC;AAEF,wBAAgB,qCAAqC,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAyF3F"}