@cesteral/cm360-mcp 1.0.0

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

@@ -0,0 +1,69 @@
+export const troubleshootEntityPrompt = {
+    name: "cm360_troubleshoot_entity",
+    description: "Diagnostic workflow for troubleshooting CM360 entity issues",
+    arguments: [
+        {
+            name: "entityType",
+            description: "Entity type to troubleshoot",
+            required: true,
+        },
+        {
+            name: "entityId",
+            description: "Entity ID to troubleshoot",
+            required: true,
+        },
+    ],
+};
+export function getTroubleshootEntityMessage(args) {
+    const entityType = args?.entityType || "{entityType}";
+    const entityId = args?.entityId || "{entityId}";
+    return `# CM360 Troubleshooting: ${entityType} (${entityId})
+
+## Step 1: Fetch Entity
+
+\`\`\`json
+{
+  "tool": "cm360_get_entity",
+  "params": {
+    "profileId": "PROFILE_ID",
+    "entityType": "${entityType}",
+    "entityId": "${entityId}"
+  }
+}
+\`\`\`
+
+## Step 2: Check Parent Chain
+
+Verify parent entities are active:
+- Campaign: active?
+- Placement: active? Site linked?
+- Ad: placement + creative assigned?
+
+## Step 3: Run Delivery Report
+
+\`\`\`json
+{
+  "tool": "cm360_get_report",
+  "params": {
+    "profileId": "PROFILE_ID",
+    "reportType": "STANDARD",
+    "dateRange": { "startDate": "2026-03-01", "endDate": "2026-03-12" },
+    "dimensions": ["${entityType}"],
+    "metrics": ["impressions", "clicks"]
+  }
+}
+\`\`\`
+
+## Common Issues
+
+| Symptom | Likely Cause | Fix |
+|---------|-------------|-----|
+| Ad not serving | Placement inactive | Activate placement |
+| No impressions | Creative-placement size mismatch | Match creative size to placement |
+| Creative rejected | Missing required asset | Check creative type requirements |
+| Placement errors | Site not approved | Verify site status |
+| Floodlight not firing | Activity configuration | Check floodlight tag and activity settings |
+| Update fails | Missing required fields | Fetch full object first (PUT semantics) |
+`;
+}
+//# 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,wBAAwB,GAAW;IAC9C,IAAI,EAAE,2BAA2B;IACjC,WAAW,EAAE,6DAA6D;IAC1E,SAAS,EAAE;QACT;YACE,IAAI,EAAE,YAAY;YAClB,WAAW,EAAE,6BAA6B;YAC1C,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,UAAU;YAChB,WAAW,EAAE,2BAA2B;YACxC,QAAQ,EAAE,IAAI;SACf;KACF;CACF,CAAC;AAEF,MAAM,UAAU,4BAA4B,CAAC,IAA6B;IACxE,MAAM,UAAU,GAAG,IAAI,EAAE,UAAU,IAAI,cAAc,CAAC;IACtD,MAAM,QAAQ,GAAG,IAAI,EAAE,QAAQ,IAAI,YAAY,CAAC;IAChD,OAAO,4BAA4B,UAAU,KAAK,QAAQ;;;;;;;;;qBASvC,UAAU;mBACZ,QAAQ;;;;;;;;;;;;;;;;;;;;;sBAqBL,UAAU;;;;;;;;;;;;;;;;CAgB/B,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 { toolSchemaExplorationPrompt, getToolSchemaExplorationMessage, } from "./definitions/tool-schema-exploration.prompt.js";
+import { campaignSetupWorkflowPrompt, getCampaignSetupWorkflowMessage, } from "./definitions/campaign-setup-workflow.prompt.js";
+import { entityUpdateWorkflowPrompt, getEntityUpdateWorkflowMessage, } from "./definitions/entity-update-workflow.prompt.js";
+import { bulkOperationsWorkflowPrompt, getBulkOperationsWorkflowMessage, } from "./definitions/bulk-operations-workflow.prompt.js";
+import { reportingWorkflowPrompt, getReportingWorkflowMessage, } from "./definitions/reporting-workflow.prompt.js";
+import { troubleshootEntityPrompt, getTroubleshootEntityMessage, } from "./definitions/troubleshoot-entity.prompt.js";
+import { targetingDiscoveryWorkflowPrompt, getTargetingDiscoveryWorkflowMessage, } from "./definitions/targeting-discovery-workflow.prompt.js";
+import { floodlightWorkflowPrompt, getFloodlightWorkflowMessage, } from "./definitions/floodlight-workflow.prompt.js";
+import { crossPlatformCampaignSetupPrompt, getCrossPlatformCampaignSetupMessage, } from "./definitions/cross-platform-campaign-setup.prompt.js";
+import { crossPlatformPerformancePrompt, getCrossPlatformPerformanceMessage, } from "./definitions/cross-platform-performance.prompt.js";
+export const promptRegistry = new Map([
+    [
+        toolSchemaExplorationPrompt.name,
+        {
+            prompt: toolSchemaExplorationPrompt,
+            generateMessage: getToolSchemaExplorationMessage,
+        },
+    ],
+    [
+        campaignSetupWorkflowPrompt.name,
+        {
+            prompt: campaignSetupWorkflowPrompt,
+            generateMessage: getCampaignSetupWorkflowMessage,
+        },
+    ],
+    [
+        entityUpdateWorkflowPrompt.name,
+        {
+            prompt: entityUpdateWorkflowPrompt,
+            generateMessage: getEntityUpdateWorkflowMessage,
+        },
+    ],
+    [
+        bulkOperationsWorkflowPrompt.name,
+        {
+            prompt: bulkOperationsWorkflowPrompt,
+            generateMessage: getBulkOperationsWorkflowMessage,
+        },
+    ],
+    [
+        reportingWorkflowPrompt.name,
+        {
+            prompt: reportingWorkflowPrompt,
+            generateMessage: getReportingWorkflowMessage,
+        },
+    ],
+    [
+        troubleshootEntityPrompt.name,
+        {
+            prompt: troubleshootEntityPrompt,
+            generateMessage: getTroubleshootEntityMessage,
+        },
+    ],
+    [
+        targetingDiscoveryWorkflowPrompt.name,
+        {
+            prompt: targetingDiscoveryWorkflowPrompt,
+            generateMessage: getTargetingDiscoveryWorkflowMessage,
+        },
+    ],
+    [
+        floodlightWorkflowPrompt.name,
+        {
+            prompt: floodlightWorkflowPrompt,
+            generateMessage: getFloodlightWorkflowMessage,
+        },
+    ],
+    [
+        crossPlatformCampaignSetupPrompt.name,
+        {
+            prompt: crossPlatformCampaignSetupPrompt,
+            generateMessage: getCrossPlatformCampaignSetupMessage,
+        },
+    ],
+    [
+        crossPlatformPerformancePrompt.name,
+        {
+            prompt: crossPlatformPerformancePrompt,
+            generateMessage: getCrossPlatformPerformanceMessage,
+        },
+    ],
+]);
+export function getAllPrompts() {
+    return Array.from(promptRegistry.values()).map((def) => def.prompt);
+}
+export function getPromptDefinition(name) {
+    return promptRegistry.get(name);
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mcp-server/prompts/index.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,2BAA2B,EAC3B,+BAA+B,GAChC,MAAM,iDAAiD,CAAC;AACzD,OAAO,EACL,2BAA2B,EAC3B,+BAA+B,GAChC,MAAM,iDAAiD,CAAC;AACzD,OAAO,EACL,0BAA0B,EAC1B,8BAA8B,GAC/B,MAAM,gDAAgD,CAAC;AACxD,OAAO,EACL,4BAA4B,EAC5B,gCAAgC,GACjC,MAAM,kDAAkD,CAAC;AAC1D,OAAO,EACL,uBAAuB,EACvB,2BAA2B,GAC5B,MAAM,4CAA4C,CAAC;AACpD,OAAO,EACL,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,6CAA6C,CAAC;AACrD,OAAO,EACL,gCAAgC,EAChC,oCAAoC,GACrC,MAAM,sDAAsD,CAAC;AAC9D,OAAO,EACL,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,6CAA6C,CAAC;AACrD,OAAO,EACL,gCAAgC,EAChC,oCAAoC,GACrC,MAAM,uDAAuD,CAAC;AAC/D,OAAO,EACL,8BAA8B,EAC9B,kCAAkC,GACnC,MAAM,oDAAoD,CAAC;AAO5D,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,2BAA2B,CAAC,IAAI;QAChC;YACE,MAAM,EAAE,2BAA2B;YACnC,eAAe,EAAE,+BAA+B;SACjD;KACF;IACD;QACE,0BAA0B,CAAC,IAAI;QAC/B;YACE,MAAM,EAAE,0BAA0B;YAClC,eAAe,EAAE,8BAA8B;SAChD;KACF;IACD;QACE,4BAA4B,CAAC,IAAI;QACjC;YACE,MAAM,EAAE,4BAA4B;YACpC,eAAe,EAAE,gCAAgC;SAClD;KACF;IACD;QACE,uBAAuB,CAAC,IAAI;QAC5B;YACE,MAAM,EAAE,uBAAuB;YAC/B,eAAe,EAAE,2BAA2B;SAC7C;KACF;IACD;QACE,wBAAwB,CAAC,IAAI;QAC7B;YACE,MAAM,EAAE,wBAAwB;YAChC,eAAe,EAAE,4BAA4B;SAC9C;KACF;IACD;QACE,gCAAgC,CAAC,IAAI;QACrC;YACE,MAAM,EAAE,gCAAgC;YACxC,eAAe,EAAE,oCAAoC;SACtD;KACF;IACD;QACE,wBAAwB,CAAC,IAAI;QAC7B;YACE,MAAM,EAAE,wBAAwB;YAChC,eAAe,EAAE,4BAA4B;SAC9C;KACF;IACD;QACE,gCAAgC,CAAC,IAAI;QACrC;YACE,MAAM,EAAE,gCAAgC;YACxC,eAAe,EAAE,oCAAoC;SACtD;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":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAqI5C,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,140 @@
+import { getSupportedEntityTypes } from "../../tools/utils/entity-mapping.js";
+const ENTITY_EXAMPLES = {
+    campaign: `# Campaign Examples
+
+## Create a display campaign
+\`\`\`json
+{
+  "name": "Summer Sale 2026",
+  "advertiserId": "ADVERTISER_ID",
+  "startDate": "2026-04-01",
+  "endDate": "2026-06-30"
+}
+\`\`\``,
+    placement: `# Placement Examples
+
+## Create a standard display placement
+\`\`\`json
+{
+  "name": "Homepage Banner 300x250",
+  "campaignId": "CAMPAIGN_ID",
+  "siteId": "SITE_ID",
+  "compatibility": "DISPLAY",
+  "size": { "width": 300, "height": 250 },
+  "paymentSource": "PLACEMENT_AGENCY_PAID",
+  "tagFormats": ["PLACEMENT_TAG_STANDARD"]
+}
+\`\`\`
+
+## Create a video placement
+\`\`\`json
+{
+  "name": "Pre-roll Video",
+  "campaignId": "CAMPAIGN_ID",
+  "siteId": "SITE_ID",
+  "compatibility": "IN_STREAM_VIDEO",
+  "size": { "width": 0, "height": 0 }
+}
+\`\`\``,
+    ad: `# Ad Examples
+
+## Create a standard ad linking creative to placement
+\`\`\`json
+{
+  "name": "Summer Sale - Banner Ad",
+  "campaignId": "CAMPAIGN_ID",
+  "type": "AD_SERVING_STANDARD_AD",
+  "placementAssignments": [{ "placementId": "PLACEMENT_ID", "active": true }],
+  "creativeAssignments": [{ "creativeId": "CREATIVE_ID", "active": true }],
+  "active": true
+}
+\`\`\``,
+    creative: `# Creative Examples
+
+## Create a display creative
+\`\`\`json
+{
+  "name": "Summer Sale Banner",
+  "advertiserId": "ADVERTISER_ID",
+  "type": "DISPLAY",
+  "size": { "width": 300, "height": 250 },
+  "active": true
+}
+\`\`\``,
+    site: `# Site Examples
+
+## Create a site
+\`\`\`json
+{
+  "name": "example.com",
+  "approved": true
+}
+\`\`\``,
+    advertiser: `# Advertiser Examples
+
+## Get advertiser details
+Advertisers are typically pre-existing. Use \`cm360_get_entity\` to retrieve:
+\`\`\`json
+{
+  "tool": "cm360_get_entity",
+  "params": {
+    "profileId": "PROFILE_ID",
+    "entityType": "advertiser",
+    "entityId": "ADVERTISER_ID"
+  }
+}
+\`\`\``,
+    floodlightActivity: `# Floodlight Activity Examples
+
+## Create a purchase tracking activity
+\`\`\`json
+{
+  "name": "Purchase Confirmation",
+  "floodlightConfigurationId": "FLOODLIGHT_CONFIG_ID",
+  "floodlightActivityGroupName": "conversions",
+  "floodlightTagType": "GLOBAL_SITE_TAG",
+  "countingMethod": "STANDARD_COUNTING",
+  "expectedUrl": "https://example.com/thank-you"
+}
+\`\`\`
+
+## Create a lead form activity
+\`\`\`json
+{
+  "name": "Lead Form Submission",
+  "floodlightConfigurationId": "FLOODLIGHT_CONFIG_ID",
+  "floodlightActivityGroupName": "leads",
+  "floodlightTagType": "GLOBAL_SITE_TAG",
+  "countingMethod": "UNIQUE_COUNTING"
+}
+\`\`\``,
+    floodlightConfiguration: `# Floodlight Configuration Examples
+
+## Update lookback windows
+\`\`\`json
+{
+  "lookbackConfiguration": {
+    "clickDuration": 30,
+    "postImpressionActivitiesDuration": 7
+  }
+}
+\`\`\`
+Note: Floodlight configurations cannot be created — one exists per advertiser.`,
+};
+export const entityExampleResources = getSupportedEntityTypes().map((entityType) => ({
+    uri: `entity-examples://${entityType}`,
+    name: `${entityType} Examples`,
+    description: `Example payloads for CM360 ${entityType} operations`,
+    mimeType: "text/markdown",
+    getContent: () => ENTITY_EXAMPLES[entityType] || `# ${entityType}\n\nNo examples yet.`,
+}));
+export const entityExampleAllResource = {
+    uri: "entity-examples://all",
+    name: "All CM360 Entity Examples",
+    description: "Combined examples for all CM360 entity types",
+    mimeType: "text/markdown",
+    getContent: () => getSupportedEntityTypes()
+        .map((t) => ENTITY_EXAMPLES[t])
+        .join("\n\n---\n\n"),
+};
+//# 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":"AAIA,OAAO,EAAE,uBAAuB,EAAwB,MAAM,qCAAqC,CAAC;AAEpG,MAAM,eAAe,GAAoC;IACvD,QAAQ,EAAE;;;;;;;;;;OAUL;IAEL,SAAS,EAAE;;;;;;;;;;;;;;;;;;;;;;;;OAwBN;IAEL,EAAE,EAAE;;;;;;;;;;;;OAYC;IAEL,QAAQ,EAAE;;;;;;;;;;;OAWL;IAEL,IAAI,EAAE;;;;;;;;OAQD;IAEL,UAAU,EAAE;;;;;;;;;;;;;OAaP;IAEL,kBAAkB,EAAE;;;;;;;;;;;;;;;;;;;;;;;OAuBf;IAEL,uBAAuB,EAAE;;;;;;;;;;;+EAWoD;CAC9E,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAe,uBAAuB,EAAE,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC/F,GAAG,EAAE,qBAAqB,UAAU,EAAE;IACtC,IAAI,EAAE,GAAG,UAAU,WAAW;IAC9B,WAAW,EAAE,8BAA8B,UAAU,aAAa;IAClE,QAAQ,EAAE,eAAe;IACzB,UAAU,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,UAAU,CAAC,IAAI,KAAK,UAAU,sBAAsB;CACvF,CAAC,CAAC,CAAC;AAEJ,MAAM,CAAC,MAAM,wBAAwB,GAAa;IAChD,GAAG,EAAE,uBAAuB;IAC5B,IAAI,EAAE,2BAA2B;IACjC,WAAW,EAAE,8CAA8C;IAC3D,QAAQ,EAAE,eAAe;IACzB,UAAU,EAAE,GAAG,EAAE,CACf,uBAAuB,EAAE;SACtB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;SAC9B,IAAI,CAAC,aAAa,CAAC;CACzB,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":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAiG5C,eAAO,MAAM,uBAAuB,EAAE,QAUrC,CAAC"}

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

@@ -0,0 +1,104 @@
+let cachedContent;
+function formatEntityHierarchyMarkdown() {
+    return `# CM360 Entity Hierarchy
+
+## Relationship Diagram
+
+\`\`\`
+Account (Network)
+  └── Advertiser
+        ├── Campaign
+        │     └── Placement (requires Site)
+        │           └── Ad (references Creative)
+        ├── Creative (reusable across ads)
+        ├── Site (hosting placements)
+        ├── Floodlight Configuration (one per advertiser)
+        │     └── Floodlight Activity (conversion events)
+        └── Floodlight Activity (conversion events)
+\`\`\`
+
+## Entity Types (8 total)
+
+| Entity Type | API Collection | ID Field | Supports Delete |
+|-------------|---------------|----------|:---:|
+| **campaign** | \`campaigns\` | id | |
+| **placement** | \`placements\` | id | |
+| **ad** | \`ads\` | id | |
+| **creative** | \`creatives\` | id | ✓ |
+| **site** | \`sites\` | id | |
+| **advertiser** | \`advertisers\` | id | |
+| **floodlightActivity** | \`floodlightActivities\` | id | ✓ |
+| **floodlightConfiguration** | \`floodlightConfigurations\` | id | |
+
+## Key Relationships
+
+### Core Hierarchy: Account → Advertiser → Campaign → Placement → Ad
+- Placements require both a **campaign** and a **site**
+- Ads require **placement assignments** and **creative assignments**
+- Creatives are shared across ads within an advertiser
+
+### Conversion Tracking: Floodlight
+- One **Floodlight Configuration** per advertiser (account-level)
+- Multiple **Floodlight Activities** per configuration (individual events)
+
+## Creation Order
+
+Full campaign structure (top-down):
+
+1. **Account** — pre-exists, use \`cm360_list_user_profiles\` to discover
+2. **Advertiser** — usually pre-exists, verify with \`cm360_get_entity\`
+3. **Site** — create or reuse for placement hosting
+4. **Campaign** — requires advertiser, start/end dates
+5. **Placement** — requires campaign + site, size, compatibility
+6. **Creative** — requires advertiser, type, size (must match placement)
+7. **Ad** — links creative to placement via assignments
+
+## CM360 API Patterns (v5)
+
+### Create: POST /dfareporting/v5/userprofiles/{profileId}/{collection}
+All entities require a profileId.
+
+### Read: GET /dfareporting/v5/userprofiles/{profileId}/{collection}/{id}
+
+### Update: PUT /dfareporting/v5/userprofiles/{profileId}/{collection}
+**Warning: PUT semantics**: Full entity object required. Missing fields reset to defaults.
+
+### Delete: DELETE (creative, floodlightActivity only)
+Most entities cannot be deleted — archive or deactivate instead.
+
+### List: GET /dfareporting/v5/userprofiles/{profileId}/{collection}
+Uses pageToken-based pagination.
+
+## Available Tools Summary
+
+| Tool | Purpose | Batch? |
+|------|---------|--------|
+| \`cm360_list_user_profiles\` | Discover profile IDs | |
+| \`cm360_list_entities\` | List entities with filters | |
+| \`cm360_get_entity\` | Get single entity | |
+| \`cm360_create_entity\` | Create single entity | |
+| \`cm360_update_entity\` | Update entity (PUT) | |
+| \`cm360_delete_entity\` | Delete entity (creative/floodlight only) | |
+| \`cm360_validate_entity\` | Client-side validation | |
+| \`cm360_get_report\` | Submit + wait for report | |
+| \`cm360_submit_report\` | Submit report (async) | |
+| \`cm360_check_report_status\` | Check report status | |
+| \`cm360_download_report\` | Download report CSV | |
+| \`cm360_bulk_update_status\` | Batch status update | ✓ |
+| \`cm360_bulk_create_entities\` | Batch entity creation | ✓ |
+| \`cm360_bulk_update_entities\` | Batch entity updates | ✓ |
+| \`cm360_get_ad_preview\` | Ad preview URL | |
+| \`cm360_list_targeting_options\` | Browse targeting options | |
+`;
+}
+export const entityHierarchyResource = {
+    uri: "entity-hierarchy://all",
+    name: "CM360 Entity Hierarchy",
+    description: "Parent-child relationships between CM360 entities, API patterns, and creation ordering",
+    mimeType: "text/markdown",
+    getContent: () => {
+        cachedContent ??= formatEntityHierarchyMarkdown();
+        return cachedContent;
+    },
+};
+//# sourceMappingURL=entity-hierarchy.resource.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"entity-hierarchy.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/entity-hierarchy.resource.ts"],"names":[],"mappings":"AAKA,IAAI,aAAiC,CAAC;AAEtC,SAAS,6BAA6B;IACpC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyFR,CAAC;AACF,CAAC;AAED,MAAM,CAAC,MAAM,uBAAuB,GAAa;IAC/C,GAAG,EAAE,wBAAwB;IAC7B,IAAI,EAAE,wBAAwB;IAC9B,WAAW,EACT,wFAAwF;IAC1F,QAAQ,EAAE,eAAe;IACzB,UAAU,EAAE,GAAG,EAAE;QACf,aAAa,KAAK,6BAA6B,EAAE,CAAC;QAClD,OAAO,aAAa,CAAC;IACvB,CAAC;CACF,CAAC"}

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

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

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

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

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

@@ -0,0 +1,111 @@
+import { getSupportedEntityTypes } from "../../tools/utils/entity-mapping.js";
+const ENTITY_SCHEMAS = {
+    campaign: `# Campaign Schema
+
+## Required Fields
+- \`name\` (string) — Campaign name
+- \`advertiserId\` (string) — Parent advertiser ID
+- \`startDate\` (string) — Start date (YYYY-MM-DD)
+- \`endDate\` (string) — End date (YYYY-MM-DD)
+
+## Optional Fields
+- \`archived\` (boolean) — Archive status
+- \`defaultLandingPageId\` (string) — Default landing page
+- \`externalId\` (string) — External identifier`,
+    placement: `# Placement Schema
+
+## Required Fields
+- \`name\` (string) — Placement name
+- \`campaignId\` (string) — Parent campaign ID
+- \`siteId\` (string) — Site hosting the placement
+- \`compatibility\` (string) — DISPLAY, IN_STREAM_VIDEO, etc.
+- \`size\` (object) — { width: number, height: number }
+
+## Optional Fields
+- \`paymentSource\` (string) — PLACEMENT_AGENCY_PAID, PLACEMENT_PUBLISHER_PAID
+- \`tagFormats\` (array) — PLACEMENT_TAG_STANDARD, etc.
+- \`pricingSchedule\` (object) — Pricing configuration`,
+    ad: `# Ad Schema
+
+## Required Fields
+- \`name\` (string) — Ad name
+- \`campaignId\` (string) — Parent campaign ID
+- \`type\` (string) — AD_SERVING_STANDARD_AD, AD_SERVING_DEFAULT_AD, etc.
+
+## Key Fields
+- \`placementAssignments\` (array) — [{ placementId, active }]
+- \`creativeAssignments\` (array) — [{ creativeId, active }]
+- \`active\` (boolean) — Whether ad is active
+- \`startTime\` (string) — Start datetime
+- \`endTime\` (string) — End datetime`,
+    creative: `# Creative Schema
+
+## Required Fields
+- \`name\` (string) — Creative name
+- \`advertiserId\` (string) — Parent advertiser ID
+- \`type\` (string) — DISPLAY, DISPLAY_IMAGE_GALLERY, HTML5_BANNER, etc.
+- \`size\` (object) — { width: number, height: number }
+
+## Optional Fields
+- \`active\` (boolean) — Active status
+- \`clickTags\` (array) — Click tracking tags
+- \`backupImageClickThroughUrl\` (object) — Fallback URL`,
+    site: `# Site Schema
+
+## Required Fields
+- \`name\` (string) — Site name
+- \`approved\` (boolean) — Approval status
+
+## Optional Fields
+- \`directorySiteId\` (string) — Directory site reference
+- \`siteSettings\` (object) — Site-level settings`,
+    advertiser: `# Advertiser Schema
+
+## Required Fields
+- \`name\` (string) — Advertiser name
+
+## Key Fields
+- \`status\` (string) — APPROVED, ON_HOLD
+- \`defaultClickThroughEventTagId\` (string)
+- \`floodlightConfigurationId\` (string) — Linked Floodlight config`,
+    floodlightActivity: `# Floodlight Activity Schema
+
+## Required Fields
+- \`name\` (string) — Activity name
+- \`floodlightConfigurationId\` (string) — Parent config ID
+- \`floodlightActivityGroupName\` (string) — Activity group name
+- \`floodlightTagType\` (string) — GLOBAL_SITE_TAG, IFRAME, IMAGE
+
+## Optional Fields
+- \`countingMethod\` (string) — STANDARD_COUNTING, UNIQUE_COUNTING, etc.
+- \`expectedUrl\` (string) — Expected conversion page URL
+- \`cacheBustingType\` (string) — Tag cache busting setting`,
+    floodlightConfiguration: `# Floodlight Configuration Schema
+
+## Key Fields (read-only, one per advertiser)
+- \`advertiserId\` (string) — Linked advertiser
+- \`lookbackConfiguration\` (object) — Attribution windows
+- \`naturalSearchConversionAttributionOption\` (string) — Natural search settings
+- \`firstDayOfWeek\` (string) — MONDAY or SUNDAY
+
+## Notes
+- Cannot be created; one auto-exists per advertiser
+- Can be updated to modify lookback windows`,
+};
+export const entitySchemaResources = getSupportedEntityTypes().map((entityType) => ({
+    uri: `entity-schema://${entityType}`,
+    name: `${entityType} Schema`,
+    description: `Field schema for CM360 ${entityType} entities`,
+    mimeType: "text/markdown",
+    getContent: () => ENTITY_SCHEMAS[entityType] || `# ${entityType}\n\nSchema not yet documented.`,
+}));
+export const entitySchemaAllResource = {
+    uri: "entity-schema://all",
+    name: "All CM360 Entity Schemas",
+    description: "Combined schema reference for all CM360 entity types",
+    mimeType: "text/markdown",
+    getContent: () => getSupportedEntityTypes()
+        .map((t) => ENTITY_SCHEMAS[t])
+        .join("\n\n---\n\n"),
+};
+//# sourceMappingURL=entity-schemas.resource.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"entity-schemas.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/entity-schemas.resource.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,uBAAuB,EAAwB,MAAM,qCAAqC,CAAC;AAEpG,MAAM,cAAc,GAAoC;IACtD,QAAQ,EAAE;;;;;;;;;;;gDAWoC;IAE9C,SAAS,EAAE;;;;;;;;;;;;uDAY0C;IAErD,EAAE,EAAE;;;;;;;;;;;;sCAYgC;IAEpC,QAAQ,EAAE;;;;;;;;;;;yDAW6C;IAEvD,IAAI,EAAE;;;;;;;;kDAQ0C;IAEhD,UAAU,EAAE;;;;;;;;oEAQsD;IAElE,kBAAkB,EAAE;;;;;;;;;;;4DAWsC;IAE1D,uBAAuB,EAAE;;;;;;;;;;4CAUiB;CAC3C,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAe,uBAAuB,EAAE,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC9F,GAAG,EAAE,mBAAmB,UAAU,EAAE;IACpC,IAAI,EAAE,GAAG,UAAU,SAAS;IAC5B,WAAW,EAAE,0BAA0B,UAAU,WAAW;IAC5D,QAAQ,EAAE,eAAe;IACzB,UAAU,EAAE,GAAG,EAAE,CAAC,cAAc,CAAC,UAAU,CAAC,IAAI,KAAK,UAAU,gCAAgC;CAChG,CAAC,CAAC,CAAC;AAEJ,MAAM,CAAC,MAAM,uBAAuB,GAAa;IAC/C,GAAG,EAAE,qBAAqB;IAC1B,IAAI,EAAE,0BAA0B;IAChC,WAAW,EAAE,sDAAsD;IACnE,QAAQ,EAAE,eAAe;IACzB,UAAU,EAAE,GAAG,EAAE,CACf,uBAAuB,EAAE;SACtB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;SAC7B,IAAI,CAAC,aAAa,CAAC;CACzB,CAAC"}

package/dist/mcp-server/resources/definitions/index.d.ts

@@ -0,0 +1,8 @@
+export { entityHierarchyResource } from "./entity-hierarchy.resource.js";
+export { entitySchemaResources, entitySchemaAllResource } from "./entity-schemas.resource.js";
+export { entityExampleResources, entityExampleAllResource } from "./entity-examples.resource.js";
+export { reportingReferenceResource } from "./reporting-reference.resource.js";
+export { targetingReferenceResource } from "./targeting-reference.resource.js";
+import type { Resource } from "../types.js";
+export declare const allResources: Resource[];
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp-server/resources/definitions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAC9F,OAAO,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACjG,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAC/E,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAS/E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AA+B5C,eAAO,MAAM,YAAY,EAAE,QAAQ,EAUlC,CAAC"}

package/dist/mcp-server/resources/definitions/index.js

@@ -0,0 +1,49 @@
+export { entityHierarchyResource } from "./entity-hierarchy.resource.js";
+export { entitySchemaResources, entitySchemaAllResource } from "./entity-schemas.resource.js";
+export { entityExampleResources, entityExampleAllResource } from "./entity-examples.resource.js";
+export { reportingReferenceResource } from "./reporting-reference.resource.js";
+export { targetingReferenceResource } from "./targeting-reference.resource.js";
+import { entityHierarchyResource } from "./entity-hierarchy.resource.js";
+import { entitySchemaResources, entitySchemaAllResource } from "./entity-schemas.resource.js";
+import { entityExampleResources, entityExampleAllResource } from "./entity-examples.resource.js";
+import { reportingReferenceResource } from "./reporting-reference.resource.js";
+import { targetingReferenceResource } from "./targeting-reference.resource.js";
+import { allTools } from "../../tools/definitions/index.js";
+import { createToolExamplesResource, createServerCapabilitiesResource } from "@cesteral/shared";
+const toolExamplesResource = createToolExamplesResource(allTools, "cm360-mcp");
+const serverCapabilitiesResource = createServerCapabilitiesResource({
+    serverName: "cm360-mcp",
+    toolGroups: {
+        crud: [
+            "cm360_list_entities",
+            "cm360_get_entity",
+            "cm360_create_entity",
+            "cm360_update_entity",
+            "cm360_delete_entity",
+        ],
+        account: ["cm360_list_user_profiles"],
+        reporting: [
+            "cm360_get_report",
+            "cm360_submit_report",
+            "cm360_check_report_status",
+            "cm360_download_report",
+        ],
+        bulk: ["cm360_bulk_update_status", "cm360_bulk_create_entities", "cm360_bulk_update_entities"],
+        specialized: ["cm360_get_ad_preview", "cm360_list_targeting_options"],
+        validation: ["cm360_validate_entity"],
+    },
+    commonWorkflows: ["campaign_setup", "reporting", "floodlight_tracking"],
+    startHere: "cm360_list_user_profiles",
+});
+export const allResources = [
+    entityHierarchyResource,
+    entitySchemaAllResource,
+    ...entitySchemaResources,
+    entityExampleAllResource,
+    ...entityExampleResources,
+    reportingReferenceResource,
+    targetingReferenceResource,
+    ...(toolExamplesResource ? [toolExamplesResource] : []),
+    serverCapabilitiesResource,
+];
+//# sourceMappingURL=index.js.map

package/dist/mcp-server/resources/definitions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAC9F,OAAO,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACjG,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAC/E,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAE/E,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAC9F,OAAO,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACjG,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAC/E,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAC/E,OAAO,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAC5D,OAAO,EAAE,0BAA0B,EAAE,gCAAgC,EAAE,MAAM,kBAAkB,CAAC;AAGhG,MAAM,oBAAoB,GAAG,0BAA0B,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;AAC/E,MAAM,0BAA0B,GAAG,gCAAgC,CAAC;IAClE,UAAU,EAAE,WAAW;IACvB,UAAU,EAAE;QACV,IAAI,EAAE;YACJ,qBAAqB;YACrB,kBAAkB;YAClB,qBAAqB;YACrB,qBAAqB;YACrB,qBAAqB;SACtB;QACD,OAAO,EAAE,CAAC,0BAA0B,CAAC;QACrC,SAAS,EAAE;YACT,kBAAkB;YAClB,qBAAqB;YACrB,2BAA2B;YAC3B,uBAAuB;SACxB;QACD,IAAI,EAAE,CAAC,0BAA0B,EAAE,4BAA4B,EAAE,4BAA4B,CAAC;QAC9F,WAAW,EAAE,CAAC,sBAAsB,EAAE,8BAA8B,CAAC;QACrE,UAAU,EAAE,CAAC,uBAAuB,CAAC;KACtC;IACD,eAAe,EAAE,CAAC,gBAAgB,EAAE,WAAW,EAAE,qBAAqB,CAAC;IACvE,SAAS,EAAE,0BAA0B;CACtC,CAAC,CAAC;AAKH,MAAM,CAAC,MAAM,YAAY,GAAe;IACtC,uBAAuB;IACvB,uBAAuB;IACvB,GAAG,qBAAqB;IACxB,wBAAwB;IACxB,GAAG,sBAAsB;IACzB,0BAA0B;IAC1B,0BAA0B;IAC1B,GAAG,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,oBAA2C,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9E,0BAAiD;CAClD,CAAC"}

package/dist/mcp-server/resources/definitions/reporting-reference.resource.d.ts

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

package/dist/mcp-server/resources/definitions/reporting-reference.resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporting-reference.resource.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/reporting-reference.resource.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,eAAO,MAAM,0BAA0B,EAAE,QA4DxC,CAAC"}