@cesteral/meta-mcp 1.0.0

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

@@ -0,0 +1,140 @@
+import { getSupportedEntityTypes, getEntityConfig, } from "../../tools/utils/entity-mapping.js";
+const ENTITY_EXAMPLES = {
+    campaign: `# Campaign Examples
+
+## Create a traffic campaign
+\`\`\`json
+{
+  "name": "Summer Sale 2026 - Traffic",
+  "objective": "OUTCOME_TRAFFIC",
+  "status": "PAUSED",
+  "special_ad_categories": [],
+  "daily_budget": 5000,
+  "bid_strategy": "LOWEST_COST_WITHOUT_CAP"
+}
+\`\`\`
+
+## Create a conversions campaign with CBO
+\`\`\`json
+{
+  "name": "Q1 Conversions",
+  "objective": "OUTCOME_SALES",
+  "status": "PAUSED",
+  "special_ad_categories": [],
+  "daily_budget": 10000,
+  "campaign_budget_optimization": true,
+  "bid_strategy": "COST_CAP"
+}
+\`\`\``,
+    adSet: `# Ad Set Examples
+
+## Basic ad set with interest targeting
+\`\`\`json
+{
+  "name": "US 25-44 Fitness Enthusiasts",
+  "campaign_id": "CAMPAIGN_ID",
+  "optimization_goal": "LINK_CLICKS",
+  "billing_event": "IMPRESSIONS",
+  "daily_budget": 5000,
+  "targeting": {
+    "age_min": 25,
+    "age_max": 44,
+    "geo_locations": { "countries": ["US"] },
+    "interests": [{ "id": "6003139266461", "name": "Fitness and wellness" }],
+    "targeting_automation": { "advantage_audience": 0 }
+  },
+  "status": "PAUSED"
+}
+\`\`\`
+
+## Ad set with custom audience and frequency cap
+\`\`\`json
+{
+  "name": "Retargeting - Website Visitors",
+  "campaign_id": "CAMPAIGN_ID",
+  "optimization_goal": "CONVERSIONS",
+  "billing_event": "IMPRESSIONS",
+  "daily_budget": 3000,
+  "targeting": {
+    "custom_audiences": [{ "id": "AUDIENCE_ID" }],
+    "geo_locations": { "countries": ["US"] }
+  },
+  "frequency_control_specs": [{
+    "event": "IMPRESSIONS",
+    "interval_days": 7,
+    "max_frequency": 3
+  }],
+  "status": "PAUSED"
+}
+\`\`\``,
+    ad: `# Ad Examples
+
+## Create an ad referencing an existing creative
+\`\`\`json
+{
+  "name": "Summer Sale - Image Ad v1",
+  "adset_id": "ADSET_ID",
+  "creative": { "creative_id": "CREATIVE_ID" },
+  "status": "PAUSED"
+}
+\`\`\``,
+    adCreative: `# Ad Creative Examples
+
+## Link ad creative
+\`\`\`json
+{
+  "name": "Summer Sale Creative",
+  "object_story_spec": {
+    "page_id": "PAGE_ID",
+    "link_data": {
+      "link": "https://example.com/sale",
+      "message": "Don't miss our Summer Sale!",
+      "name": "Summer Sale - 50% Off",
+      "description": "Shop now and save big.",
+      "call_to_action": { "type": "SHOP_NOW" },
+      "image_hash": "IMAGE_HASH"
+    }
+  }
+}
+\`\`\``,
+    customAudience: `# Custom Audience Examples
+
+## Website visitors audience
+\`\`\`json
+{
+  "name": "Website Visitors - Last 30 Days",
+  "subtype": "WEBSITE",
+  "description": "People who visited our website in the last 30 days"
+}
+\`\`\`
+
+## Lookalike audience
+\`\`\`json
+{
+  "name": "Lookalike - Top Purchasers US 1%",
+  "subtype": "LOOKALIKE",
+  "lookalike_spec": {
+    "origin": [{ "id": "SOURCE_AUDIENCE_ID", "type": "custom_audience" }],
+    "country": "US",
+    "ratio": 0.01
+  }
+}
+\`\`\``,
+};
+export const entityExampleResources = getSupportedEntityTypes().map((entityType) => ({
+    uri: `entity-examples://${entityType}`,
+    name: `${getEntityConfig(entityType).displayName} Examples`,
+    description: `Example payloads for Meta ${getEntityConfig(entityType).displayName} operations`,
+    mimeType: "text/markdown",
+    getContent: () => ENTITY_EXAMPLES[entityType] || `# ${entityType}\n\nNo examples yet.`,
+}));
+export const entityExampleAllResource = {
+    uri: "entity-examples://all",
+    name: "All Meta Entity Examples",
+    description: "Combined examples for all Meta Ads 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":"AAOA,OAAO,EACL,uBAAuB,EACvB,eAAe,GAEhB,MAAM,qCAAqC,CAAC;AAE7C,MAAM,eAAe,GAAmC;IACtD,QAAQ,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;OAyBL;IAEL,KAAK,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAwCF;IAEL,EAAE,EAAE;;;;;;;;;;OAUC;IAEL,UAAU,EAAE;;;;;;;;;;;;;;;;;;OAkBP;IAEL,cAAc,EAAE;;;;;;;;;;;;;;;;;;;;;;OAsBX;CACN,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,eAAe,CAAC,UAAU,CAAC,CAAC,WAAW,WAAW;IAC3D,WAAW,EAAE,6BAA6B,eAAe,CAAC,UAAU,CAAC,CAAC,WAAW,aAAa;IAC9F,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,0BAA0B;IAChC,WAAW,EAAE,iDAAiD;IAC9D,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":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AA8G5C,eAAO,MAAM,uBAAuB,EAAE,QAUrC,CAAC"}

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

@@ -0,0 +1,117 @@
+let cachedContent;
+function formatEntityHierarchyMarkdown() {
+    return `# Meta Ads Entity Hierarchy
+
+## Relationship Diagram
+
+\`\`\`
+Ad Account (act_XXXXXXXXX)
+  ├── Campaign
+  │     └── Ad Set
+  │           └── Ad (references: Ad Creative)
+  ├── Ad Creative (reusable across ads)
+  └── Custom Audience (reusable for targeting)
+\`\`\`
+
+## Entity Types (5 total)
+
+| Entity Type | API Edge | Display Name | Supports Duplicate |
+|-------------|----------|--------------|:---:|
+| **campaign** | \`campaigns\` | Campaign | ✓ |
+| **adSet** | \`adsets\` | Ad Set | ✓ |
+| **ad** | \`ads\` | Ad | ✓ |
+| **adCreative** | \`adcreatives\` | Ad Creative | |
+| **customAudience** | \`customaudiences\` | Custom Audience | |
+
+## Key Relationships
+
+### Core Hierarchy: Account → Campaign → Ad Set → Ad
+- All entities are created under an ad account (flat, not nested).
+- A campaign has one or more ad sets.
+- An ad set has one or more ads.
+- An ad references an ad creative via \`creative.creative_id\`.
+
+### Reusable Entities
+- **Ad Creatives** are shared across ads within the same ad account.
+- **Custom Audiences** are used in ad set targeting specifications.
+
+## Creation Order
+
+Full campaign structure (top-down):
+
+1. **Ad Account** — usually pre-exists; verify with \`meta_list_ad_accounts\`
+2. **Custom Audience(s)** — create if using custom audience targeting
+3. **Ad Creative(s)** — create before ads that reference them
+4. **Campaign** — requires \`name\`, \`objective\`, \`special_ad_categories\`
+5. **Ad Set(s)** — requires \`campaign_id\`, \`targeting\`, \`optimization_goal\`, \`billing_event\`
+6. **Ad(s)** — requires \`adset_id\`, \`creative\` (with creative_id)
+
+## Meta API Patterns
+
+### Create: POST /act_{id}/{edge}
+All entities are created via the ad account edge.
+
+### Read: GET /{entityId}?fields=...
+**Important:** Meta returns NO fields by default. You must explicitly request fields.
+
+### Update: POST /{entityId} (PATCH semantics)
+Only provided fields are updated. Returns \`{ success: true }\`, NOT the full entity.
+
+### Delete: DELETE /{entityId}
+Active entities must be paused first.
+
+### List: GET /act_{id}/{edge}?fields=...&filtering=[...]
+Uses cursor-based pagination (\`after\` parameter).
+
+## Available Tools Summary
+
+| Tool | Purpose | Batch? |
+|------|---------|--------|
+| \`meta_list_entities\` | List entities with filters | |
+| \`meta_get_entity\` | Get single entity | |
+| \`meta_create_entity\` | Create single entity | |
+| \`meta_update_entity\` | Update single entity | |
+| \`meta_delete_entity\` | Delete single entity | |
+| \`meta_list_ad_accounts\` | List accessible ad accounts | |
+| \`meta_get_insights\` | Get performance insights | |
+| \`meta_get_insights_breakdowns\` | Get insights with breakdowns | |
+| \`meta_bulk_update_status\` | Batch status update | ✓ |
+| \`meta_bulk_create_entities\` | Batch entity creation | ✓ |
+| \`meta_search_targeting\` | Search targeting options | |
+| \`meta_get_targeting_options\` | Browse targeting categories | |
+| \`meta_duplicate_entity\` | Duplicate campaign/adSet/ad | |
+| \`meta_get_delivery_estimate\` | Audience size estimation | |
+| \`meta_get_ad_preview\` | Ad preview HTML | |
+| \`meta_adjust_bids\` | Batch adjust ad set bid amounts | ✓ |
+| \`meta_validate_entity\` | Client-side payload validation | |
+
+## Budget Notes
+
+- Budget values are in **cents** (1000 = $10 USD)
+- Zero-decimal currencies (JPY, KRW, VND) use base unit
+- Budget changes limited to ~4/hour per ad set
+- Campaign Budget Optimization (CBO): set \`campaign_budget_optimization\` on campaign
+
+## Campaign Objectives (ODAX)
+
+| Objective | Replaces |
+|-----------|----------|
+| OUTCOME_AWARENESS | BRAND_AWARENESS, REACH |
+| OUTCOME_TRAFFIC | LINK_CLICKS, TRAFFIC |
+| OUTCOME_ENGAGEMENT | POST_ENGAGEMENT, PAGE_LIKES, VIDEO_VIEWS |
+| OUTCOME_LEADS | LEAD_GENERATION |
+| OUTCOME_SALES | CONVERSIONS, CATALOG_SALES |
+| OUTCOME_APP_PROMOTION | APP_INSTALLS |
+`;
+}
+export const entityHierarchyResource = {
+    uri: "entity-hierarchy://all",
+    name: "Meta Entity Hierarchy",
+    description: "Parent-child relationships between Meta 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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsGR,CAAC;AACF,CAAC;AAED,MAAM,CAAC,MAAM,uBAAuB,GAAa;IAC/C,GAAG,EAAE,wBAAwB;IAC7B,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EACT,2FAA2F;IAC7F,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":"AAQA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAuH5C,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,125 @@
+import { getSupportedEntityTypes, getEntityConfig, } from "../../tools/utils/entity-mapping.js";
+const ENTITY_SCHEMAS = {
+    campaign: `# Campaign Schema
+
+## Required Fields
+- \`name\` (string) — Campaign name
+- \`objective\` (string) — OUTCOME_AWARENESS, OUTCOME_TRAFFIC, OUTCOME_ENGAGEMENT, OUTCOME_LEADS, OUTCOME_SALES, OUTCOME_APP_PROMOTION
+- \`special_ad_categories\` (array) — Empty array [] if none, or ["EMPLOYMENT", "HOUSING", "CREDIT", "ISSUES_ELECTIONS_POLITICS"]
+
+## Optional Fields
+- \`status\` (string) — ACTIVE, PAUSED (default: PAUSED)
+- \`configured_status\` (string) — The status set by the advertiser (vs effective status)
+- \`daily_budget\` (integer) — Daily budget in cents
+- \`lifetime_budget\` (integer) — Lifetime budget in cents
+- \`budget_remaining\` (string) — Remaining budget (read-only)
+- \`bid_strategy\` (string) — LOWEST_COST_WITHOUT_CAP, LOWEST_COST_WITH_BID_CAP, COST_CAP
+- \`buying_type\` (string) — AUCTION (default), RESERVED
+- \`campaign_budget_optimization\` (boolean) — Enable CBO
+- \`special_ad_category_country\` (array) — Countries for special ad category enforcement
+- \`start_time\` (string) — ISO 8601 datetime
+- \`stop_time\` (string) — ISO 8601 datetime`,
+    adSet: `# Ad Set Schema
+
+## Required Fields
+- \`name\` (string) — Ad set name
+- \`campaign_id\` (string) — Parent campaign ID
+- \`optimization_goal\` (string) — LINK_CLICKS, REACH, CONVERSIONS, APP_INSTALLS, VALUE, etc.
+- \`billing_event\` (string) — IMPRESSIONS, LINK_CLICKS, etc.
+- \`targeting\` (object) — Targeting specification
+- \`status\` (string) — ACTIVE, PAUSED
+
+## Optional Fields
+- \`daily_budget\` (integer) — Budget in cents (if not using CBO)
+- \`lifetime_budget\` (integer) — Lifetime budget in cents
+- \`budget_remaining\` (string) — Remaining budget (read-only)
+- \`bid_amount\` (integer) — Bid cap in cents
+- \`bid_strategy\` (string) — LOWEST_COST_WITHOUT_CAP, LOWEST_COST_WITH_BID_CAP, COST_CAP
+- \`bid_constraints\` (object) — Bid constraints (e.g., roas_average_floor for MIN_ROAS)
+- \`start_time\` (string) — ISO 8601 datetime
+- \`end_time\` (string) — ISO 8601 datetime (required for lifetime budgets)
+- \`frequency_control_specs\` (array) — Frequency capping rules [{event, interval_days, max_frequency}]
+- \`is_dynamic_creative\` (boolean) — Enable dynamic creative testing
+- \`destination_type\` (string) — WEBSITE, APP, MESSENGER, WHATSAPP, INSTAGRAM_DIRECT, etc.
+- \`promoted_object\` (object) — Required for APP_INSTALLS (application_id, object_store_url)
+- \`attribution_spec\` (array) — Attribution settings
+- \`pacing_type\` (array) — Budget pacing ["standard"] or ["no_pacing"]
+- \`dsa_beneficiary\` (string) — DSA compliance: beneficiary name (EU)
+- \`dsa_payor\` (string) — DSA compliance: payor name (EU)
+
+## Targeting Spec Structure
+\`\`\`json
+{
+  "age_min": 18,
+  "age_max": 65,
+  "genders": [1, 2],
+  "geo_locations": { "countries": ["US"] },
+  "interests": [{ "id": "6003139266461", "name": "Fitness" }],
+  "custom_audiences": [{ "id": "12345" }],
+  "targeting_automation": { "advantage_audience": 0 }
+}
+\`\`\``,
+    ad: `# Ad Schema
+
+## Required Fields
+- \`name\` (string) — Ad name
+- \`adset_id\` (string) — Parent ad set ID
+- \`creative\` (object) — Creative reference: \`{ "creative_id": "CREATIVE_ID" }\`
+- \`status\` (string) — ACTIVE, PAUSED
+
+## Optional Fields
+- \`campaign_id\` (string) — Parent campaign ID (read-only, returned in responses)
+- \`bid_amount\` (integer) — Override bid in cents
+- \`tracking_specs\` (array) — Conversion tracking specs
+- \`conversion_domain\` (string) — Domain for conversion tracking (iOS 14.5+)
+- \`preview_shareable_link\` (string) — Shareable preview link (read-only)`,
+    adCreative: `# Ad Creative Schema
+
+## Required Fields
+- \`name\` (string) — Creative name
+
+## Common Fields
+- \`object_story_spec\` (object) — Creative content specification
+- \`object_type\` (string) — Type of creative object (read-only)
+- \`body\` / \`message\` (string) — Ad body text
+- \`title\` / \`headline\` (string) — Headline
+- \`description\` (string) — Description text
+- \`link_url\` (string) — Destination URL
+- \`url_tags\` (string) — URL tags appended to all links
+- \`image_hash\` (string) — Uploaded image hash
+- \`call_to_action_type\` (string) — LEARN_MORE, SHOP_NOW, SIGN_UP, etc.
+- \`instagram_actor_id\` (string) — Instagram account for placements
+- \`product_set_id\` (string) — Product set for catalog/dynamic ads
+
+## Dynamic Creative Fields
+- \`asset_feed_spec\` (object) — Asset variations for dynamic creatives (images, videos, bodies, titles, descriptions, link_urls, ad_formats, call_to_action_types)
+- \`dynamic_creative_spec\` (object) — Dynamic creative configuration
+- \`degrees_of_freedom_spec\` (object) — Advantage+ creative optimization settings`,
+    customAudience: `# Custom Audience Schema
+
+## Required Fields
+- \`name\` (string) — Audience name
+- \`subtype\` (string) — CUSTOM, WEBSITE, APP, OFFLINE_CONVERSION, LOOKALIKE, etc.
+
+## Optional Fields
+- \`description\` (string) — Audience description
+- \`customer_file_source\` (string) — Data source type
+- \`lookalike_spec\` (object) — For lookalike audiences`,
+};
+export const entitySchemaResources = getSupportedEntityTypes().map((entityType) => ({
+    uri: `entity-schema://${entityType}`,
+    name: `${getEntityConfig(entityType).displayName} Schema`,
+    description: `Field schema for Meta ${getEntityConfig(entityType).displayName} entities`,
+    mimeType: "text/markdown",
+    getContent: () => ENTITY_SCHEMAS[entityType] || `# ${entityType}\n\nSchema not yet documented.`,
+}));
+export const entitySchemaAllResource = {
+    uri: "entity-schema://all",
+    name: "All Meta Entity Schemas",
+    description: "Combined schema reference for all Meta Ads 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":"AASA,OAAO,EACL,uBAAuB,EACvB,eAAe,GAEhB,MAAM,qCAAqC,CAAC;AAE7C,MAAM,cAAc,GAAmC;IACrD,QAAQ,EAAE;;;;;;;;;;;;;;;;;;6CAkBiC;IAE3C,KAAK,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAuCF;IAEL,EAAE,EAAE;;;;;;;;;;;;;2EAaqE;IAEzE,UAAU,EAAE;;;;;;;;;;;;;;;;;;;;;mFAqBqE;IAEjF,cAAc,EAAE;;;;;;;;;wDASsC;CACvD,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,eAAe,CAAC,UAAU,CAAC,CAAC,WAAW,SAAS;IACzD,WAAW,EAAE,yBAAyB,eAAe,CAAC,UAAU,CAAC,CAAC,WAAW,WAAW;IACxF,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,yBAAyB;IAC/B,WAAW,EAAE,yDAAyD;IACtE,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/field-rules.resource.d.ts

@@ -0,0 +1,3 @@
+import type { TemplatedResourceDefinition } from "@cesteral/shared";
+export declare const fieldRulesResource: TemplatedResourceDefinition;
+//# sourceMappingURL=field-rules.resource.d.ts.map

package/dist/mcp-server/resources/definitions/field-rules.resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-rules.resource.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/field-rules.resource.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AAQpE,eAAO,MAAM,kBAAkB,EAAE,2BA4BhC,CAAC"}

package/dist/mcp-server/resources/definitions/field-rules.resource.js

@@ -0,0 +1,28 @@
+import { getEntityTypeEnum, getSupportedEntityTypes, } from "../../tools/utils/entity-mapping.js";
+import { getFieldRulesForEntity } from "../utils/field-rules.js";
+export const fieldRulesResource = {
+    uriTemplate: "meta-field-rules://{entityType}",
+    name: "Meta Ads Field Rules",
+    description: "Required-field rules, enum suggestions, and read-only field list for a Meta Ads entity type. " +
+        `Valid {entityType}: ${getEntityTypeEnum().join(", ")}.`,
+    mimeType: "application/json",
+    resolveContent: (_uri, variables) => {
+        const raw = variables.entityType;
+        const entityType = (Array.isArray(raw) ? raw[0] : raw);
+        if (!entityType) {
+            throw new Error("meta-field-rules: missing {entityType} in URI");
+        }
+        if (!getSupportedEntityTypes().includes(entityType)) {
+            throw new Error(`meta-field-rules: unknown entityType "${entityType}". ` +
+                `Supported: ${getSupportedEntityTypes().join(", ")}.`);
+        }
+        return JSON.stringify(getFieldRulesForEntity(entityType), null, 2);
+    },
+    list: async () => getSupportedEntityTypes().map((t) => ({
+        uri: `meta-field-rules://${t}`,
+        name: `Meta Ads field rules — ${t}`,
+        description: `Required + enum + read-only fields for Meta ${t}`,
+        mimeType: "application/json",
+    })),
+};
+//# sourceMappingURL=field-rules.resource.js.map

package/dist/mcp-server/resources/definitions/field-rules.resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-rules.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/field-rules.resource.ts"],"names":[],"mappings":"AAaA,OAAO,EACL,iBAAiB,EACjB,uBAAuB,GAExB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,MAAM,CAAC,MAAM,kBAAkB,GAAgC;IAC7D,WAAW,EAAE,iCAAiC;IAC9C,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EACT,+FAA+F;QAC/F,uBAAuB,iBAAiB,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;IAC1D,QAAQ,EAAE,kBAAkB;IAC5B,cAAc,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE;QAClC,MAAM,GAAG,GAAG,SAAS,CAAC,UAAU,CAAC;QACjC,MAAM,UAAU,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAA+B,CAAC;QACrF,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;QACnE,CAAC;QACD,IAAI,CAAC,uBAAuB,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YACpD,MAAM,IAAI,KAAK,CACb,yCAAyC,UAAU,KAAK;gBACtD,cAAc,uBAAuB,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACxD,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,SAAS,CAAC,sBAAsB,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACrE,CAAC;IACD,IAAI,EAAE,KAAK,IAAI,EAAE,CACf,uBAAuB,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACpC,GAAG,EAAE,sBAAsB,CAAC,EAAE;QAC9B,IAAI,EAAE,0BAA0B,CAAC,EAAE;QACnC,WAAW,EAAE,+CAA+C,CAAC,EAAE;QAC/D,QAAQ,EAAE,kBAAkB;KAC7B,CAAC,CAAC;CACN,CAAC"}

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

@@ -0,0 +1,8 @@
+import type { FindingBuffer, FindingStore, StaticResourceDefinition } from "@cesteral/shared";
+interface FindingResourceDeps {
+    findingStore: FindingStore;
+    getFindingBuffer: () => FindingBuffer | undefined;
+}
+export declare function createFindingResources(deps: FindingResourceDeps): StaticResourceDefinition[];
+export {};
+//# sourceMappingURL=findings.resource.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"findings.resource.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/findings.resource.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAE9F,UAAU,mBAAmB;IAC3B,YAAY,EAAE,YAAY,CAAC;IAC3B,gBAAgB,EAAE,MAAM,aAAa,GAAG,SAAS,CAAC;CACnD;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,mBAAmB,GAAG,wBAAwB,EAAE,CAmC5F"}

package/dist/mcp-server/resources/definitions/findings.resource.js

@@ -0,0 +1,33 @@
+export function createFindingResources(deps) {
+    return [
+        {
+            uri: "findings://session/current",
+            name: "Current Session Findings",
+            description: "Evaluator findings buffered during the active session.",
+            mimeType: "application/json",
+            getContent: () => {
+                const buffer = deps.getFindingBuffer();
+                const findings = buffer?.getAll() ?? [];
+                return JSON.stringify({
+                    findings,
+                    count: findings.length,
+                }, null, 2);
+            },
+        },
+        {
+            uri: "findings://patterns/all",
+            name: "Detected Finding Patterns",
+            description: "Recurring evaluator issue patterns across persisted sessions.",
+            mimeType: "application/json",
+            getContent: async () => JSON.stringify(await deps.findingStore.getPatterns({}), null, 2),
+        },
+        {
+            uri: "findings://summary",
+            name: "Findings Summary",
+            description: "Aggregate finding counts by issue class/workflow with top patterns.",
+            mimeType: "application/json",
+            getContent: async () => JSON.stringify(await deps.findingStore.getSummary(), null, 2),
+        },
+    ];
+}
+//# sourceMappingURL=findings.resource.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"findings.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/findings.resource.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,sBAAsB,CAAC,IAAyB;IAC9D,OAAO;QACL;YACE,GAAG,EAAE,4BAA4B;YACjC,IAAI,EAAE,0BAA0B;YAChC,WAAW,EAAE,wDAAwD;YACrE,QAAQ,EAAE,kBAAkB;YAC5B,UAAU,EAAE,GAAG,EAAE;gBACf,MAAM,MAAM,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;gBACvC,MAAM,QAAQ,GAAG,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;gBACxC,OAAO,IAAI,CAAC,SAAS,CACnB;oBACE,QAAQ;oBACR,KAAK,EAAE,QAAQ,CAAC,MAAM;iBACvB,EACD,IAAI,EACJ,CAAC,CACF,CAAC;YACJ,CAAC;SACF;QACD;YACE,GAAG,EAAE,yBAAyB;YAC9B,IAAI,EAAE,2BAA2B;YACjC,WAAW,EAAE,+DAA+D;YAC5E,QAAQ,EAAE,kBAAkB;YAC5B,UAAU,EAAE,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;SACzF;QACD;YACE,GAAG,EAAE,oBAAoB;YACzB,IAAI,EAAE,kBAAkB;YACxB,WAAW,EAAE,qEAAqE;YAClF,QAAQ,EAAE,kBAAkB;YAC5B,UAAU,EAAE,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,IAAI,CAAC,YAAY,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;SACtF;KACF,CAAC;AACJ,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 { insightsReferenceResource } from "./insights-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,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAS/E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AA+D5C,eAAO,MAAM,YAAY,EAAE,QAAQ,EAUlC,CAAC"}

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

@@ -0,0 +1,81 @@
+export { entityHierarchyResource } from "./entity-hierarchy.resource.js";
+export { entitySchemaResources, entitySchemaAllResource } from "./entity-schemas.resource.js";
+export { entityExampleResources, entityExampleAllResource } from "./entity-examples.resource.js";
+export { insightsReferenceResource } from "./insights-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 { insightsReferenceResource } from "./insights-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, "meta-mcp");
+const serverCapabilitiesResource = createServerCapabilitiesResource({
+    serverName: "meta-mcp",
+    allTools,
+    toolGroups: {
+        account: ["meta_list_ad_accounts"],
+        crud: [
+            "meta_list_entities",
+            "meta_get_entity",
+            "meta_create_entity",
+            "meta_update_entity",
+            "meta_delete_entity",
+        ],
+        insights: [
+            "meta_get_insights",
+            "meta_get_insights_breakdowns",
+            "meta_get_available_metrics",
+            "meta_get_pacing_status",
+        ],
+        reporting: ["meta_submit_report", "meta_check_report_status", "meta_download_report"],
+        bulk: [
+            "meta_bulk_update_status",
+            "meta_bulk_create_entities",
+            "meta_bulk_update_entities",
+            "meta_adjust_bids",
+        ],
+        targeting: ["meta_search_targeting", "meta_get_targeting_options"],
+        media: ["meta_upload_image", "meta_upload_video"],
+        budgetSchedules: ["meta_manage_budget_schedule"],
+        specialized: ["meta_duplicate_entity", "meta_get_delivery_estimate", "meta_get_ad_preview"],
+        validation: ["meta_validate_entity"],
+        discovery: ["meta_search_tools"],
+    },
+    commonWorkflows: [
+        "full_campaign_setup_workflow",
+        "performance_analysis",
+        "audience_targeting",
+        "async_reporting",
+    ],
+    discoveryFlow: [
+        "Read server-capabilities://meta-mcp/overview to choose a capability group.",
+        "Call meta_list_ad_accounts to discover accessible ad accounts.",
+        "Read entity-hierarchy://all and entity-schema://{entityType} before entity writes.",
+        "Read insights-reference://all before insights or async report tools.",
+        "Read targeting-reference://all before targeting search or audience estimation.",
+        "Use tool-examples://meta-mcp/all only when concrete payload examples are needed.",
+    ],
+    relatedResources: [
+        "entity-hierarchy://all",
+        "entity-schema://all",
+        "entity-examples://all",
+        "insights-reference://all",
+        "targeting-reference://all",
+        "tool-examples://meta-mcp/all",
+    ],
+    startHere: "meta_list_ad_accounts",
+});
+export const allResources = [
+    entityHierarchyResource,
+    entitySchemaAllResource,
+    ...entitySchemaResources,
+    entityExampleAllResource,
+    ...entityExampleResources,
+    insightsReferenceResource,
+    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,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,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,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,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,UAAU,CAAC,CAAC;AAC9E,MAAM,0BAA0B,GAAG,gCAAgC,CAAC;IAClE,UAAU,EAAE,UAAU;IACtB,QAAQ;IACR,UAAU,EAAE;QACV,OAAO,EAAE,CAAC,uBAAuB,CAAC;QAClC,IAAI,EAAE;YACJ,oBAAoB;YACpB,iBAAiB;YACjB,oBAAoB;YACpB,oBAAoB;YACpB,oBAAoB;SACrB;QACD,QAAQ,EAAE;YACR,mBAAmB;YACnB,8BAA8B;YAC9B,4BAA4B;YAC5B,wBAAwB;SACzB;QACD,SAAS,EAAE,CAAC,oBAAoB,EAAE,0BAA0B,EAAE,sBAAsB,CAAC;QACrF,IAAI,EAAE;YACJ,yBAAyB;YACzB,2BAA2B;YAC3B,2BAA2B;YAC3B,kBAAkB;SACnB;QACD,SAAS,EAAE,CAAC,uBAAuB,EAAE,4BAA4B,CAAC;QAClE,KAAK,EAAE,CAAC,mBAAmB,EAAE,mBAAmB,CAAC;QACjD,eAAe,EAAE,CAAC,6BAA6B,CAAC;QAChD,WAAW,EAAE,CAAC,uBAAuB,EAAE,4BAA4B,EAAE,qBAAqB,CAAC;QAC3F,UAAU,EAAE,CAAC,sBAAsB,CAAC;QACpC,SAAS,EAAE,CAAC,mBAAmB,CAAC;KACjC;IACD,eAAe,EAAE;QACf,8BAA8B;QAC9B,sBAAsB;QACtB,oBAAoB;QACpB,iBAAiB;KAClB;IACD,aAAa,EAAE;QACb,4EAA4E;QAC5E,gEAAgE;QAChE,oFAAoF;QACpF,sEAAsE;QACtE,gFAAgF;QAChF,kFAAkF;KACnF;IACD,gBAAgB,EAAE;QAChB,wBAAwB;QACxB,qBAAqB;QACrB,uBAAuB;QACvB,0BAA0B;QAC1B,2BAA2B;QAC3B,8BAA8B;KAC/B;IACD,SAAS,EAAE,uBAAuB;CACnC,CAAC,CAAC;AAKH,MAAM,CAAC,MAAM,YAAY,GAAe;IACtC,uBAAuB;IACvB,uBAAuB;IACvB,GAAG,qBAAqB;IACxB,wBAAwB;IACxB,GAAG,sBAAsB;IACzB,yBAAyB;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/insights-reference.resource.d.ts

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

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

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