@cesteral/linkedin-mcp 1.0.0

package/dist/mcp-server/resources/definitions/analytics-reference.resource.js

@@ -0,0 +1,162 @@
+let cachedContent;
+function formatAnalyticsReferenceMarkdown() {
+    return `# LinkedIn Ads Analytics Reference
+
+## Endpoint
+\`GET /v2/adAnalytics\`
+
+## Required Parameters
+
+| Parameter | Description | Example |
+|-----------|-------------|---------|
+| q | Query type | \`analytics\` |
+| pivot | Dimension to aggregate by | \`CAMPAIGN\` |
+| timeGranularity | Time bucket size | \`DAILY\` |
+| accounts[0] | Ad account URN | \`urn:li:sponsoredAccount:123\` |
+| dateRange.start.year | Start year | \`2026\` |
+| dateRange.start.month | Start month (1-12) | \`1\` |
+| dateRange.start.day | Start day | \`1\` |
+| dateRange.end.year | End year | \`2026\` |
+| dateRange.end.month | End month (1-12) | \`3\` |
+| dateRange.end.day | End day | \`31\` |
+| fields | Comma-separated metrics | \`impressions,clicks,costInUsd\` |
+
+## Available Metrics
+
+### Volume Metrics
+| Metric | Description |
+|--------|-------------|
+| impressions | Total ad impressions |
+| clicks | Total clicks |
+| costInUsd | Total spend in USD |
+| reach | Unique users reached |
+| frequency | Average impressions per user |
+
+### Engagement Metrics
+| Metric | Description |
+|--------|-------------|
+| likes | Post likes |
+| comments | Post comments |
+| shares | Post shares |
+| follows | New followers |
+| companyPageClicks | Clicks to company page |
+
+### Video Metrics
+| Metric | Description |
+|--------|-------------|
+| videoViews | Total video plays |
+| videoCompletions | Videos watched to completion |
+| videoFirstQuartileCompletions | 25% completion |
+| videoMidpointCompletions | 50% completion |
+| videoThirdQuartileCompletions | 75% completion |
+| videoStarted | Video play starts |
+
+### Conversion Metrics
+| Metric | Description |
+|--------|-------------|
+| conversions | Total conversion events |
+| externalWebsiteConversions | Website conversion events |
+| leadGenerationMailContactInfoShares | Lead Gen Form submits |
+| oneClickLeads | One-click lead conversions |
+| costPerConversion | Average cost per conversion |
+
+### Calculated Metrics
+| Metric | Description |
+|--------|-------------|
+| clickThroughRate | CTR (clicks / impressions) |
+| averageDailyReach | Average daily unique reach |
+| viralImpressions | Viral (unpaid) impressions |
+| viralClicks | Viral clicks |
+
+## Available Pivots
+
+| Pivot | Description |
+|-------|-------------|
+| CAMPAIGN | Per campaign aggregation |
+| CAMPAIGN_GROUP | Per campaign group aggregation |
+| CREATIVE | Per creative aggregation |
+| CONVERSION | Per conversion rule aggregation |
+| MEMBER_COMPANY_SIZE | By company size segment |
+| MEMBER_INDUSTRY | By industry segment |
+| MEMBER_SENIORITY | By seniority level |
+| MEMBER_JOB_TITLE | By job title |
+| MEMBER_JOB_FUNCTION | By job function |
+| MEMBER_COUNTRY | By country |
+| MEMBER_REGION | By region |
+| MEMBER_COMPANY | By company |
+| PLACEMENT_NAME | By ad placement (feed, right rail, etc.) |
+
+## Time Granularity Values
+
+| Value | Description |
+|-------|-------------|
+| DAILY | One row per day |
+| MONTHLY | One row per month |
+| YEARLY | One row per year |
+| ALL | Aggregate entire date range |
+
+## Date Range Format
+
+Dates are specified as year/month/day integers:
+\`\`\`
+dateRange.start.year=2026
+dateRange.start.month=1
+dateRange.start.day=1
+dateRange.end.year=2026
+dateRange.end.month=3
+dateRange.end.day=31
+\`\`\`
+
+## Example: Get Daily Campaign Metrics
+
+\`\`\`
+GET /v2/adAnalytics?
+  q=analytics&
+  pivot=CAMPAIGN&
+  timeGranularity=DAILY&
+  accounts[0]=urn:li:sponsoredAccount:123456789&
+  dateRange.start.year=2026&
+  dateRange.start.month=1&
+  dateRange.start.day=1&
+  dateRange.end.year=2026&
+  dateRange.end.month=3&
+  dateRange.end.day=31&
+  fields=impressions,clicks,costInUsd,conversions
+\`\`\`
+
+## Response Shape
+
+\`\`\`json
+{
+  "elements": [
+    {
+      "dateRange": {
+        "start": { "year": 2026, "month": 1, "day": 1 },
+        "end": { "year": 2026, "month": 1, "day": 1 }
+      },
+      "pivotValues": ["urn:li:sponsoredCampaign:111222333"],
+      "impressions": 12500,
+      "clicks": 342,
+      "costInUsd": "45.67"
+    }
+  ],
+  "paging": {
+    "count": 100,
+    "start": 0,
+    "total": 450
+  }
+}
+\`\`\`
+`;
+}
+export const analyticsReferenceResource = {
+    uri: "analytics-reference://linkedin",
+    name: "LinkedIn Analytics Reference",
+    description: "Available metrics, pivot dimensions, date formats, and examples for LinkedIn adAnalytics API",
+    mimeType: "text/markdown",
+    getContent: () => {
+        cachedContent ??= formatAnalyticsReferenceMarkdown();
+        return cachedContent;
+    },
+};
+//# sourceMappingURL=analytics-reference.resource.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-reference.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/analytics-reference.resource.ts"],"names":[],"mappings":"AASA,IAAI,aAAiC,CAAC;AAEtC,SAAS,gCAAgC;IACvC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmJR,CAAC;AACF,CAAC;AAED,MAAM,CAAC,MAAM,0BAA0B,GAAa;IAClD,GAAG,EAAE,gCAAgC;IACrC,IAAI,EAAE,8BAA8B;IACpC,WAAW,EACT,8FAA8F;IAChG,QAAQ,EAAE,eAAe;IACzB,UAAU,EAAE,GAAG,EAAE;QACf,aAAa,KAAK,gCAAgC,EAAE,CAAC;QACrD,OAAO,aAAa,CAAC;IACvB,CAAC;CACF,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":"AAOA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAiK5C,eAAO,MAAM,sBAAsB,EAAE,QAAQ,EACW,CAAC;AAEzD,eAAO,MAAM,wBAAwB,EAAE,QAStC,CAAC"}

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

@@ -0,0 +1,164 @@
+const ENTITY_EXAMPLES = {
+    campaignGroup: `# LinkedIn Campaign Group Examples
+
+## Create a Campaign Group
+
+\`\`\`json
+{
+  "entityType": "campaignGroup",
+  "data": {
+    "name": "Q1 2026 Brand Awareness",
+    "account": "urn:li:sponsoredAccount:123456789",
+    "status": "DRAFT",
+    "totalBudget": { "amount": "5000.00", "currencyCode": "USD" },
+    "runSchedule": {
+      "start": 1735689600000,
+      "end": 1748476800000
+    }
+  }
+}
+\`\`\`
+
+## Pause a Campaign Group
+
+\`\`\`json
+{
+  "entityType": "campaignGroup",
+  "entityUrn": "urn:li:sponsoredCampaignGroup:987654321",
+  "data": { "status": "PAUSED" }
+}
+\`\`\`
+`,
+    campaign: `# LinkedIn Campaign Examples
+
+## Create a Sponsored Content Campaign
+
+\`\`\`json
+{
+  "entityType": "campaign",
+  "data": {
+    "name": "LinkedIn Tech Leaders Campaign",
+    "campaignGroup": "urn:li:sponsoredCampaignGroup:987654321",
+    "account": "urn:li:sponsoredAccount:123456789",
+    "type": "SPONSORED_UPDATES",
+    "objectiveType": "BRAND_AWARENESS",
+    "status": "DRAFT",
+    "dailyBudget": { "amount": "100.00", "currencyCode": "USD" },
+    "bidType": "CPM",
+    "unitCost": { "amount": "12.00", "currencyCode": "USD" },
+    "runSchedule": {
+      "start": 1735689600000,
+      "end": 1748476800000
+    },
+    "targetingCriteria": {
+      "include": {
+        "and": [
+          {
+            "or": {
+              "urn:li:adTargetingFacet:geos": [
+                "urn:li:geo:103644278"
+              ]
+            }
+          },
+          {
+            "or": {
+              "urn:li:adTargetingFacet:memberSeniorities": [
+                "urn:li:adSeniority:5",
+                "urn:li:adSeniority:6"
+              ]
+            }
+          }
+        ]
+      }
+    },
+    "locale": {
+      "country": "US",
+      "language": "en"
+    }
+  }
+}
+\`\`\`
+
+## Create a Lead Gen Campaign
+
+\`\`\`json
+{
+  "entityType": "campaign",
+  "data": {
+    "name": "Lead Generation - IT Decision Makers",
+    "campaignGroup": "urn:li:sponsoredCampaignGroup:987654321",
+    "account": "urn:li:sponsoredAccount:123456789",
+    "type": "SPONSORED_UPDATES",
+    "objectiveType": "LEAD_GENERATION",
+    "status": "DRAFT",
+    "dailyBudget": { "amount": "200.00", "currencyCode": "USD" },
+    "bidType": "CPC",
+    "unitCost": { "amount": "8.00", "currencyCode": "USD" }
+  }
+}
+\`\`\`
+`,
+    creative: `# LinkedIn Creative Examples
+
+## Create a Sponsored Content Creative
+
+\`\`\`json
+{
+  "entityType": "creative",
+  "data": {
+    "campaign": "urn:li:sponsoredCampaign:111222333",
+    "status": "DRAFT",
+    "reference": "urn:li:ugcPost:123456789",
+    "type": "SPONSORED_STATUS_UPDATE"
+  }
+}
+\`\`\`
+`,
+    conversionRule: `# LinkedIn Conversion Rule Examples
+
+## Create a Purchase Conversion Rule
+
+\`\`\`json
+{
+  "entityType": "conversionRule",
+  "data": {
+    "name": "Product Purchase",
+    "type": "PURCHASE",
+    "account": "urn:li:sponsoredAccount:123456789",
+    "status": "ACTIVE",
+    "urlRules": [
+      {
+        "expression": "https://example.com/thank-you",
+        "matchType": "EXACT_URL"
+      }
+    ],
+    "value": { "amount": "100.00", "currencyCode": "USD" },
+    "attributionWindow": {
+      "clickAttribution": "30_DAY",
+      "viewAttribution": "7_DAY"
+    }
+  }
+}
+\`\`\`
+`,
+};
+function buildExampleResource(entityType) {
+    return {
+        uri: `entity-examples://linkedin/${entityType}`,
+        name: `LinkedIn ${entityType} Examples`,
+        description: `Example payloads for creating and updating LinkedIn ${entityType} entities`,
+        mimeType: "text/markdown",
+        getContent: () => ENTITY_EXAMPLES[entityType] ?? `# ${entityType} Examples\n\nNo examples available.`,
+    };
+}
+export const entityExampleResources = Object.keys(ENTITY_EXAMPLES).map(buildExampleResource);
+export const entityExampleAllResource = {
+    uri: "entity-examples://linkedin/all",
+    name: "LinkedIn All Entity Examples",
+    description: "Example payloads for all LinkedIn Ads entity types",
+    mimeType: "text/markdown",
+    getContent: () => Object.entries(ENTITY_EXAMPLES)
+        .map(([, content]) => content)
+        .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":"AASA,MAAM,eAAe,GAA2B;IAC9C,aAAa,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6BhB;IAEC,QAAQ,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoEX;IAEC,QAAQ,EAAE;;;;;;;;;;;;;;;CAeX;IAEC,cAAc,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;CA0BjB;CACA,CAAC;AAEF,SAAS,oBAAoB,CAAC,UAAkB;IAC9C,OAAO;QACL,GAAG,EAAE,8BAA8B,UAAU,EAAE;QAC/C,IAAI,EAAE,YAAY,UAAU,WAAW;QACvC,WAAW,EAAE,uDAAuD,UAAU,WAAW;QACzF,QAAQ,EAAE,eAAe;QACzB,UAAU,EAAE,GAAG,EAAE,CACf,eAAe,CAAC,UAAU,CAAC,IAAI,KAAK,UAAU,qCAAqC;KACtF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,sBAAsB,GACjC,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;AAEzD,MAAM,CAAC,MAAM,wBAAwB,GAAa;IAChD,GAAG,EAAE,gCAAgC;IACrC,IAAI,EAAE,8BAA8B;IACpC,WAAW,EAAE,oDAAoD;IACjE,QAAQ,EAAE,eAAe;IACzB,UAAU,EAAE,GAAG,EAAE,CACf,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC;SAC5B,GAAG,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC;SAC7B,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;AAyI5C,eAAO,MAAM,uBAAuB,EAAE,QAUrC,CAAC"}

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

@@ -0,0 +1,144 @@
+let cachedContent;
+function formatEntityHierarchyMarkdown() {
+    return `# LinkedIn Ads Entity Hierarchy
+
+## Relationship Diagram
+
+\`\`\`
+Ad Account (urn:li:sponsoredAccount:XXXXXXXXX)
+  ├── Campaign Group (urn:li:sponsoredCampaignGroup:XXXXXXXXX)
+  │     └── Campaign (urn:li:sponsoredCampaign:XXXXXXXXX)
+  │           └── Creative (urn:li:sponsoredCreative:XXXXXXXXX)
+  └── Conversion Rule (urn:li:conversion:XXXXXXXXX)
+\`\`\`
+
+## Entity Types (5 total)
+
+| Entity Type | API Path | Display Name |
+|-------------|----------|--------------|
+| **adAccount** | \`/v2/adAccounts\` | Ad Account |
+| **campaignGroup** | \`/v2/adCampaignGroups\` | Campaign Group |
+| **campaign** | \`/v2/adCampaigns\` | Campaign |
+| **creative** | \`/v2/adCreatives\` | Creative |
+| **conversionRule** | \`/v2/conversions\` | Conversion Rule |
+
+## Key Concepts
+
+### LinkedIn URN IDs
+All LinkedIn entity IDs are URNs (Uniform Resource Names):
+- Ad Account: \`urn:li:sponsoredAccount:123456789\`
+- Campaign Group: \`urn:li:sponsoredCampaignGroup:987654321\`
+- Campaign: \`urn:li:sponsoredCampaign:111222333\`
+- Creative: \`urn:li:sponsoredCreative:444555666\`
+- Conversion Rule: \`urn:li:conversion:777888999\`
+
+URNs must be URL-encoded when used in API paths:
+\`urn:li:sponsoredAccount:123\` → \`urn%3Ali%3AsponsoredAccount%3A123\`
+
+### Core Hierarchy: Account → Campaign Group → Campaign → Creative
+- A campaign group organizes campaigns (like Facebook campaign)
+- A campaign contains targeting, bidding, and budget (like Facebook ad set)
+- A creative is the ad content associated with a campaign
+
+## Creation Order
+
+1. **Ad Account** — pre-exists; use \`linkedin_list_ad_accounts\` to find URN
+2. **Conversion Rule(s)** — optional; create if tracking conversions
+3. **Campaign Group** — requires \`account\` URN, \`name\`, \`status\`
+4. **Campaign(s)** — requires \`campaignGroup\` URN, \`account\` URN, \`type\`, \`objectiveType\`
+5. **Creative(s)** — requires \`campaign\` URN, \`reference\` content URN
+
+## LinkedIn API Patterns
+
+### Create: POST /v2/{entityPath}
+Body is JSON. Response contains the new entity URN.
+
+### Read: GET /v2/{entityPath}/{encodedUrn}
+URN must be URL-encoded in path.
+
+### Update: POST /v2/{entityPath}/{encodedUrn} with X-Restli-Method: PARTIAL_UPDATE
+Body: \`{ "patch": { "$set": { ...fields } } }\`
+
+### Delete: DELETE /v2/{entityPath}/{encodedUrn}
+
+### List: GET /v2/{entityPath}?q=search&{scopingParam}={accountUrn}&start={n}&count={n}
+Offset-based pagination via \`start\` and \`count\` parameters.
+Response contains \`elements\` array and \`paging\` object.
+
+The account scoping parameter varies by entity type:
+- \`accounts[0]\` — campaigns (\`/v2/adCampaigns\`) and creatives (\`/v2/adCreatives\`)
+- \`account\` — campaign groups (\`/v2/adCampaignGroups\`) and conversion rules (\`/v2/conversions\`)
+
+## Required Headers (All Requests)
+
+| Header | Value |
+|--------|-------|
+| Authorization | Bearer {access_token} |
+| LinkedIn-Version | 202409 (configurable via LINKEDIN_API_VERSION) |
+| X-Restli-Protocol-Version | 2.0.0 |
+
+## Available Tools Summary
+
+| Tool | Purpose | Batch? |
+|------|---------|--------|
+| \`linkedin_list_entities\` | List entities with offset pagination | |
+| \`linkedin_get_entity\` | Get single entity by URN | |
+| \`linkedin_create_entity\` | Create single entity | |
+| \`linkedin_update_entity\` | Update single entity (PATCH) | |
+| \`linkedin_delete_entity\` | Delete single entity | |
+| \`linkedin_list_ad_accounts\` | List accessible ad accounts | |
+| \`linkedin_get_analytics\` | Get analytics metrics | |
+| \`linkedin_get_analytics_breakdowns\` | Analytics with multiple pivots | |
+| \`linkedin_bulk_update_status\` | Batch status update | ✓ |
+| \`linkedin_bulk_create_entities\` | Batch entity creation | ✓ |
+| \`linkedin_bulk_update_entities\` | Batch entity updates | ✓ |
+| \`linkedin_adjust_bids\` | Batch adjust campaign bids | ✓ |
+| \`linkedin_search_targeting\` | Search targeting facets | |
+| \`linkedin_get_targeting_options\` | Browse targeting categories | |
+| \`linkedin_duplicate_entity\` | Copy entity (read + create) | |
+| \`linkedin_get_delivery_forecast\` | Audience size estimation | |
+| \`linkedin_get_ad_preview\` | Ad creative preview | |
+| \`linkedin_validate_entity\` | Client-side payload validation | |
+
+## Budget Format
+
+LinkedIn budgets use a CurrencyAmount object:
+\`\`\`json
+{ "amount": "50.00", "currencyCode": "USD" }
+\`\`\`
+
+## Campaign Types (type field)
+
+| Type | Description |
+|------|-------------|
+| SPONSORED_UPDATES | Sponsored content in the feed |
+| TEXT_AD | Text-based display ads |
+| DYNAMIC | Dynamic personalized ads |
+| SPONSORED_INMAILS | InMail / Message Ads |
+| VIDEO | Video ads |
+| CAROUSEL | Carousel ads |
+
+## Objective Types (objectiveType field)
+
+| Objective | Use Case |
+|-----------|----------|
+| BRAND_AWARENESS | Maximize reach and impressions |
+| WEBSITE_TRAFFIC | Drive clicks to website |
+| WEBSITE_CONVERSIONS | Optimize for conversion events |
+| LEAD_GENERATION | LinkedIn Lead Gen Forms |
+| ENGAGEMENT | Increase social engagement |
+| VIDEO_VIEWS | Maximize video completions |
+| TALENT_LEADS | Talent solution objectives |
+`;
+}
+export const entityHierarchyResource = {
+    uri: "entity-hierarchy://linkedin/all",
+    name: "LinkedIn Ads Entity Hierarchy",
+    description: "Parent-child relationships between LinkedIn 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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiIR,CAAC;AACF,CAAC;AAED,MAAM,CAAC,MAAM,uBAAuB,GAAa;IAC/C,GAAG,EAAE,iCAAiC;IACtC,IAAI,EAAE,+BAA+B;IACrC,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":"AAOA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AA4H5C,eAAO,MAAM,qBAAqB,EAAE,QAAQ,EACU,CAAC;AAEvD,eAAO,MAAM,uBAAuB,EAAE,QASrC,CAAC"}

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

@@ -0,0 +1,127 @@
+const ENTITY_SCHEMAS = {
+    adAccount: `# LinkedIn Ad Account Schema
+
+## Key Fields
+
+| Field | Type | Description |
+|-------|------|-------------|
+| id | number | Account ID (part of URN) |
+| name | string | Account name |
+| status | string | ACTIVE, CANCELED, DRAFT, PENDING_DELETION |
+| currency | string | ISO 4217 currency code (e.g., USD) |
+| type | string | BUSINESS, ENTERPRISE |
+| reference | string | Company URN reference |
+
+## Read-Only Fields
+- id, changeAuditStamps, created, lastModified
+
+## Status Values
+ACTIVE, CANCELED, DRAFT, PENDING_DELETION
+`,
+    campaignGroup: `# LinkedIn Campaign Group Schema
+
+## Key Fields
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| name | string | Yes | Campaign group name |
+| account | string | Yes | Ad account URN |
+| status | string | Yes | ACTIVE, PAUSED, DRAFT, ARCHIVED, CANCELED |
+| totalBudget | CurrencyAmount | No | Total budget cap |
+| runSchedule | DateRange | No | Start/end timestamps (ms) |
+| backfilled | boolean | No | Whether created via migration |
+
+## CurrencyAmount Object
+\`\`\`json
+{ "amount": "500.00", "currencyCode": "USD" }
+\`\`\`
+
+## DateRange Object
+\`\`\`json
+{ "start": 1735689600000, "end": 1748476800000 }
+\`\`\`
+(Unix timestamps in milliseconds)
+`,
+    campaign: `# LinkedIn Campaign Schema
+
+## Key Fields
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| name | string | Yes | Campaign name |
+| campaignGroup | string | Yes | Campaign group URN |
+| account | string | Yes | Ad account URN |
+| type | string | Yes | SPONSORED_UPDATES, TEXT_AD, DYNAMIC, etc. |
+| objectiveType | string | Yes | BRAND_AWARENESS, WEBSITE_TRAFFIC, etc. |
+| status | string | Yes | ACTIVE, PAUSED, DRAFT, ARCHIVED, CANCELED |
+| dailyBudget | CurrencyAmount | No | Daily spending limit |
+| totalBudget | CurrencyAmount | No | Total campaign budget |
+| bidType | string | No | CPM, CPC, CPS, AUTOMATED |
+| unitCost | CurrencyAmount | No | Bid amount (used when bidType is CPM/CPC) |
+| runSchedule | DateRange | No | Start/end timestamps (ms) |
+| targetingCriteria | object | No | Audience targeting definition |
+| locale | object | No | Language and country for targeting |
+
+## Campaign Types
+SPONSORED_UPDATES, TEXT_AD, DYNAMIC, SPONSORED_INMAILS, VIDEO, CAROUSEL
+
+## Objective Types
+BRAND_AWARENESS, WEBSITE_TRAFFIC, WEBSITE_CONVERSIONS, LEAD_GENERATION,
+ENGAGEMENT, VIDEO_VIEWS, TALENT_LEADS
+`,
+    creative: `# LinkedIn Creative Schema
+
+## Key Fields
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| campaign | string | Yes | Campaign URN |
+| status | string | Yes | ACTIVE, PAUSED, DRAFT, ARCHIVED, CANCELED |
+| reference | string | Yes | Content reference URN (UGC post, share, etc.) |
+| type | string | No | TEXT_AD, SPONSORED_STATUS_UPDATE, etc. |
+| variables | object | No | Template variables for dynamic content |
+| review | object | No | Review status (read-only) |
+
+## Reference URN Formats
+- UGC post: \`urn:li:ugcPost:123456789\`
+- Share: \`urn:li:share:123456789\`
+- Article: \`urn:li:article:123456789\`
+`,
+    conversionRule: `# LinkedIn Conversion Rule Schema
+
+## Key Fields
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| name | string | Yes | Conversion rule name |
+| type | string | Yes | PURCHASE, ADD_TO_CART, DOWNLOAD, SIGN_UP, etc. |
+| account | string | Yes | Ad account URN |
+| status | string | Yes | ACTIVE, PAUSED |
+| urlRules | array | No | URL matching rules |
+| value | CurrencyAmount | No | Monetary value of conversion |
+| attributionWindow | object | No | Click/view attribution window settings |
+
+## Conversion Types
+PURCHASE, ADD_TO_CART, DOWNLOAD, SIGN_UP, LEAD, VIEW_KEY_PAGE, JOB_APPLICANT, OTHER
+`,
+};
+function buildSchemaResource(entityType) {
+    return {
+        uri: `entity-schema://linkedin/${entityType}`,
+        name: `LinkedIn ${entityType} Schema`,
+        description: `Field reference for LinkedIn ${entityType} entities`,
+        mimeType: "text/markdown",
+        getContent: () => ENTITY_SCHEMAS[entityType] ?? `# ${entityType}\n\nNo schema available.`,
+    };
+}
+export const entitySchemaResources = Object.keys(ENTITY_SCHEMAS).map(buildSchemaResource);
+export const entitySchemaAllResource = {
+    uri: "entity-schema://linkedin/all",
+    name: "LinkedIn All Entity Schemas",
+    description: "Field references for all LinkedIn Ads entity types",
+    mimeType: "text/markdown",
+    getContent: () => Object.entries(ENTITY_SCHEMAS)
+        .map(([, content]) => content)
+        .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,MAAM,cAAc,GAA2B;IAC7C,SAAS,EAAE;;;;;;;;;;;;;;;;;;CAkBZ;IAEC,aAAa,EAAE;;;;;;;;;;;;;;;;;;;;;;;CAuBhB;IAEC,QAAQ,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;CA0BX;IAEC,QAAQ,EAAE;;;;;;;;;;;;;;;;;CAiBX;IAEC,cAAc,EAAE;;;;;;;;;;;;;;;;CAgBjB;CACA,CAAC;AAEF,SAAS,mBAAmB,CAAC,UAAkB;IAC7C,OAAO;QACL,GAAG,EAAE,4BAA4B,UAAU,EAAE;QAC7C,IAAI,EAAE,YAAY,UAAU,SAAS;QACrC,WAAW,EAAE,gCAAgC,UAAU,WAAW;QAClE,QAAQ,EAAE,eAAe;QACzB,UAAU,EAAE,GAAG,EAAE,CAAC,cAAc,CAAC,UAAU,CAAC,IAAI,KAAK,UAAU,0BAA0B;KAC1F,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,qBAAqB,GAChC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;AAEvD,MAAM,CAAC,MAAM,uBAAuB,GAAa;IAC/C,GAAG,EAAE,8BAA8B;IACnC,IAAI,EAAE,6BAA6B;IACnC,WAAW,EAAE,oDAAoD;IACjE,QAAQ,EAAE,eAAe;IACzB,UAAU,EAAE,GAAG,EAAE,CACf,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC;SAC3B,GAAG,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,OAAO,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 { analyticsReferenceResource } from "./analytics-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;AAoC5C,eAAO,MAAM,YAAY,EAAE,QAAQ,EAUlC,CAAC"}