@cesteral/ttd-mcp 1.0.0

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

@@ -0,0 +1,119 @@
+export const troubleshootEntityPrompt = {
+    name: "ttd_troubleshoot_entity",
+    description: "Diagnostic workflow for troubleshooting common TTD entity creation, update, and delivery errors",
+    arguments: [
+        {
+            name: "entityType",
+            description: "Entity type experiencing issues: advertiser, campaign, adGroup, or ad",
+            required: true,
+        },
+    ],
+};
+export function getTroubleshootEntityMessage(args) {
+    const entityType = args?.entityType || "{entityType}";
+    return `# TTD Entity Troubleshooting: ${entityType}
+
+## Step 1: Fetch the Entity
+
+\`\`\`
+Tool: ttd_get_entity
+Input: { "entityType": "${entityType}", "entityId": "{entityId}" }
+\`\`\`
+
+Check:
+- Does the entity exist? (404 = deleted or wrong ID)
+- What is the \`Availability\` status?
+- Are parent IDs correct?
+
+---
+
+## Step 2: Verify Parent Hierarchy
+
+Entities require valid parents. Verify each level:
+
+| Entity | Check Parent |
+|--------|-------------|
+| Campaign | \`ttd_get_entity { "entityType": "advertiser", "entityId": "{AdvertiserId}" }\` |
+| Ad Group | Verify both advertiser AND campaign exist and are active |
+| Ad | Verify advertiser AND ad group exist and are active |
+
+---
+
+## Step 3: Check Common Errors
+
+### Creation Errors
+
+| Error | Likely Cause | Fix |
+|-------|-------------|-----|
+| \`400 Bad Request\` | Missing required field | Check \`entity-schema://${entityType}\` for required fields |
+| \`400\` on campaign create | \`StartDate\` in the past | Use a future start date |
+| \`400\` on ad group create | Missing \`RTBAttributes\` | Include \`BudgetSettings\` + \`BaseBidCPM\` |
+| \`400\` on ad create | Invalid \`CreativeIds\` | Verify creatives exist first |
+| \`403 Forbidden\` | Insufficient permissions | Verify API credentials have write access |
+| \`404 Not Found\` | Wrong parent ID | Verify \`AdvertiserId\`, \`CampaignId\`, \`AdGroupId\` |
+| \`409 Conflict\` | Duplicate name or constraint | Change entity name or check uniqueness constraints |
+
+### Update Errors
+
+| Error | Likely Cause | Fix |
+|-------|-------------|-----|
+| \`400\` on update | Immutable field in payload | Remove read-only fields (\`CampaignId\`, \`AdvertiserId\`, etc.) |
+| \`400\` on budget update | Budget below spent amount | Set budget >= current spend |
+| \`404\` on update | Entity was deleted | Verify entity still exists |
+| Partial update ignored | TTD uses PUT (full replace) | Include ALL fields you want to keep, not just changed ones |
+
+### Delivery Issues
+
+| Symptom | Diagnostic Steps |
+|---------|-----------------|
+| No impressions | 1. Check \`Availability\` is \`Available\` at ALL levels (campaign, ad group, ad) |
+| | 2. Verify \`StartDate\` has passed and \`EndDate\` hasn't |
+| | 3. Check budget hasn't been exhausted |
+| | 4. Verify ad group has valid targeting |
+| Low delivery | 1. Check bid levels vs. market (\`BaseBidCPM\` too low?) |
+| | 2. Check targeting is not too narrow |
+| | 3. Review frequency caps |
+| Overspend | 1. Check \`PacingMode\` (is it \`Off\`?) |
+| | 2. Verify daily budget cap is set |
+| | 3. Check \`MaxBidCPM\` is set |
+
+---
+
+## Step 4: Fix and Verify
+
+After identifying the issue:
+
+1. **Apply fix** via \`ttd_update_entity\`:
+\`\`\`
+Tool: ttd_update_entity
+Input: { "entityType": "${entityType}", "entityId": "{entityId}", "data": { /* fixed fields */ } }
+\`\`\`
+
+2. **Re-fetch** the entity to confirm changes applied:
+\`\`\`
+Tool: ttd_get_entity
+Input: { "entityType": "${entityType}", "entityId": "{entityId}" }
+\`\`\`
+
+3. **Run a report** to verify delivery status (if applicable):
+\`\`\`
+Tool: ttd_get_report
+Input: { "reportName": "Delivery Check", "dateRange": "Yesterday", "dimensions": ["CampaignId"], "metrics": ["Impressions", "TotalCost"] }
+\`\`\`
+
+---
+
+## Important Notes
+
+- TTD uses **PUT for updates** — the payload replaces the full entity. To change one field, GET the entity first, modify the field, then PUT the full object back.
+- \`Availability: "Archived"\` is effectively a soft delete — entities cannot be un-archived.
+- Changes to bids and budgets take effect within minutes; targeting changes may take longer.
+- Payloads with more than 25 fields consistently show higher latency (>20s). When updating, prefer smaller staged updates — only include fields that actually need to change alongside any required fields.
+
+## Related Resources
+- \`entity-schema://${entityType}\` — Field reference for ${entityType}
+- \`entity-examples://${entityType}\` — CRUD examples
+- \`entity-hierarchy://all\` — Parent-child relationships
+`;
+}
+//# 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":"AAUA,MAAM,CAAC,MAAM,wBAAwB,GAAW;IAC9C,IAAI,EAAE,yBAAyB;IAC/B,WAAW,EACT,iGAAiG;IACnG,SAAS,EAAE;QACT;YACE,IAAI,EAAE,YAAY;YAClB,WAAW,EAAE,uEAAuE;YACpF,QAAQ,EAAE,IAAI;SACf;KACF;CACF,CAAC;AAEF,MAAM,UAAU,4BAA4B,CAAC,IAA6B;IACxE,MAAM,UAAU,GAAG,IAAI,EAAE,UAAU,IAAI,cAAc,CAAC;IAEtD,OAAO,iCAAiC,UAAU;;;;;;0BAM1B,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;2EA4BuC,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAyC3D,UAAU;;;;;;0BAMV,UAAU;;;;;;;;;;;;;;;;;;;sBAmBd,UAAU,4BAA4B,UAAU;wBAC9C,UAAU;;CAEjC,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":"AASA,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 { reportGenerationWorkflowPrompt, getReportGenerationWorkflowMessage, } from "./definitions/report-generation-workflow.prompt.js";
+import { troubleshootEntityPrompt, getTroubleshootEntityMessage, } from "./definitions/troubleshoot-entity.prompt.js";
+import { toolSchemaExplorationPrompt, getToolSchemaExplorationMessage, } from "./definitions/tool-schema-exploration.prompt.js";
+import { crossPlatformPerformancePrompt, getCrossPlatformPerformanceMessage, } from "./definitions/cross-platform-performance.prompt.js";
+import { bulkOperationsWorkflowPrompt, getBulkOperationsWorkflowMessage, } from "./definitions/bulk-operations-workflow.prompt.js";
+import { crossPlatformCampaignSetupPrompt, getCrossPlatformCampaignSetupMessage, } from "./definitions/cross-platform-campaign-setup.prompt.js";
+import { ttdEntityUpdateWorkflowPrompt, getTtdEntityUpdateWorkflowMessage, } from "./definitions/entity-update-workflow.prompt.js";
+import { ttdEntityDuplicationWorkflowPrompt, getTtdEntityDuplicationWorkflowMessage, } from "./definitions/entity-duplication-workflow.prompt.js";
+import { ttdTargetingDiscoveryWorkflowPrompt, getTtdTargetingDiscoveryWorkflowMessage, } from "./definitions/targeting-discovery-workflow.prompt.js";
+import { ttdCreativeSetupWorkflowPrompt, getTtdCreativeSetupWorkflowMessage, } from "./definitions/creative-setup-workflow.prompt.js";
+export const promptRegistry = new Map([
+    [
+        campaignSetupWorkflowPrompt.name,
+        {
+            prompt: campaignSetupWorkflowPrompt,
+            generateMessage: getCampaignSetupWorkflowMessage,
+        },
+    ],
+    [
+        reportGenerationWorkflowPrompt.name,
+        {
+            prompt: reportGenerationWorkflowPrompt,
+            generateMessage: getReportGenerationWorkflowMessage,
+        },
+    ],
+    [
+        troubleshootEntityPrompt.name,
+        {
+            prompt: troubleshootEntityPrompt,
+            generateMessage: getTroubleshootEntityMessage,
+        },
+    ],
+    [
+        toolSchemaExplorationPrompt.name,
+        {
+            prompt: toolSchemaExplorationPrompt,
+            generateMessage: getToolSchemaExplorationMessage,
+        },
+    ],
+    [
+        crossPlatformPerformancePrompt.name,
+        {
+            prompt: crossPlatformPerformancePrompt,
+            generateMessage: getCrossPlatformPerformanceMessage,
+        },
+    ],
+    [
+        bulkOperationsWorkflowPrompt.name,
+        {
+            prompt: bulkOperationsWorkflowPrompt,
+            generateMessage: getBulkOperationsWorkflowMessage,
+        },
+    ],
+    [
+        crossPlatformCampaignSetupPrompt.name,
+        {
+            prompt: crossPlatformCampaignSetupPrompt,
+            generateMessage: getCrossPlatformCampaignSetupMessage,
+        },
+    ],
+    [
+        ttdEntityUpdateWorkflowPrompt.name,
+        {
+            prompt: ttdEntityUpdateWorkflowPrompt,
+            generateMessage: getTtdEntityUpdateWorkflowMessage,
+        },
+    ],
+    [
+        ttdEntityDuplicationWorkflowPrompt.name,
+        {
+            prompt: ttdEntityDuplicationWorkflowPrompt,
+            generateMessage: getTtdEntityDuplicationWorkflowMessage,
+        },
+    ],
+    [
+        ttdTargetingDiscoveryWorkflowPrompt.name,
+        {
+            prompt: ttdTargetingDiscoveryWorkflowPrompt,
+            generateMessage: getTtdTargetingDiscoveryWorkflowMessage,
+        },
+    ],
+    [
+        ttdCreativeSetupWorkflowPrompt.name,
+        {
+            prompt: ttdCreativeSetupWorkflowPrompt,
+            generateMessage: getTtdCreativeSetupWorkflowMessage,
+        },
+    ],
+]);
+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":"AAUA,OAAO,EACL,2BAA2B,EAC3B,+BAA+B,GAChC,MAAM,iDAAiD,CAAC;AACzD,OAAO,EACL,8BAA8B,EAC9B,kCAAkC,GACnC,MAAM,oDAAoD,CAAC;AAC5D,OAAO,EACL,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,6CAA6C,CAAC;AACrD,OAAO,EACL,2BAA2B,EAC3B,+BAA+B,GAChC,MAAM,iDAAiD,CAAC;AACzD,OAAO,EACL,8BAA8B,EAC9B,kCAAkC,GACnC,MAAM,oDAAoD,CAAC;AAC5D,OAAO,EACL,4BAA4B,EAC5B,gCAAgC,GACjC,MAAM,kDAAkD,CAAC;AAC1D,OAAO,EACL,gCAAgC,EAChC,oCAAoC,GACrC,MAAM,uDAAuD,CAAC;AAC/D,OAAO,EACL,6BAA6B,EAC7B,iCAAiC,GAClC,MAAM,gDAAgD,CAAC;AACxD,OAAO,EACL,kCAAkC,EAClC,sCAAsC,GACvC,MAAM,qDAAqD,CAAC;AAC7D,OAAO,EACL,mCAAmC,EACnC,uCAAuC,GACxC,MAAM,sDAAsD,CAAC;AAC9D,OAAO,EACL,8BAA8B,EAC9B,kCAAkC,GACnC,MAAM,iDAAiD,CAAC;AAOzD,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,8BAA8B,CAAC,IAAI;QACnC;YACE,MAAM,EAAE,8BAA8B;YACtC,eAAe,EAAE,kCAAkC;SACpD;KACF;IACD;QACE,wBAAwB,CAAC,IAAI;QAC7B;YACE,MAAM,EAAE,wBAAwB;YAChC,eAAe,EAAE,4BAA4B;SAC9C;KACF;IACD;QACE,2BAA2B,CAAC,IAAI;QAChC;YACE,MAAM,EAAE,2BAA2B;YACnC,eAAe,EAAE,+BAA+B;SACjD;KACF;IACD;QACE,8BAA8B,CAAC,IAAI;QACnC;YACE,MAAM,EAAE,8BAA8B;YACtC,eAAe,EAAE,kCAAkC;SACpD;KACF;IACD;QACE,4BAA4B,CAAC,IAAI;QACjC;YACE,MAAM,EAAE,4BAA4B;YACpC,eAAe,EAAE,gCAAgC;SAClD;KACF;IACD;QACE,gCAAgC,CAAC,IAAI;QACrC;YACE,MAAM,EAAE,gCAAgC;YACxC,eAAe,EAAE,oCAAoC;SACtD;KACF;IACD;QACE,6BAA6B,CAAC,IAAI;QAClC;YACE,MAAM,EAAE,6BAA6B;YACrC,eAAe,EAAE,iCAAiC;SACnD;KACF;IACD;QACE,kCAAkC,CAAC,IAAI;QACvC;YACE,MAAM,EAAE,kCAAkC;YAC1C,eAAe,EAAE,sCAAsC;SACxD;KACF;IACD;QACE,mCAAmC,CAAC,IAAI;QACxC;YACE,MAAM,EAAE,mCAAmC;YAC3C,eAAe,EAAE,uCAAuC;SACzD;KACF;IACD;QACE,8BAA8B,CAAC,IAAI;QACnC;YACE,MAAM,EAAE,8BAA8B;YACtC,eAAe,EAAE,kCAAkC;SACpD;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":"AASA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAkY5C,eAAO,MAAM,sBAAsB,EAAE,QAAQ,EAM1C,CAAC;AAEJ,eAAO,MAAM,wBAAwB,EAAE,QAStC,CAAC"}

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

@@ -0,0 +1,388 @@
+const cachedExamples = new Map();
+function advertiserExamplesMarkdown() {
+    return `# TTD Advertiser Examples
+
+## Create Advertiser
+
+\`\`\`json
+{
+  "entityType": "advertiser",
+  "data": {
+    "AdvertiserName": "Acme Corp",
+    "PartnerId": "your-partner-id",
+    "CurrencyCode": "USD",
+    "Description": "Acme Corporation advertising account",
+    "DomainAddress": "https://www.acme.com",
+    "AttributionClickLookbackWindowInSeconds": 2592000,
+    "AttributionImpressionLookbackWindowInSeconds": 2592000
+  }
+}
+\`\`\`
+
+## Get Advertiser
+
+\`\`\`json
+{
+  "entityType": "advertiser",
+  "entityId": "abc123"
+}
+\`\`\`
+
+## List Advertisers
+
+\`\`\`json
+{
+  "entityType": "advertiser",
+  "filters": {}
+}
+\`\`\`
+> Lists all advertisers under your partner ID (automatically scoped).
+
+## Update Advertiser
+
+\`\`\`json
+{
+  "entityType": "advertiser",
+  "entityId": "abc123",
+  "data": {
+    "AdvertiserName": "Acme Corp (Updated)",
+    "Description": "Updated description"
+  }
+}
+\`\`\`
+> Note: \`CurrencyCode\` cannot be changed after creation.
+`;
+}
+function campaignExamplesMarkdown() {
+    return `# TTD Campaign Examples
+
+## Create Campaign (Basic)
+
+\`\`\`json
+{
+  "entityType": "campaign",
+  "advertiserId": "abc123",
+  "data": {
+    "CampaignName": "Q1 2025 Brand Awareness",
+    "AdvertiserId": "abc123",
+    "Budget": {
+      "Amount": 50000,
+      "CurrencyCode": "USD"
+    },
+    "StartDate": "2025-03-01T00:00:00",
+    "EndDate": "2025-03-31T23:59:59",
+    "PacingMode": "PaceAhead"
+  }
+}
+\`\`\`
+
+## Create Campaign (With Frequency Capping)
+
+\`\`\`json
+{
+  "entityType": "campaign",
+  "advertiserId": "abc123",
+  "data": {
+    "CampaignName": "Q1 Retargeting - Capped",
+    "AdvertiserId": "abc123",
+    "Budget": {
+      "Amount": 25000,
+      "CurrencyCode": "USD"
+    },
+    "StartDate": "2025-03-01T00:00:00",
+    "EndDate": "2025-06-30T23:59:59",
+    "PacingMode": "PaceAhead",
+    "FrequencyConfig": {
+      "MaxImpressions": 5,
+      "TimeUnitCount": 1,
+      "TimeUnit": "Days"
+    }
+  }
+}
+\`\`\`
+
+## List Campaigns for Advertiser
+
+\`\`\`json
+{
+  "entityType": "campaign",
+  "filters": {
+    "AdvertiserIds": ["abc123"]
+  }
+}
+\`\`\`
+
+## Update Campaign (Pause)
+
+\`\`\`json
+{
+  "entityType": "campaign",
+  "entityId": "camp456",
+  "data": {
+    "Availability": "Paused"
+  }
+}
+\`\`\`
+
+## Update Campaign (Adjust Budget)
+
+\`\`\`json
+{
+  "entityType": "campaign",
+  "entityId": "camp456",
+  "data": {
+    "Budget": {
+      "Amount": 75000,
+      "CurrencyCode": "USD"
+    }
+  }
+}
+\`\`\`
+`;
+}
+function adGroupExamplesMarkdown() {
+    return `# TTD Ad Group Examples
+
+## Create Ad Group (Basic)
+
+\`\`\`json
+{
+  "entityType": "adGroup",
+  "advertiserId": "abc123",
+  "data": {
+    "AdGroupName": "Prospecting - Display",
+    "CampaignId": "camp456",
+    "AdvertiserId": "abc123",
+    "RTBAttributes": {
+      "BudgetSettings": {
+        "Budget": {
+          "Amount": 10000,
+          "CurrencyCode": "USD"
+        },
+        "DailyBudget": {
+          "Amount": 500,
+          "CurrencyCode": "USD"
+        },
+        "PacingMode": "PaceAhead"
+      },
+      "BaseBidCPM": {
+        "Amount": 5.00,
+        "CurrencyCode": "USD"
+      },
+      "MaxBidCPM": {
+        "Amount": 12.00,
+        "CurrencyCode": "USD"
+      }
+    }
+  }
+}
+\`\`\`
+
+## Create Ad Group (With Geo Targeting)
+
+\`\`\`json
+{
+  "entityType": "adGroup",
+  "advertiserId": "abc123",
+  "data": {
+    "AdGroupName": "US Only - Video",
+    "CampaignId": "camp456",
+    "AdvertiserId": "abc123",
+    "RTBAttributes": {
+      "BudgetSettings": {
+        "Budget": {
+          "Amount": 5000,
+          "CurrencyCode": "USD"
+        },
+        "PacingMode": "PaceAhead"
+      },
+      "BaseBidCPM": {
+        "Amount": 8.00,
+        "CurrencyCode": "USD"
+      },
+      "GeoTargeting": {
+        "CountryCodeInclusions": ["US"],
+        "RegionInclusions": ["US-CA", "US-NY"]
+      }
+    }
+  }
+}
+\`\`\`
+
+## List Ad Groups for Campaign
+
+\`\`\`json
+{
+  "entityType": "adGroup",
+  "filters": {
+    "CampaignId": "camp456"
+  }
+}
+\`\`\`
+
+## Update Ad Group (Adjust Bids)
+
+\`\`\`json
+{
+  "entityType": "adGroup",
+  "entityId": "ag789",
+  "data": {
+    "RTBAttributes": {
+      "BaseBidCPM": {
+        "Amount": 6.50,
+        "CurrencyCode": "USD"
+      },
+      "MaxBidCPM": {
+        "Amount": 15.00,
+        "CurrencyCode": "USD"
+      }
+    }
+  }
+}
+\`\`\`
+
+## Update Ad Group (Pause)
+
+\`\`\`json
+{
+  "entityType": "adGroup",
+  "entityId": "ag789",
+  "data": {
+    "Availability": "Paused"
+  }
+}
+\`\`\`
+`;
+}
+function creativeExamplesMarkdown() {
+    return `# TTD Creative Examples
+
+## Create Banner Creative
+
+\`\`\`json
+{
+  "entityType": "creative",
+  "advertiserId": "abc123",
+  "data": {
+    "CreativeName": "Banner 300x250 - Summer Sale",
+    "AdvertiserId": "abc123",
+    "CreativeType": "Banner",
+    "Width": 300,
+    "Height": 250,
+    "Tag": "<script src='https://cdn.example.com/ad/summer.js'></script>",
+    "LandingPageUrl": "https://www.acme.com/summer-sale",
+    "IsHTTPS": true
+  }
+}
+\`\`\`
+
+## Create Video Creative (VAST)
+
+\`\`\`json
+{
+  "entityType": "creative",
+  "advertiserId": "abc123",
+  "data": {
+    "CreativeName": "Pre-roll 30s - Brand Intro",
+    "AdvertiserId": "abc123",
+    "CreativeType": "Video",
+    "VideoAttributes": {
+      "VastUrl": "https://vast.example.com/brand-intro.xml",
+      "DurationInSeconds": 30,
+      "IsSkippable": true,
+      "SkipOffsetInSeconds": 5
+    }
+  }
+}
+\`\`\`
+`;
+}
+function conversionTrackerExamplesMarkdown() {
+    return `# TTD Conversion Tracker Examples
+
+## Create Purchase Tracker
+
+\`\`\`json
+{
+  "entityType": "conversionTracker",
+  "advertiserId": "abc123",
+  "data": {
+    "TrackingTagName": "Purchase - Thank You Page",
+    "AdvertiserId": "abc123",
+    "TrackingTagType": "Standard",
+    "TrackingTagCategory": "Purchase",
+    "ConversionType": "Both",
+    "ClickLookbackWindowInSeconds": 2592000,
+    "ViewLookbackWindowInSeconds": 86400,
+    "CountingMethod": "OnePerSession"
+  }
+}
+\`\`\`
+
+## Create Lead Gen Tracker
+
+\`\`\`json
+{
+  "entityType": "conversionTracker",
+  "advertiserId": "abc123",
+  "data": {
+    "TrackingTagName": "Lead Form Submit",
+    "AdvertiserId": "abc123",
+    "TrackingTagType": "Standard",
+    "TrackingTagCategory": "Lead",
+    "ConversionType": "PostClick",
+    "CountingMethod": "OnePerUser"
+  }
+}
+\`\`\`
+`;
+}
+const EXAMPLE_GENERATORS = {
+    advertiser: advertiserExamplesMarkdown,
+    campaign: campaignExamplesMarkdown,
+    adgroup: adGroupExamplesMarkdown,
+    creative: creativeExamplesMarkdown,
+    conversiontracker: conversionTrackerExamplesMarkdown,
+};
+function getExampleContent(entityType) {
+    const key = entityType.toLowerCase();
+    if (!cachedExamples.has(key)) {
+        const generator = EXAMPLE_GENERATORS[key];
+        if (generator) {
+            cachedExamples.set(key, generator());
+        }
+        else {
+            return `# Unknown entity type: ${entityType}\n\nSupported types: ${ENTITY_TYPES.join(", ")}`;
+        }
+    }
+    return cachedExamples.get(key);
+}
+let cachedAllExamples;
+function getAllExamplesMarkdown() {
+    return ENTITY_TYPES.map((t) => getExampleContent(t)).join("\n---\n\n");
+}
+const ENTITY_TYPES = [
+    "advertiser",
+    "campaign",
+    "adGroup",
+    "creative",
+    "conversionTracker",
+];
+export const entityExampleResources = ENTITY_TYPES.map((entityType) => ({
+    uri: `entity-examples://${entityType}`,
+    name: `TTD ${entityType} Examples`,
+    description: `CRUD example payloads for TTD ${entityType} entities including create, list, update, and delete`,
+    mimeType: "text/markdown",
+    getContent: () => getExampleContent(entityType),
+}));
+export const entityExampleAllResource = {
+    uri: "entity-examples://all",
+    name: "TTD All Entity Examples",
+    description: "Combined CRUD example payloads for all TTD entity types",
+    mimeType: "text/markdown",
+    getContent: () => {
+        cachedAllExamples ??= getAllExamplesMarkdown();
+        return cachedAllExamples;
+    },
+};
+//# 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":"AAWA,MAAM,cAAc,GAAG,IAAI,GAAG,EAAkB,CAAC;AAIjD,SAAS,0BAA0B;IACjC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmDR,CAAC;AACF,CAAC;AAED,SAAS,wBAAwB;IAC/B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoFR,CAAC;AACF,CAAC;AAED,SAAS,uBAAuB;IAC9B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+GR,CAAC;AACF,CAAC;AAED,SAAS,wBAAwB;IAC/B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwCR,CAAC;AACF,CAAC;AAED,SAAS,iCAAiC;IACxC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqCR,CAAC;AACF,CAAC;AAID,MAAM,kBAAkB,GAAiC;IACvD,UAAU,EAAE,0BAA0B;IACtC,QAAQ,EAAE,wBAAwB;IAClC,OAAO,EAAE,uBAAuB;IAChC,QAAQ,EAAE,wBAAwB;IAClC,iBAAiB,EAAE,iCAAiC;CACrD,CAAC;AAEF,SAAS,iBAAiB,CAAC,UAAkB;IAC3C,MAAM,GAAG,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;IACrC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7B,MAAM,SAAS,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;QAC1C,IAAI,SAAS,EAAE,CAAC;YACd,cAAc,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC;QACvC,CAAC;aAAM,CAAC;YACN,OAAO,0BAA0B,UAAU,wBAAwB,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/F,CAAC;IACH,CAAC;IACD,OAAO,cAAc,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC;AAClC,CAAC;AAED,IAAI,iBAAqC,CAAC;AAE1C,SAAS,sBAAsB;IAC7B,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,YAAY,GAAG;IACnB,YAAY;IACZ,UAAU;IACV,SAAS;IACT,UAAU;IACV,mBAAmB;CACX,CAAC;AAEX,MAAM,CAAC,MAAM,sBAAsB,GAAe,YAAY,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAClF,GAAG,EAAE,qBAAqB,UAAU,EAAE;IACtC,IAAI,EAAE,OAAO,UAAU,WAAW;IAClC,WAAW,EAAE,iCAAiC,UAAU,sDAAsD;IAC9G,QAAQ,EAAE,eAAe;IACzB,UAAU,EAAE,GAAG,EAAE,CAAC,iBAAiB,CAAC,UAAU,CAAC;CAChD,CAAC,CAAC,CAAC;AAEJ,MAAM,CAAC,MAAM,wBAAwB,GAAa;IAChD,GAAG,EAAE,uBAAuB;IAC5B,IAAI,EAAE,yBAAyB;IAC/B,WAAW,EAAE,yDAAyD;IACtE,QAAQ,EAAE,eAAe;IACzB,UAAU,EAAE,GAAG,EAAE;QACf,iBAAiB,KAAK,sBAAsB,EAAE,CAAC;QAC/C,OAAO,iBAAiB,CAAC;IAC3B,CAAC;CACF,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":"AAQA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAiJ5C,eAAO,MAAM,uBAAuB,EAAE,QAUrC,CAAC"}