@cesteral/tiktok-mcp 1.0.0

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

@@ -0,0 +1,126 @@
+export const tiktokReportingWorkflowPrompt = {
+    name: "tiktok_reporting_workflow",
+    description: "Guide for submitting and retrieving TikTok Ads async reports with dimensions, metrics, and breakdowns",
+    arguments: [
+        {
+            name: "advertiserId",
+            description: "TikTok Advertiser ID",
+            required: true,
+        },
+        {
+            name: "reportLevel",
+            description: "Report level: AUCTION, RESERVATION (default: AUCTION)",
+            required: false,
+        },
+    ],
+};
+export function getTiktokReportingWorkflowMessage(args) {
+    const advertiserId = args?.advertiserId || "{advertiserId}";
+    const reportLevel = args?.reportLevel || "AUCTION";
+    return `# TikTok Reporting Workflow
+
+Advertiser: \`${advertiserId}\`
+Report Level: \`${reportLevel}\`
+
+---
+
+## Overview
+
+TikTok reports are **async** — \`tiktok_get_report\` submits the job, polls for completion, and returns the results when ready.
+
+---
+
+## Step 1: Basic Campaign Report
+
+\`\`\`json
+tiktok_get_report({
+  "advertiserId": "${advertiserId}",
+  "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
+tiktok_get_report({
+  "advertiserId": "${advertiserId}",
+  "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
+tiktok_get_report_breakdowns({
+  "advertiserId": "${advertiserId}",
+  "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
+tiktok_get_report({
+  "advertiserId": "${advertiserId}",
+  "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://tiktok\` for full metrics and dimensions list
+- Fetch \`entity-hierarchy://tiktok/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,6BAA6B,GAAW;IACnD,IAAI,EAAE,2BAA2B;IACjC,WAAW,EACT,uGAAuG;IACzG,SAAS,EAAE;QACT;YACE,IAAI,EAAE,cAAc;YACpB,WAAW,EAAE,sBAAsB;YACnC,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,aAAa;YACnB,WAAW,EAAE,uDAAuD;YACpE,QAAQ,EAAE,KAAK;SAChB;KACF;CACF,CAAC;AAEF,MAAM,UAAU,iCAAiC,CAAC,IAA6B;IAC7E,MAAM,YAAY,GAAG,IAAI,EAAE,YAAY,IAAI,gBAAgB,CAAC;IAC5D,MAAM,WAAW,GAAG,IAAI,EAAE,WAAW,IAAI,SAAS,CAAC;IAEnD,OAAO;;gBAEO,YAAY;kBACV,WAAW;;;;;;;;;;;;;;qBAcR,YAAY;;;;;;;;;;;;qBAYZ,YAAY;;;;;;;;;;;;;;qBAcZ,YAAY;;;;;;;;;;;;;qBAaZ,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgDhC,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 tiktokTargetingDiscoveryWorkflowPrompt: Prompt;
+export declare function getTiktokTargetingDiscoveryWorkflowMessage(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,sCAAsC,EAAE,MAiBpD,CAAC;AAEF,wBAAgB,0CAA0C,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAuLhG"}

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

@@ -0,0 +1,200 @@
+export const tiktokTargetingDiscoveryWorkflowPrompt = {
+    name: "tiktok_targeting_discovery_workflow",
+    description: "Step-by-step guide for researching TikTok audiences: search geo and ISP targeting tags, browse official targeting metadata, build targeting configs, and estimate audience size before ad group creation.",
+    arguments: [
+        {
+            name: "advertiserId",
+            description: "TikTok 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 getTiktokTargetingDiscoveryWorkflowMessage(args) {
+    const advertiserId = args?.advertiserId || "{advertiserId}";
+    const goal = args?.goal || "search";
+    return `# TikTok Targeting Discovery Workflow
+
+Advertiser: \`${advertiserId}\`
+Goal: \`${goal}\`
+
+---
+
+## Overview
+
+Before creating ad groups, you need to build a **targeting configuration** — the fields that define your TikTok audience. This workflow helps you discover and validate targeting options.
+
+| Tool | Purpose | Use When |
+|------|---------|----------|
+| \`tiktok_search_targeting\` | Search by keyword | You know the audience you want |
+| \`tiktok_get_targeting_options\` | Browse available targeting | You want to explore what's available |
+| \`tiktok_get_audience_estimate\` | Estimate audience size | Before committing to targeting |
+
+---
+
+## Step 1: Search Targeting Options
+
+Search for geo targeting tags by keyword:
+
+\`\`\`json
+{
+  "tool": "tiktok_search_targeting",
+  "params": {
+    "advertiserId": "${advertiserId}",
+    "query": "stockholm",
+    "scene": "GEO",
+    "placements": ["PLACEMENT_TIKTOK"],
+    "objectiveType": "TRAFFIC"
+  }
+}
+\`\`\`
+
+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 |
+|----------------|-----------------|---------|
+| \`GEO\` | Geo tags such as regions, postal codes, cities | "stockholm", "new york" |
+| \`ISP\` | Internet service provider targeting tags | "telia", "verizon" |
+
+---
+
+## Step 2: Browse Targeting Categories
+
+To explore all available targeting options for your account:
+
+\`\`\`json
+{
+  "tool": "tiktok_get_targeting_options",
+  "params": {
+    "advertiserId": "${advertiserId}",
+    "optionType": "LANGUAGE"
+  }
+}
+\`\`\`
+
+Filter by type:
+
+\`\`\`json
+{
+  "tool": "tiktok_get_targeting_options",
+  "params": {
+    "advertiserId": "${advertiserId}",
+    "optionType": "LOCATION",
+    "placements": ["PLACEMENT_TIKTOK"],
+    "objectiveType": "TRAFFIC"
+  }
+}
+\`\`\`
+
+---
+
+## 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"],
+  "placements": ["PLACEMENT_TIKTOK"],
+  "bid_price": 0.5,
+  "optimization_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 |
+| \`placements\` | Array | Placement enums such as PLACEMENT_TIKTOK |
+| \`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 \`tiktok_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": "tiktok_get_audience_estimate",
+  "params": {
+    "advertiserId": "${advertiserId}",
+    "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 TikTok campaigns
+
+---
+
+## Step 5: Apply to Ad Group
+
+Use the targeting when creating or updating an ad group:
+
+\`\`\`json
+{
+  "tool": "tiktok_create_entity",
+  "params": {
+    "entityType": "adGroup",
+    "advertiserId": "${advertiserId}",
+    "data": {
+      "campaign_id": "{campaignId}",
+      "adgroup_name": "US Fitness Enthusiasts 18-34",
+      "placements": ["PLACEMENT_TIKTOK"],
+      "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",
+      "optimization_goal": "CLICK",
+      "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://tiktok\` — Reporting metrics and dimensions
+- \`entity-schema://tiktok/adGroup\` — Ad Group fields including all targeting parameters
+- \`entity-examples://tiktok/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,sCAAsC,GAAW;IAC5D,IAAI,EAAE,qCAAqC;IAC3C,WAAW,EACT,2MAA2M;IAC7M,SAAS,EAAE;QACT;YACE,IAAI,EAAE,cAAc;YACpB,WAAW,EAAE,sBAAsB;YACnC,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,MAAM;YACZ,WAAW,EACT,yHAAyH;YAC3H,QAAQ,EAAE,KAAK;SAChB;KACF;CACF,CAAC;AAEF,MAAM,UAAU,0CAA0C,CAAC,IAA6B;IACtF,MAAM,YAAY,GAAG,IAAI,EAAE,YAAY,IAAI,gBAAgB,CAAC;IAC5D,MAAM,IAAI,GAAG,IAAI,EAAE,IAAI,IAAI,QAAQ,CAAC;IAEpC,OAAO;;gBAEO,YAAY;UAClB,IAAI;;;;;;;;;;;;;;;;;;;;;;;;uBAwBS,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBA8BZ,YAAY;;;;;;;;;;;;uBAYZ,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBAqDZ,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;uBA2BZ,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6BlC,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 tiktokToolSchemaExplorationPrompt: Prompt;
+export declare function getTiktokToolSchemaExplorationMessage(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,iCAAiC,EAAE,MAW/C,CAAC;AAEF,wBAAgB,qCAAqC,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAiF3F"}

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

@@ -0,0 +1,93 @@
+export const tiktokToolSchemaExplorationPrompt = {
+    name: "tiktok_tool_schema_exploration",
+    description: "Guide for discovering and understanding TikTok MCP tools, resources, and schemas",
+    arguments: [
+        {
+            name: "objective",
+            description: "Exploration objective (e.g., campaign management, reporting, targeting, bulk operations)",
+            required: false,
+        },
+    ],
+};
+export function getTiktokToolSchemaExplorationMessage(args) {
+    const objective = args?.objective || "general capability discovery";
+    return `# TikTok MCP Tool & Schema Exploration Guide
+
+## Context
+- Server: tiktok-mcp (TikTok Ads Campaign Management)
+- Objective: ${objective}
+
+Use this workflow to discover TikTok MCP capabilities while minimizing token usage.
+
+---
+
+## Available MCP Resources
+
+Fetch these resources for detailed schema information:
+
+| Resource URI | Content |
+|-------------|---------|
+| \`entity-hierarchy://tiktok/all\` | Entity relationships, API patterns, creation order |
+| \`entity-schema://tiktok/campaign\` | Campaign fields |
+| \`entity-schema://tiktok/adGroup\` | Ad Group fields + targeting |
+| \`entity-schema://tiktok/ad\` | Ad fields |
+| \`entity-schema://tiktok/creative\` | Creative fields |
+| \`entity-examples://tiktok/all\` | All entity examples |
+| \`entity-examples://tiktok/{type}\` | Examples for specific type |
+| \`reporting-reference://tiktok\` | Metrics, dimensions, and breakdown options |
+
+## Tool Categories
+
+### Read Operations
+- \`tiktok_list_advertisers\` — List accessible advertiser accounts
+- \`tiktok_list_entities\` — List entities with page pagination
+- \`tiktok_get_entity\` — Get single entity by ID
+
+### Write Operations
+- \`tiktok_create_entity\` — Create entity
+- \`tiktok_update_entity\` — Update entity fields
+- \`tiktok_delete_entity\` — Delete entities
+
+### Reporting (Async)
+- \`tiktok_get_report\` — Submit async report and download results
+- \`tiktok_get_report_breakdowns\` — Report with breakdown dimensions
+
+### Bulk Operations
+- \`tiktok_bulk_update_status\` — Batch enable/disable/delete entities
+- \`tiktok_bulk_create_entities\` — Batch creation (up to 50)
+- \`tiktok_bulk_update_entities\` — Batch updates (up to 50)
+- \`tiktok_adjust_bids\` — Batch adjust ad group bid prices
+
+### Targeting
+- \`tiktok_search_targeting\` — Search interest categories, behaviors, demographics
+- \`tiktok_get_targeting_options\` — Browse targeting categories
+
+### Specialized
+- \`tiktok_duplicate_entity\` — Copy campaigns, ad groups, ads
+- \`tiktok_get_audience_estimate\` — Audience size estimation
+- \`tiktok_get_ad_preview\` — Ad preview for video/image ads
+
+### Validation
+- \`tiktok_validate_entity\` — Client-side entity validation
+
+## Workflow Prompts
+
+| Task | Prompt |
+|------|--------|
+| Create a full campaign structure | \`tiktok_campaign_setup_workflow\` |
+| Research audiences & build targeting | \`tiktok_targeting_discovery_workflow\` |
+| Update entities safely | \`tiktok_entity_update_workflow\` |
+| Duplicate campaigns/ad groups/ads | \`tiktok_entity_duplication_workflow\` |
+| Bulk create/update/status/bids | \`tiktok_bulk_operations_workflow\` |
+| Async reporting & breakdowns | \`tiktok_reporting_workflow\` |
+| Troubleshoot entity issues | \`tiktok_troubleshoot_entity\` |
+
+## Recommended Exploration Order
+
+1. Start with \`tiktok_list_advertisers\` to find your account
+2. Fetch \`entity-hierarchy://tiktok/all\` for API patterns
+3. Fetch \`entity-schema://tiktok/{type}\` for field details
+4. Fetch \`entity-examples://tiktok/{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,iCAAiC,GAAW;IACvD,IAAI,EAAE,gCAAgC;IACtC,WAAW,EAAE,kFAAkF;IAC/F,SAAS,EAAE;QACT;YACE,IAAI,EAAE,WAAW;YACjB,WAAW,EACT,0FAA0F;YAC5F,QAAQ,EAAE,KAAK;SAChB;KACF;CACF,CAAC;AAEF,MAAM,UAAU,qCAAqC,CAAC,IAA6B;IACjF,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 tiktokTroubleshootEntityPrompt: Prompt;
+export declare function getTiktokTroubleshootEntityMessage(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,8BAA8B,EAAE,MAoB5C,CAAC;AAEF,wBAAgB,kCAAkC,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAyFxF"}

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

@@ -0,0 +1,111 @@
+export const tiktokTroubleshootEntityPrompt = {
+    name: "tiktok_troubleshoot_entity",
+    description: "Diagnostic workflow for troubleshooting TikTok 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: "advertiserId",
+            description: "TikTok Advertiser ID",
+            required: true,
+        },
+    ],
+};
+export function getTiktokTroubleshootEntityMessage(args) {
+    const entityType = args?.entityType || "{entityType}";
+    const entityId = args?.entityId || "{entityId}";
+    const advertiserId = args?.advertiserId || "{advertiserId}";
+    return `# TikTok Entity Troubleshoot Workflow
+
+## Target: ${entityType} ${entityId} (Advertiser: ${advertiserId})
+
+## Step 1: Fetch Entity Details
+
+\`\`\`json
+tiktok_get_entity({
+  "entityType": "${entityType}",
+  "advertiserId": "${advertiserId}",
+  "entityId": "${entityId}"
+})
+\`\`\`
+
+Check: operation_status, primary_status, secondary_status, and any rejection reasons.
+
+## Step 2: Check Recent Performance
+
+\`\`\`json
+tiktok_get_report({
+  "advertiserId": "${advertiserId}",
+  "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
+tiktok_get_entity({
+  "entityType": "campaign",
+  "advertiserId": "${advertiserId}",
+  "entityId": "{parentCampaignId}"
+})
+\`\`\`
+
+## Common Issues
+
+| Symptom | Likely Cause | Fix |
+|---------|-------------|-----|
+| No delivery | Entity DISABLED | Use \`tiktok_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 | TikTok ad review in progress | Allow 24-48h for review |
+| Ad rejected | Policy violation | Review TikTok 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
+tiktok_get_audience_estimate({
+  "advertiserId": "${advertiserId}",
+  "targetingConfig": { ... targeting from adGroup ... }
+})
+\`\`\`
+
+## Step 5: Validate Entity Payload
+
+\`\`\`json
+tiktok_validate_entity({
+  "entityType": "${entityType}",
+  "mode": "update",
+  "data": { ... current entity data ... }
+})
+\`\`\`
+
+## Status Update Tool
+
+TikTok uses a separate status endpoint — do NOT use \`tiktok_update_entity\` for status changes:
+
+\`\`\`json
+tiktok_bulk_update_status({
+  "entityType": "${entityType}",
+  "advertiserId": "${advertiserId}",
+  "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,8BAA8B,GAAW;IACpD,IAAI,EAAE,4BAA4B;IAClC,WAAW,EAAE,kEAAkE;IAC/E,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,cAAc;YACpB,WAAW,EAAE,sBAAsB;YACnC,QAAQ,EAAE,IAAI;SACf;KACF;CACF,CAAC;AAEF,MAAM,UAAU,kCAAkC,CAAC,IAA6B;IAC9E,MAAM,UAAU,GAAG,IAAI,EAAE,UAAU,IAAI,cAAc,CAAC;IACtD,MAAM,QAAQ,GAAG,IAAI,EAAE,QAAQ,IAAI,YAAY,CAAC;IAChD,MAAM,YAAY,GAAG,IAAI,EAAE,YAAY,IAAI,gBAAgB,CAAC;IAE5D,OAAO;;aAEI,UAAU,IAAI,QAAQ,iBAAiB,YAAY;;;;;;mBAM7C,UAAU;qBACR,YAAY;iBAChB,QAAQ;;;;;;;;;;qBAUJ,YAAY;;;;;;;;;;;;;;qBAcZ,YAAY;;;;;;;;;;;;;;;;;;;;;;qBAsBZ,YAAY;;;;;;;;;mBASd,UAAU;;;;;;;;;;;;mBAYV,UAAU;qBACR,YAAY;mBACd,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"}