@cesteral/snapchat-mcp 1.0.0

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

@@ -0,0 +1,126 @@
+export const snapchatReportingWorkflowPrompt = {
+    name: "snapchat_reporting_workflow",
+    description: "Guide for submitting and retrieving Snapchat Ads async reports with dimensions, metrics, and breakdowns",
+    arguments: [
+        {
+            name: "adAccountId",
+            description: "Snapchat Advertiser ID",
+            required: true,
+        },
+        {
+            name: "reportLevel",
+            description: "Report level: AUCTION, RESERVATION (default: AUCTION)",
+            required: false,
+        },
+    ],
+};
+export function getSnapchatReportingWorkflowMessage(args) {
+    const adAccountId = args?.adAccountId || "{adAccountId}";
+    const reportLevel = args?.reportLevel || "AUCTION";
+    return `# Snapchat Reporting Workflow
+
+Advertiser: \`${adAccountId}\`
+Report Level: \`${reportLevel}\`
+
+---
+
+## Overview
+
+Snapchat reports are **async** — \`snapchat_get_report\` submits the job, polls for completion, and returns the results when ready.
+
+---
+
+## Step 1: Basic Campaign Report
+
+\`\`\`json
+snapchat_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
+snapchat_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
+snapchat_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
+snapchat_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://snapchat\` for full metrics and dimensions list
+- Fetch \`entity-hierarchy://snapchat/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,+BAA+B,GAAW;IACrD,IAAI,EAAE,6BAA6B;IACnC,WAAW,EACT,yGAAyG;IAC3G,SAAS,EAAE;QACT;YACE,IAAI,EAAE,aAAa;YACnB,WAAW,EAAE,wBAAwB;YACrC,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,aAAa;YACnB,WAAW,EAAE,uDAAuD;YACpE,QAAQ,EAAE,KAAK;SAChB;KACF;CACF,CAAC;AAEF,MAAM,UAAU,mCAAmC,CAAC,IAA6B;IAC/E,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 snapchatTargetingDiscoveryWorkflowPrompt: Prompt;
+export declare function getSnapchatTargetingDiscoveryWorkflowMessage(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,wCAAwC,EAAE,MAiBtD,CAAC;AAEF,wBAAgB,4CAA4C,CAC1D,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC5B,MAAM,CAqLR"}

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

@@ -0,0 +1,198 @@
+export const snapchatTargetingDiscoveryWorkflowPrompt = {
+    name: "snapchat_targeting_discovery_workflow",
+    description: "Step-by-step guide for researching Snapchat audiences: search interest categories, browse behaviors, build targeting configs, and estimate audience size before ad group creation.",
+    arguments: [
+        {
+            name: "adAccountId",
+            description: "Snapchat 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 getSnapchatTargetingDiscoveryWorkflowMessage(args) {
+    const adAccountId = args?.adAccountId || "{adAccountId}";
+    const goal = args?.goal || "search";
+    return `# Snapchat Targeting Discovery Workflow
+
+Advertiser: \`${adAccountId}\`
+Goal: \`${goal}\`
+
+---
+
+## Overview
+
+Before creating ad groups, you need to build a **targeting configuration** — the fields that define your Snapchat audience. This workflow helps you discover and validate targeting options.
+
+| Tool | Purpose | Use When |
+|------|---------|----------|
+| \`snapchat_search_targeting\` | Search by keyword | You know the audience you want |
+| \`snapchat_get_targeting_options\` | Browse available targeting | You want to explore what's available |
+| \`snapchat_get_audience_estimate\` | Estimate audience size | Before committing to targeting |
+
+---
+
+## Step 1: Search Targeting Options
+
+Search for interest categories by keyword:
+
+\`\`\`json
+{
+  "tool": "snapchat_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": "snapchat_get_targeting_options",
+  "params": {
+    "adAccountId": "${adAccountId}"
+  }
+}
+\`\`\`
+
+Filter by type:
+
+\`\`\`json
+{
+  "tool": "snapchat_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 \`snapchat_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": "snapchat_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 Snapchat campaigns
+
+---
+
+## Step 5: Apply to Ad Group
+
+Use the targeting when creating or updating an ad group:
+
+\`\`\`json
+{
+  "tool": "snapchat_create_entity",
+  "params": {
+    "entityType": "adGroup",
+    "adAccountId": "${adAccountId}",
+    "data": {
+      "campaign_id": "{campaignId}",
+      "adgroup_name": "US Fitness Enthusiasts 18-34",
+      "placement_type": "PLACEMENT_TYPE_NORMAL",
+      "budget_mode": "BUDGET_MODE_DAY",
+      "budget": 50,
+      "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://snapchat\` — Reporting metrics and dimensions
+- \`entity-schema://snapchat/adGroup\` — Ad Group fields including all targeting parameters
+- \`entity-examples://snapchat/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,wCAAwC,GAAW;IAC9D,IAAI,EAAE,uCAAuC;IAC7C,WAAW,EACT,oLAAoL;IACtL,SAAS,EAAE;QACT;YACE,IAAI,EAAE,aAAa;YACnB,WAAW,EAAE,wBAAwB;YACrC,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,MAAM;YACZ,WAAW,EACT,yHAAyH;YAC3H,QAAQ,EAAE,KAAK;SAChB;KACF;CACF,CAAC;AAEF,MAAM,UAAU,4CAA4C,CAC1D,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8BhC,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 snapchatToolSchemaExplorationPrompt: Prompt;
+export declare function getSnapchatToolSchemaExplorationMessage(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,mCAAmC,EAAE,MAWjD,CAAC;AAEF,wBAAgB,uCAAuC,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CA+E7F"}

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

@@ -0,0 +1,91 @@
+export const snapchatToolSchemaExplorationPrompt = {
+    name: "snapchat_tool_schema_exploration",
+    description: "Guide for discovering and understanding Snapchat MCP tools, resources, and schemas",
+    arguments: [
+        {
+            name: "objective",
+            description: "Exploration objective (e.g., campaign management, reporting, targeting, bulk operations)",
+            required: false,
+        },
+    ],
+};
+export function getSnapchatToolSchemaExplorationMessage(args) {
+    const objective = args?.objective || "general capability discovery";
+    return `# Snapchat MCP Tool & Schema Exploration Guide
+
+## Context
+- Server: snapchat-mcp (Snapchat Ads Campaign Management)
+- Objective: ${objective}
+
+Use this workflow to discover Snapchat MCP capabilities while minimizing token usage.
+
+---
+
+## Available MCP Resources
+
+Fetch these resources for detailed schema information:
+
+| Resource URI | Content |
+|-------------|---------|
+| \`entity-hierarchy://snapchat/all\` | Entity relationships, API patterns, creation order |
+| \`entity-schema://snapchat/campaign\` | Campaign fields |
+| \`entity-schema://snapchat/adGroup\` | Ad Group fields + targeting |
+| \`entity-schema://snapchat/ad\` | Ad fields |
+| \`entity-schema://snapchat/creative\` | Creative fields |
+| \`entity-examples://snapchat/all\` | All entity examples |
+| \`entity-examples://snapchat/{type}\` | Examples for specific type |
+| \`reporting-reference://snapchat\` | Metrics, dimensions, and breakdown options |
+
+## Tool Categories
+
+### Read Operations
+- \`snapchat_list_ad_accounts\` — List accessible advertiser accounts
+- \`snapchat_list_entities\` — List entities with page pagination
+- \`snapchat_get_entity\` — Get single entity by ID
+
+### Write Operations
+- \`snapchat_create_entity\` — Create entity
+- \`snapchat_update_entity\` — Update entity fields
+- \`snapchat_delete_entity\` — Delete entities
+
+### Reporting (Async)
+- \`snapchat_get_report\` — Submit async report and download results
+- \`snapchat_get_report_breakdowns\` — Report with breakdown dimensions
+
+### Bulk Operations
+- \`snapchat_bulk_update_status\` — Batch enable/disable/delete entities
+- \`snapchat_bulk_create_entities\` — Batch creation (up to 50)
+- \`snapchat_bulk_update_entities\` — Batch updates (up to 50)
+- \`snapchat_adjust_bids\` — Batch adjust ad group bid prices
+
+### Targeting
+- \`snapchat_search_targeting\` — Search interest categories, behaviors, demographics
+- \`snapchat_get_targeting_options\` — Browse targeting categories
+
+### Specialized
+- \`snapchat_get_audience_estimate\` — Audience size estimation
+- \`snapchat_get_ad_preview\` — Ad preview for video/image ads
+
+### Validation
+- \`snapchat_validate_entity\` — Client-side entity validation
+
+## Workflow Prompts
+
+| Task | Prompt |
+|------|--------|
+| Create a full campaign structure | \`snapchat_campaign_setup_workflow\` |
+| Research audiences & build targeting | \`snapchat_targeting_discovery_workflow\` |
+| Update entities safely | \`snapchat_entity_update_workflow\` |
+| Bulk create/update/status/bids | \`snapchat_bulk_operations_workflow\` |
+| Async reporting & breakdowns | \`snapchat_reporting_workflow\` |
+| Troubleshoot entity issues | \`snapchat_troubleshoot_entity\` |
+
+## Recommended Exploration Order
+
+1. Start with \`snapchat_list_ad_accounts\` to find your account
+2. Fetch \`entity-hierarchy://snapchat/all\` for API patterns
+3. Fetch \`entity-schema://snapchat/{type}\` for field details
+4. Fetch \`entity-examples://snapchat/{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,mCAAmC,GAAW;IACzD,IAAI,EAAE,kCAAkC;IACxC,WAAW,EAAE,oFAAoF;IACjG,SAAS,EAAE;QACT;YACE,IAAI,EAAE,WAAW;YACjB,WAAW,EACT,0FAA0F;YAC5F,QAAQ,EAAE,KAAK;SAChB;KACF;CACF,CAAC;AAEF,MAAM,UAAU,uCAAuC,CAAC,IAA6B;IACnF,MAAM,SAAS,GAAG,IAAI,EAAE,SAAS,IAAI,8BAA8B,CAAC;IAEpE,OAAO;;;;eAIM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuEvB,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 snapchatTroubleshootEntityPrompt: Prompt;
+export declare function getSnapchatTroubleshootEntityMessage(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,gCAAgC,EAAE,MAoB9C,CAAC;AAEF,wBAAgB,oCAAoC,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAyF1F"}

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

@@ -0,0 +1,111 @@
+export const snapchatTroubleshootEntityPrompt = {
+    name: "snapchat_troubleshoot_entity",
+    description: "Diagnostic workflow for troubleshooting Snapchat 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: "Snapchat Advertiser ID",
+            required: true,
+        },
+    ],
+};
+export function getSnapchatTroubleshootEntityMessage(args) {
+    const entityType = args?.entityType || "{entityType}";
+    const entityId = args?.entityId || "{entityId}";
+    const adAccountId = args?.adAccountId || "{adAccountId}";
+    return `# Snapchat Entity Troubleshoot Workflow
+
+## Target: ${entityType} ${entityId} (Advertiser: ${adAccountId})
+
+## Step 1: Fetch Entity Details
+
+\`\`\`json
+snapchat_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
+snapchat_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
+snapchat_get_entity({
+  "entityType": "campaign",
+  "adAccountId": "${adAccountId}",
+  "entityId": "{parentCampaignId}"
+})
+\`\`\`
+
+## Common Issues
+
+| Symptom | Likely Cause | Fix |
+|---------|-------------|-----|
+| No delivery | Entity DISABLED | Use \`snapchat_bulk_update_status\` with operationStatus: "ENABLE" |
+| No delivery, ENABLE | Parent disabled | Enable parent campaign or ad group |
+| No delivery, all ENABLE | Budget exhausted | Increase budget |
+| No delivery, budget OK | Targeting too narrow | Check audience estimate |
+| Ad under review | Snapchat ad review in progress | Allow 24-48h for review |
+| Ad rejected | Policy violation | Review Snapchat 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
+snapchat_get_audience_estimate({
+  "adAccountId": "${adAccountId}",
+  "targetingConfig": { ... targeting from adGroup ... }
+})
+\`\`\`
+
+## Step 5: Validate Entity Payload
+
+\`\`\`json
+snapchat_validate_entity({
+  "entityType": "${entityType}",
+  "mode": "update",
+  "data": { ... current entity data ... }
+})
+\`\`\`
+
+## Status Update Tool
+
+Snapchat uses a separate status endpoint — do NOT use \`snapchat_update_entity\` for status changes:
+
+\`\`\`json
+snapchat_bulk_update_status({
+  "entityType": "${entityType}",
+  "adAccountId": "${adAccountId}",
+  "entityIds": ["${entityId}"],
+  "operationStatus": "ENABLE"
+})
+\`\`\`
+`;
+}
+//# 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,gCAAgC,GAAW;IACtD,IAAI,EAAE,8BAA8B;IACpC,WAAW,EAAE,oEAAoE;IACjF,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,wBAAwB;YACrC,QAAQ,EAAE,IAAI;SACf;KACF;CACF,CAAC;AAEF,MAAM,UAAU,oCAAoC,CAAC,IAA6B;IAChF,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;AA0CjE,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,CAuEvD,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,89 @@
+import { campaignSetupWorkflowPrompt, getCampaignSetupWorkflowMessage, } from "./definitions/campaign-setup-workflow.prompt.js";
+import { bulkOperationsWorkflowPrompt, getBulkOperationsWorkflowMessage, } from "./definitions/bulk-operations-workflow.prompt.js";
+import { snapchatToolSchemaExplorationPrompt, getSnapchatToolSchemaExplorationMessage, } from "./definitions/tool-schema-exploration.prompt.js";
+import { snapchatTroubleshootEntityPrompt, getSnapchatTroubleshootEntityMessage, } from "./definitions/troubleshoot-entity.prompt.js";
+import { snapchatReportingWorkflowPrompt, getSnapchatReportingWorkflowMessage, } from "./definitions/reporting-workflow.prompt.js";
+import { snapchatEntityUpdateWorkflowPrompt, getSnapchatEntityUpdateWorkflowMessage, } from "./definitions/entity-update-workflow.prompt.js";
+import { snapchatTargetingDiscoveryWorkflowPrompt, getSnapchatTargetingDiscoveryWorkflowMessage, } from "./definitions/targeting-discovery-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 { snapchatCreativeUploadWorkflowPrompt, getSnapchatCreativeUploadWorkflowMessage, } from "./definitions/creative-upload-workflow.prompt.js";
+export const promptRegistry = new Map([
+    [
+        campaignSetupWorkflowPrompt.name,
+        {
+            prompt: campaignSetupWorkflowPrompt,
+            generateMessage: getCampaignSetupWorkflowMessage,
+        },
+    ],
+    [
+        bulkOperationsWorkflowPrompt.name,
+        {
+            prompt: bulkOperationsWorkflowPrompt,
+            generateMessage: getBulkOperationsWorkflowMessage,
+        },
+    ],
+    [
+        snapchatToolSchemaExplorationPrompt.name,
+        {
+            prompt: snapchatToolSchemaExplorationPrompt,
+            generateMessage: getSnapchatToolSchemaExplorationMessage,
+        },
+    ],
+    [
+        snapchatTroubleshootEntityPrompt.name,
+        {
+            prompt: snapchatTroubleshootEntityPrompt,
+            generateMessage: getSnapchatTroubleshootEntityMessage,
+        },
+    ],
+    [
+        snapchatReportingWorkflowPrompt.name,
+        {
+            prompt: snapchatReportingWorkflowPrompt,
+            generateMessage: getSnapchatReportingWorkflowMessage,
+        },
+    ],
+    [
+        snapchatEntityUpdateWorkflowPrompt.name,
+        {
+            prompt: snapchatEntityUpdateWorkflowPrompt,
+            generateMessage: getSnapchatEntityUpdateWorkflowMessage,
+        },
+    ],
+    [
+        snapchatTargetingDiscoveryWorkflowPrompt.name,
+        {
+            prompt: snapchatTargetingDiscoveryWorkflowPrompt,
+            generateMessage: getSnapchatTargetingDiscoveryWorkflowMessage,
+        },
+    ],
+    [
+        crossPlatformPerformancePrompt.name,
+        {
+            prompt: crossPlatformPerformancePrompt,
+            generateMessage: getCrossPlatformPerformanceMessage,
+        },
+    ],
+    [
+        crossPlatformCampaignSetupPrompt.name,
+        {
+            prompt: crossPlatformCampaignSetupPrompt,
+            generateMessage: getCrossPlatformCampaignSetupMessage,
+        },
+    ],
+    [
+        snapchatCreativeUploadWorkflowPrompt.name,
+        {
+            prompt: snapchatCreativeUploadWorkflowPrompt,
+            generateMessage: getSnapchatCreativeUploadWorkflowMessage,
+        },
+    ],
+]);
+export function getAllPrompts() {
+    return Array.from(promptRegistry.values()).map((def) => def.prompt);
+}
+export function getPromptDefinition(name) {
+    return promptRegistry.get(name);
+}
+//# sourceMappingURL=index.js.map