@cesteral/snapchat-mcp 1.0.0

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,4BAA4B,EAC5B,gCAAgC,GACjC,MAAM,kDAAkD,CAAC;AAC1D,OAAO,EACL,mCAAmC,EACnC,uCAAuC,GACxC,MAAM,iDAAiD,CAAC;AACzD,OAAO,EACL,gCAAgC,EAChC,oCAAoC,GACrC,MAAM,6CAA6C,CAAC;AACrD,OAAO,EACL,+BAA+B,EAC/B,mCAAmC,GACpC,MAAM,4CAA4C,CAAC;AACpD,OAAO,EACL,kCAAkC,EAClC,sCAAsC,GACvC,MAAM,gDAAgD,CAAC;AACxD,OAAO,EACL,wCAAwC,EACxC,4CAA4C,GAC7C,MAAM,sDAAsD,CAAC;AAC9D,OAAO,EACL,8BAA8B,EAC9B,kCAAkC,GACnC,MAAM,oDAAoD,CAAC;AAC5D,OAAO,EACL,gCAAgC,EAChC,oCAAoC,GACrC,MAAM,uDAAuD,CAAC;AAC/D,OAAO,EACL,oCAAoC,EACpC,wCAAwC,GACzC,MAAM,kDAAkD,CAAC;AAO1D,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,4BAA4B,CAAC,IAAI;QACjC;YACE,MAAM,EAAE,4BAA4B;YACpC,eAAe,EAAE,gCAAgC;SAClD;KACF;IACD;QACE,mCAAmC,CAAC,IAAI;QACxC;YACE,MAAM,EAAE,mCAAmC;YAC3C,eAAe,EAAE,uCAAuC;SACzD;KACF;IACD;QACE,gCAAgC,CAAC,IAAI;QACrC;YACE,MAAM,EAAE,gCAAgC;YACxC,eAAe,EAAE,oCAAoC;SACtD;KACF;IACD;QACE,+BAA+B,CAAC,IAAI;QACpC;YACE,MAAM,EAAE,+BAA+B;YACvC,eAAe,EAAE,mCAAmC;SACrD;KACF;IACD;QACE,kCAAkC,CAAC,IAAI;QACvC;YACE,MAAM,EAAE,kCAAkC;YAC1C,eAAe,EAAE,sCAAsC;SACxD;KACF;IACD;QACE,wCAAwC,CAAC,IAAI;QAC7C;YACE,MAAM,EAAE,wCAAwC;YAChD,eAAe,EAAE,4CAA4C;SAC9D;KACF;IACD;QACE,8BAA8B,CAAC,IAAI;QACnC;YACE,MAAM,EAAE,8BAA8B;YACtC,eAAe,EAAE,kCAAkC;SACpD;KACF;IACD;QACE,gCAAgC,CAAC,IAAI;QACrC;YACE,MAAM,EAAE,gCAAgC;YACxC,eAAe,EAAE,oCAAoC;SACtD;KACF;IACD;QACE,oCAAoC,CAAC,IAAI;QACzC;YACE,MAAM,EAAE,oCAAoC;YAC5C,eAAe,EAAE,wCAAwC;SAC1D;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":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AA2K5C,eAAO,MAAM,sBAAsB,EAAE,QAAQ,EAQ1C,CAAC;AAEJ,eAAO,MAAM,wBAAwB,EAAE,QAMtC,CAAC"}

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

@@ -0,0 +1,177 @@
+import { getSupportedEntityTypes, } from "../../tools/utils/entity-mapping.js";
+const ENTITY_EXAMPLE_CONTENT = {
+    campaign: `# Snapchat Campaign Examples
+
+## Create an Awareness Campaign (daily budget)
+\`\`\`json
+{
+  "entityType": "campaign",
+  "adAccountId": "acct_123456",
+  "data": {
+    "name": "Spring 2024 Awareness Campaign",
+    "objective": "AWARENESS",
+    "status": "ACTIVE",
+    "ad_account_id": "acct_123456",
+    "daily_budget_micro": 50000000,
+    "start_time": "2024-03-01T00:00:00Z",
+    "end_time": "2024-03-31T23:59:59Z"
+  }
+}
+\`\`\`
+
+## Create an App Install Campaign (lifetime budget)
+\`\`\`json
+{
+  "entityType": "campaign",
+  "adAccountId": "acct_123456",
+  "data": {
+    "name": "App Install Q1 2024",
+    "objective": "APP_INSTALLS",
+    "status": "PAUSED",
+    "ad_account_id": "acct_123456",
+    "lifetime_spend_cap_micro": 500000000
+  }
+}
+\`\`\`
+
+## Update Campaign Budget
+\`\`\`json
+{
+  "entityType": "campaign",
+  "adAccountId": "acct_123456",
+  "entityId": "campaign_abc",
+  "data": {
+    "daily_budget_micro": 100000000
+  }
+}
+\`\`\`
+
+⚠️ **Budgets are in micro-currency: 1 USD = 1,000,000. $50/day → daily_budget_micro: 50000000**
+`,
+    adGroup: `# Snapchat Ad Squad (Ad Group) Examples
+
+⚠️ **Ad groups in Snapchat are called "Ad Squads" — entity type "adGroup" maps to API path /adsquads**
+⚠️ **List path uses campaignId (/v1/campaigns/{id}/adsquads) but create path uses adAccountId**
+
+## Create an Ad Squad with Targeting
+\`\`\`json
+{
+  "entityType": "adGroup",
+  "adAccountId": "acct_123456",
+  "data": {
+    "name": "18-35 Female Audience",
+    "campaign_id": "campaign_abc",
+    "status": "ACTIVE",
+    "daily_budget_micro": 10000000,
+    "bid_micro": 1000000,
+    "optimization_goal": "SWIPE",
+    "placement": "SNAP_ADS"
+  }
+}
+\`\`\`
+
+## Create a Video Views Ad Squad
+\`\`\`json
+{
+  "entityType": "adGroup",
+  "adAccountId": "acct_123456",
+  "data": {
+    "name": "Video Views - All Ages",
+    "campaign_id": "campaign_abc",
+    "status": "ACTIVE",
+    "daily_budget_micro": 20000000,
+    "bid_micro": 500000,
+    "optimization_goal": "VIDEO_VIEWS",
+    "placement": "BOTH"
+  }
+}
+\`\`\`
+`,
+    ad: `# Snapchat Ad Examples
+
+## Create a Snap Ad
+\`\`\`json
+{
+  "entityType": "ad",
+  "adAccountId": "acct_123456",
+  "data": {
+    "name": "Spring Sale Ad",
+    "ad_squad_id": "adsquad_xyz",
+    "creative_id": "creative_123",
+    "status": "ACTIVE",
+    "type": "SNAP_AD"
+  }
+}
+\`\`\`
+
+## Create a Story Ad
+\`\`\`json
+{
+  "entityType": "ad",
+  "adAccountId": "acct_123456",
+  "data": {
+    "name": "Brand Story Ad",
+    "ad_squad_id": "adsquad_xyz",
+    "creative_id": "creative_456",
+    "status": "ACTIVE",
+    "type": "STORY"
+  }
+}
+\`\`\`
+`,
+    creative: `# Snapchat Creative Examples
+
+## Create a Snap Ad Creative
+\`\`\`json
+{
+  "entityType": "creative",
+  "adAccountId": "acct_123456",
+  "data": {
+    "name": "Spring Sale Creative",
+    "type": "SNAP_AD",
+    "ad_account_id": "acct_123456",
+    "brand_name": "Your Brand",
+    "headline": "Shop the Spring Sale",
+    "call_to_action": "SHOP_NOW"
+  }
+}
+\`\`\`
+
+## Create an App Install Creative
+\`\`\`json
+{
+  "entityType": "creative",
+  "adAccountId": "acct_123456",
+  "data": {
+    "name": "App Install Creative",
+    "type": "APP_INSTALL",
+    "ad_account_id": "acct_123456",
+    "brand_name": "Your App",
+    "headline": "Download our app today",
+    "call_to_action": "INSTALL_NOW"
+  }
+}
+\`\`\`
+`,
+};
+function buildAllExamplesMarkdown() {
+    return getSupportedEntityTypes()
+        .map((t) => ENTITY_EXAMPLE_CONTENT[t])
+        .join("\n\n---\n\n");
+}
+export const entityExampleResources = getSupportedEntityTypes().map((entityType) => ({
+    uri: `entity-examples://snapchat/${entityType}`,
+    name: `Snapchat ${entityType} Examples`,
+    description: `Example payloads for creating and updating Snapchat ${entityType} entities`,
+    mimeType: "text/markdown",
+    getContent: () => ENTITY_EXAMPLE_CONTENT[entityType] ??
+        `# Snapchat ${entityType} Examples\n\nNo examples available.\n`,
+}));
+export const entityExampleAllResource = {
+    uri: "entity-examples://snapchat/all",
+    name: "Snapchat All Entity Examples",
+    description: "Combined example payloads for all Snapchat Ads entity types",
+    mimeType: "text/markdown",
+    getContent: buildAllExamplesMarkdown,
+};
+//# 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":"AAOA,OAAO,EACL,uBAAuB,GAExB,MAAM,qCAAqC,CAAC;AAE7C,MAAM,sBAAsB,GAAuC;IACjE,QAAQ,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+CX;IAEC,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsCV;IAEC,EAAE,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BL;IAEC,QAAQ,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiCX;CACA,CAAC;AAEF,SAAS,wBAAwB;IAC/B,OAAO,uBAAuB,EAAE;SAC7B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;SACrC,IAAI,CAAC,aAAa,CAAC,CAAC;AACzB,CAAC;AAED,MAAM,CAAC,MAAM,sBAAsB,GAAe,uBAAuB,EAAE,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC/F,GAAG,EAAE,8BAA8B,UAAU,EAAE;IAC/C,IAAI,EAAE,YAAY,UAAU,WAAW;IACvC,WAAW,EAAE,uDAAuD,UAAU,WAAW;IACzF,QAAQ,EAAE,eAAe;IACzB,UAAU,EAAE,GAAG,EAAE,CACf,sBAAsB,CAAC,UAAU,CAAC;QAClC,cAAc,UAAU,uCAAuC;CAClE,CAAC,CAAC,CAAC;AAEJ,MAAM,CAAC,MAAM,wBAAwB,GAAa;IAChD,GAAG,EAAE,gCAAgC;IACrC,IAAI,EAAE,8BAA8B;IACpC,WAAW,EAAE,6DAA6D;IAC1E,QAAQ,EAAE,eAAe;IACzB,UAAU,EAAE,wBAAwB;CACrC,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":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AA2L5C,eAAO,MAAM,uBAAuB,EAAE,QAUrC,CAAC"}

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

@@ -0,0 +1,194 @@
+let cachedContent;
+function formatEntityHierarchyMarkdown() {
+    return `# Snapchat Ads Entity Hierarchy
+
+## Relationship Diagram
+
+\`\`\`
+Ad Account (ad_account_id: XXXXXXXXXX)
+  ├── Campaign (campaign_id)
+  │     └── Ad Squad (adsquad_id)  ← "adGroup" in this server
+  │           └── Ad (ad_id)  ← references Creative
+  └── Creative (creative_id, reusable across ads)
+\`\`\`
+
+## Entity Types (4 total)
+
+| Entity Type | List Endpoint | Create Endpoint | ID Field |
+|-------------|---------------|-----------------|----------|
+| **campaign** | \`GET /v1/adaccounts/{adAccountId}/campaigns\` | \`POST /v1/adaccounts/{adAccountId}/campaigns\` | id |
+| **adGroup** (Ad Squad) | \`GET /v1/campaigns/{campaignId}/adsquads\` | \`POST /v1/campaigns/{campaignId}/adsquads\` | id |
+| **ad** | \`GET /v1/adsquads/{adSquadId}/ads\` | \`POST /v1/adsquads/{adSquadId}/ads\` | id |
+| **creative** | \`GET /v1/adaccounts/{adAccountId}/creatives\` | \`POST /v1/adaccounts/{adAccountId}/creatives\` | id |
+
+## Key Relationships
+
+### Core Hierarchy: Ad Account → Campaign → Ad Squad → Ad
+- A campaign has one or more ad squads (adGroups).
+- An ad squad has one or more ads.
+- An ad references a creative asset.
+
+### Reusable Entities
+- **Creatives** can be referenced by multiple ads within the same ad account.
+
+## Creation Order
+
+Full campaign structure (top-down):
+
+1. **Ad Account** — pre-exists; discover with \`snapchat_list_ad_accounts\`
+2. **Creative(s)** — optional; upload media via \`snapchat_upload_image\` / \`snapchat_upload_video\`, then create creative
+3. **Campaign** — requires \`name\`, \`status\`, \`objective\`, \`daily_budget_micro\`
+4. **Ad Squad(s)** — requires \`campaign_id\`, \`name\`, \`status\`, \`placement\`, \`bid_micro\`, \`daily_budget_micro\`
+5. **Ad(s)** — requires \`ad_squad_id\`, \`name\`, \`status\`, \`creative_id\`, \`type\`
+
+## Snapchat Ads API v1 Patterns
+
+### List campaigns
+\`\`\`
+GET /v1/adaccounts/{adAccountId}/campaigns
+Authorization: Bearer <token>
+\`\`\`
+
+### Create campaign
+\`\`\`
+POST /v1/adaccounts/{adAccountId}/campaigns
+{ "campaigns": [{ "name": "...", "status": "PAUSED", "objective": "WEBSITE_CONVERSIONS", "daily_budget_micro": 10000000 }] }
+\`\`\`
+
+### Update campaign
+\`\`\`
+PUT /v1/campaigns/{campaignId}
+{ "campaigns": [{ "id": "...", "name": "...", "status": "ACTIVE" }] }
+\`\`\`
+
+### Delete campaign
+\`\`\`
+DELETE /v1/campaigns/{campaignId}
+\`\`\`
+
+### List ad squads
+\`\`\`
+GET /v1/campaigns/{campaignId}/adsquads
+\`\`\`
+
+### Create ad squad
+\`\`\`
+POST /v1/campaigns/{campaignId}/adsquads
+{ "adsquads": [{ "name": "...", "status": "PAUSED", "placement": "SNAP_ADS", "bid_micro": 1000000, "daily_budget_micro": 5000000 }] }
+\`\`\`
+
+### Update ad squad
+\`\`\`
+PUT /v1/adsquads/{adSquadId}
+{ "adsquads": [{ "id": "...", "bid_micro": 2000000 }] }
+\`\`\`
+
+### List ads
+\`\`\`
+GET /v1/adsquads/{adSquadId}/ads
+\`\`\`
+
+### Create ad
+\`\`\`
+POST /v1/adsquads/{adSquadId}/ads
+{ "ads": [{ "name": "...", "status": "PAUSED", "type": "SNAP_AD", "creative_id": "..." }] }
+\`\`\`
+
+### Update ad
+\`\`\`
+PUT /v1/ads/{adId}
+{ "ads": [{ "id": "...", "status": "ACTIVE" }] }
+\`\`\`
+
+### List creatives
+\`\`\`
+GET /v1/adaccounts/{adAccountId}/creatives
+\`\`\`
+
+### Create creative
+\`\`\`
+POST /v1/adaccounts/{adAccountId}/creatives
+{ "creatives": [{ "name": "...", "type": "SNAP_AD", "ad_account_id": "...", "brand_name": "...", "headline": "...", "top_snap_media_id": "..." }] }
+\`\`\`
+
+## Response Envelope
+
+All Snapchat API responses follow this structure:
+\`\`\`json
+{
+  "request_status": "SUCCESS",
+  "request_id": "...",
+  "campaigns": [
+    {
+      "sub_request_status": "SUCCESS",
+      "campaign": { "id": "...", "name": "...", ... }
+    }
+  ]
+}
+\`\`\`
+- \`request_status: "SUCCESS"\` = top-level success
+- \`request_status: "FAILED"\` = error (check \`display_message\`)
+- Each entity item has its own \`sub_request_status\`
+
+## Pagination
+
+Snapchat uses cursor-based pagination:
+- Response includes a \`cursor\` field for the next page
+- Pass \`cursor\` as a query param to get the next page of results
+
+## Budget
+
+- Budget values are in **micro-currency** (1,000,000 = $1.00 USD, or equivalent in account currency)
+- \`daily_budget_micro\`: daily spend cap
+- \`lifetime_spend_cap_micro\`: lifetime total cap
+- Example: $10/day = 10,000,000 micro
+
+## Campaign Objectives
+
+| Objective | Use Case |
+|-----------|----------|
+| WEBSITE_CONVERSIONS | Optimize for website conversion events |
+| APP_INSTALLS | Drive app downloads |
+| APP_ENGAGEMENT | Re-engage app users |
+| BRAND_AWARENESS | Reach and brand recall |
+| VIDEO_VIEWS | Maximize video plays |
+| LEAD_GENERATION | In-app lead forms |
+| CATALOG_SALES | Dynamic product ads |
+| WEB_VIEW | Drive website visits |
+
+## Available Tools Summary
+
+| Tool | Purpose | Batch? |
+|------|---------|--------|
+| \`snapchat_list_entities\` | List entities with filters | |
+| \`snapchat_get_entity\` | Get single entity | |
+| \`snapchat_create_entity\` | Create single entity | |
+| \`snapchat_update_entity\` | Update single entity | |
+| \`snapchat_delete_entity\` | Delete entities | ✓ |
+| \`snapchat_list_ad_accounts\` | List accessible ad accounts | |
+| \`snapchat_get_report\` | Async report with polling | |
+| \`snapchat_get_report_breakdowns\` | Report with breakdown fields | |
+| \`snapchat_bulk_update_status\` | Batch status update | ✓ |
+| \`snapchat_bulk_create_entities\` | Batch entity creation | ✓ |
+| \`snapchat_bulk_update_entities\` | Batch entity updates | ✓ |
+| \`snapchat_adjust_bids\` | Batch bid adjustment | ✓ |
+| \`snapchat_search_targeting\` | Search targeting options | |
+| \`snapchat_get_targeting_options\` | Browse targeting categories | |
+| \`snapchat_get_audience_estimate\` | Audience size estimation | |
+| \`snapchat_get_ad_preview\` | Ad preview data | |
+| \`snapchat_validate_entity\` | Client-side payload validation | |
+| \`snapchat_upload_image\` | Upload image to media library | |
+| \`snapchat_upload_video\` | Upload video to media library (polls) | |
+`;
+}
+export const entityHierarchyResource = {
+    uri: "entity-hierarchy://snapchat/all",
+    name: "Snapchat Entity Hierarchy",
+    description: "Parent-child relationships between Snapchat Ads 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":"AAQA,IAAI,aAAiC,CAAC;AAEtC,SAAS,6BAA6B;IACpC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmLR,CAAC;AACF,CAAC;AAED,MAAM,CAAC,MAAM,uBAAuB,GAAa;IAC/C,GAAG,EAAE,iCAAiC;IACtC,IAAI,EAAE,2BAA2B;IACjC,WAAW,EACT,+FAA+F;IACjG,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":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAmI5C,eAAO,MAAM,qBAAqB,EAAE,QAAQ,EAMzC,CAAC;AAEJ,eAAO,MAAM,uBAAuB,EAAE,QAMrC,CAAC"}

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

@@ -0,0 +1,117 @@
+import { getSupportedEntityTypes, } from "../../tools/utils/entity-mapping.js";
+const ENTITY_SCHEMA_CONTENT = {
+    campaign: JSON.stringify({
+        type: "object",
+        required: ["name", "objective", "ad_account_id"],
+        properties: {
+            name: { type: "string", description: "Campaign name" },
+            objective: {
+                type: "string",
+                enum: [
+                    "AWARENESS",
+                    "APP_INSTALLS",
+                    "DRIVE_REPLAY",
+                    "LEAD_GENERATION",
+                    "WEBSITE_CONVERSIONS",
+                    "PRODUCT_CATALOG_SALES",
+                    "VIDEO_VIEWS",
+                ],
+            },
+            status: { type: "string", enum: ["ACTIVE", "PAUSED"] },
+            ad_account_id: { type: "string", description: "Ad account ID" },
+            daily_budget_micro: {
+                type: "integer",
+                description: "Daily budget in micro-currency (1 USD = 1,000,000)",
+            },
+            lifetime_spend_cap_micro: {
+                type: "integer",
+                description: "Lifetime spend cap in micro-currency",
+            },
+            start_time: {
+                type: "string",
+                format: "date-time",
+                description: "Campaign start time (ISO 8601)",
+            },
+            end_time: {
+                type: "string",
+                format: "date-time",
+                description: "Campaign end time (ISO 8601)",
+            },
+        },
+    }, null, 2),
+    adGroup: JSON.stringify({
+        type: "object",
+        required: ["name", "campaign_id"],
+        properties: {
+            name: { type: "string" },
+            campaign_id: { type: "string" },
+            status: { type: "string", enum: ["ACTIVE", "PAUSED"] },
+            daily_budget_micro: { type: "integer" },
+            bid_micro: {
+                type: "integer",
+                description: "Bid amount in micro-currency",
+            },
+            optimization_goal: {
+                type: "string",
+                enum: ["SWIPE", "PIXEL_PAGE_VIEW", "APP_INSTALL", "VIDEO_VIEWS", "STORY_OPENS"],
+            },
+            placement: {
+                type: "string",
+                enum: ["SNAP_ADS", "AUDIENCE_NETWORK", "BOTH"],
+            },
+        },
+    }, null, 2),
+    ad: JSON.stringify({
+        type: "object",
+        required: ["name", "ad_squad_id", "creative_id"],
+        properties: {
+            name: { type: "string" },
+            ad_squad_id: { type: "string" },
+            creative_id: { type: "string" },
+            status: { type: "string", enum: ["ACTIVE", "PAUSED"] },
+            type: { type: "string", enum: ["SNAP_AD", "STORY", "COLLECTION"] },
+        },
+    }, null, 2),
+    creative: JSON.stringify({
+        type: "object",
+        required: ["name", "type", "ad_account_id"],
+        properties: {
+            name: { type: "string" },
+            type: {
+                type: "string",
+                enum: ["SNAP_AD", "STORY", "COLLECTION", "APP_INSTALL", "WEB_VIEW"],
+            },
+            ad_account_id: { type: "string" },
+            brand_name: { type: "string" },
+            headline: { type: "string" },
+            call_to_action: {
+                type: "string",
+                enum: ["INSTALL_NOW", "SHOP_NOW", "LEARN_MORE", "SIGN_UP", "WATCH_NOW"],
+            },
+        },
+    }, null, 2),
+};
+function buildEntitySchemaMarkdown(entityType) {
+    return (ENTITY_SCHEMA_CONTENT[entityType] ??
+        `# Snapchat ${entityType}\n\nNo schema information available.\n`);
+}
+function buildAllSchemasMarkdown() {
+    return getSupportedEntityTypes()
+        .map((t) => ENTITY_SCHEMA_CONTENT[t])
+        .join("\n\n---\n\n");
+}
+export const entitySchemaResources = getSupportedEntityTypes().map((entityType) => ({
+    uri: `entity-schema://snapchat/${entityType}`,
+    name: `Snapchat ${entityType} Schema`,
+    description: `Field reference for Snapchat ${entityType} entity including required fields, optional fields, and read-only fields`,
+    mimeType: "text/markdown",
+    getContent: () => buildEntitySchemaMarkdown(entityType),
+}));
+export const entitySchemaAllResource = {
+    uri: "entity-schema://snapchat/all",
+    name: "Snapchat All Entity Schemas",
+    description: "Combined field reference for all Snapchat Ads entity types",
+    mimeType: "text/markdown",
+    getContent: buildAllSchemasMarkdown,
+};
+//# 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":"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"}

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

@@ -0,0 +1,7 @@
+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";
+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;AAQ/E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAuC5C,eAAO,MAAM,YAAY,EAAE,QAAQ,EASlC,CAAC"}

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

@@ -0,0 +1,54 @@
+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";
+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 { allTools } from "../../tools/definitions/index.js";
+import { createToolExamplesResource, createServerCapabilitiesResource } from "@cesteral/shared";
+const toolExamplesResource = createToolExamplesResource(allTools, "snapchat-mcp");
+const serverCapabilitiesResource = createServerCapabilitiesResource({
+    serverName: "snapchat-mcp",
+    toolGroups: {
+        crud: [
+            "snapchat_list_entities",
+            "snapchat_get_entity",
+            "snapchat_create_entity",
+            "snapchat_update_entity",
+            "snapchat_delete_entity",
+        ],
+        account: ["snapchat_list_ad_accounts"],
+        reporting: [
+            "snapchat_get_report",
+            "snapchat_get_report_breakdowns",
+            "snapchat_submit_report",
+            "snapchat_check_report_status",
+            "snapchat_download_report",
+        ],
+        bulk: [
+            "snapchat_bulk_update_status",
+            "snapchat_bulk_create_entities",
+            "snapchat_bulk_update_entities",
+            "snapchat_adjust_bids",
+        ],
+        targeting: ["snapchat_search_targeting", "snapchat_get_targeting_options"],
+        specialized: ["snapchat_get_audience_estimate", "snapchat_get_ad_preview"],
+        validation: ["snapchat_validate_entity"],
+        discovery: ["snapchat_search_tools"],
+    },
+    commonWorkflows: ["campaign_setup", "async_reporting", "audience_targeting"],
+    startHere: "snapchat_list_ad_accounts",
+});
+export const allResources = [
+    entityHierarchyResource,
+    entitySchemaAllResource,
+    ...entitySchemaResources,
+    entityExampleAllResource,
+    ...entityExampleResources,
+    reportingReferenceResource,
+    ...(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;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,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAC5D,OAAO,EAAE,0BAA0B,EAAE,gCAAgC,EAAE,MAAM,kBAAkB,CAAC;AAGhG,MAAM,oBAAoB,GAAG,0BAA0B,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;AAClF,MAAM,0BAA0B,GAAG,gCAAgC,CAAC;IAClE,UAAU,EAAE,cAAc;IAC1B,UAAU,EAAE;QACV,IAAI,EAAE;YACJ,wBAAwB;YACxB,qBAAqB;YACrB,wBAAwB;YACxB,wBAAwB;YACxB,wBAAwB;SACzB;QACD,OAAO,EAAE,CAAC,2BAA2B,CAAC;QACtC,SAAS,EAAE;YACT,qBAAqB;YACrB,gCAAgC;YAChC,wBAAwB;YACxB,8BAA8B;YAC9B,0BAA0B;SAC3B;QACD,IAAI,EAAE;YACJ,6BAA6B;YAC7B,+BAA+B;YAC/B,+BAA+B;YAC/B,sBAAsB;SACvB;QACD,SAAS,EAAE,CAAC,2BAA2B,EAAE,gCAAgC,CAAC;QAC1E,WAAW,EAAE,CAAC,gCAAgC,EAAE,yBAAyB,CAAC;QAC1E,UAAU,EAAE,CAAC,0BAA0B,CAAC;QACxC,SAAS,EAAE,CAAC,uBAAuB,CAAC;KACrC;IACD,eAAe,EAAE,CAAC,gBAAgB,EAAE,iBAAiB,EAAE,oBAAoB,CAAC;IAC5E,SAAS,EAAE,2BAA2B;CACvC,CAAC,CAAC;AAKH,MAAM,CAAC,MAAM,YAAY,GAAe;IACtC,uBAAuB;IACvB,uBAAuB;IACvB,GAAG,qBAAqB;IACxB,wBAAwB;IACxB,GAAG,sBAAsB;IACzB,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":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AA6I5C,eAAO,MAAM,0BAA0B,EAAE,QAUxC,CAAC"}