mcp-linkedin-ads 1.1.1 → 1.1.2

package/dist/build-info.json

@@ -1 +1 @@
-{"sha":"acbfeb9","builtAt":"2026-04-18T18:10:49.640Z"}
+{"sha":"eb446cf","builtAt":"2026-05-08T18:24:15.904Z"}

package/dist/index.js

@@ -4,17 +4,18 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
 import { readFileSync, existsSync } from "fs";
 import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+const __dirname = dirname(fileURLToPath(import.meta.url));
 import { LinkedInAdsAuthError, classifyError, validateCredentials, } from "./errors.js";
 import { tools } from "./tools.js";
 import { filterTools, assertWriteAllowed, isWriteEnabled } from "./writeGate.js";
 import { withResilience, safeResponse, logger } from "./resilience.js";
 import v8 from "v8";
 // CLI package info
-const __cliPkg = JSON.parse(readFileSync(join(dirname(new URL(import.meta.url).pathname), "..", "package.json"), "utf-8"));
+const __cliPkg = JSON.parse(readFileSync(join(__dirname, "..", "package.json"), "utf-8"));
 // Log build fingerprint at startup
 try {
-    const __buildInfoDir = dirname(new URL(import.meta.url).pathname);
-    const buildInfo = JSON.parse(readFileSync(join(__buildInfoDir, "build-info.json"), "utf-8"));
+    const buildInfo = JSON.parse(readFileSync(join(__dirname, "build-info.json"), "utf-8"));
     console.error(`[build] SHA: ${buildInfo.sha} (${buildInfo.builtAt})`);
 }
 catch {
@@ -60,7 +61,7 @@ if (heapLimit < 256 * 1024 * 1024) {
 // ============================================
 const envTrimmed = (key) => (process.env[key] || "").trim().replace(/^["']|["']$/g, "");
 function loadConfig() {
-    const configPath = join(dirname(new URL(import.meta.url).pathname), "..", "config.json");
+    const configPath = join(__dirname, "..", "config.json");
     if (!existsSync(configPath)) {
         throw new Error(`Config file not found at ${configPath}. Create config.json from config.example.json with your client entries, ` +
             `or set env vars LINKEDIN_ACCESS_TOKEN, LINKEDIN_ADS_REFRESH_TOKEN, linkedin-client-id, and linkedin-client-secret. ` +
@@ -76,6 +77,23 @@ function getClientFromWorkingDir(config, cwd) {
     }
     return null;
 }
+// Add derived `frequency` (impressions / approximateMemberReach) to each
+// analytics element when both fields are present. approximateMemberReach is
+// only populated by the LinkedIn API at certain pivots (CAMPAIGN, CREATIVE,
+// CAMPAIGN_GROUP); at pivot=ACCOUNT it returns 0, in which case frequency is
+// omitted rather than reported as Infinity.
+function enrichAnalyticsResponse(raw) {
+    if (!raw || !Array.isArray(raw.elements))
+        return raw;
+    for (const el of raw.elements) {
+        const reach = Number(el?.approximateMemberReach ?? 0);
+        const impr = Number(el?.impressions ?? 0);
+        if (reach > 0 && impr > 0) {
+            el.frequency = +(impr / reach).toFixed(4);
+        }
+    }
+    return raw;
+}
 // ============================================
 // LINKEDIN MARKETING API CLIENT
 // ============================================
@@ -225,7 +243,7 @@ class LinkedInAdsManager {
         const statuses = options?.status || ["ACTIVE", "PAUSED"];
         const statusList = `List(${statuses.join(",")})`;
         let searchParams = `(status:(values:${statusList}))`;
-        let url = `${this.config.api.base_url}/adAccounts/${accountId}/adCampaigns?q=search&search=${encodeURIComponent(searchParams)}&count=100`;
+        let url = `${this.config.api.base_url}/adAccounts/${accountId}/adCampaigns?q=search&search=${searchParams}&count=100`;
         if (options?.campaignGroupId) {
             url += `&search.campaignGroup.values=List(urn%3Ali%3AsponsoredCampaignGroup%3A${options.campaignGroupId})`;
         }
@@ -247,12 +265,18 @@ class LinkedInAdsManager {
             "oneClickLeads", "oneClickLeadFormOpens",
             "externalWebsiteConversions", "externalWebsitePostClickConversions",
             "totalEngagements", "videoViews", "videoCompletions",
+            "approximateMemberReach",
             "dateRange", "pivotValues",
         ];
+        // LinkedIn Restli quirk (verified against /rest/adAnalytics with
+        // LinkedIn-Version 202602): dateRange value must use literal
+        // parens/colons/commas — percent-encoding them returns 400 PARAM_INVALID.
+        // The URN inside accounts=List(...) MUST be percent-encoded, but the
+        // List() wrapper itself stays literal. fields uses literal commas.
         const accountUrn = encodeURIComponent(`urn:li:sponsoredAccount:${options.accountId}`);
         let url = `${this.config.api.base_url}/adAnalytics?q=analytics` +
             `&pivot=${options.pivot}` +
-            `&dateRange=${encodeURIComponent(dateRange)}` +
+            `&dateRange=${dateRange}` +
             `&timeGranularity=${granularity}` +
             `&accounts=List(${accountUrn})` +
             `&fields=${fields.join(",")}`;
@@ -268,7 +292,8 @@ class LinkedInAdsManager {
                 .join(",");
             url += `&campaignGroups=List(${urns})`;
         }
-        return await this.apiGetRaw(url);
+        const raw = await this.apiGetRaw(url);
+        return enrichAnalyticsResponse(raw);
     }
     async getCampaignPerformance(accountId, options) {
         return await this.getAnalytics({

package/dist/tools.js

@@ -56,7 +56,7 @@ export const tools = [
     },
     {
         name: "linkedin_ads_campaign_performance",
-        description: "Get campaign-level performance metrics (impressions, clicks, spend, conversions, leads, engagement, video views) for a date range. This is the main reporting tool for weekly slides.",
+        description: "Get campaign-level performance metrics (impressions, clicks, spend, conversions, leads, engagement, video views, reach, frequency) for a date range. Reach = approximateMemberReach (unique members exposed); frequency = impressions / reach (computed server-side). This is the main reporting tool for weekly slides.",
         inputSchema: {
             additionalProperties: false,
             type: "object",
@@ -71,7 +71,7 @@ export const tools = [
     },
     {
         name: "linkedin_ads_account_performance",
-        description: "Get account-level aggregate performance metrics for a date range. Good for high-level summaries.",
+        description: "Get account-level aggregate performance metrics for a date range. Good for high-level summaries. Note: reach (approximateMemberReach) and the derived frequency field are not populated at pivot=ACCOUNT; query at CAMPAIGN/CAMPAIGN_GROUP via linkedin_ads_campaign_performance or linkedin_ads_analytics if you need reach.",
         inputSchema: {
             additionalProperties: false,
             type: "object",
@@ -102,7 +102,7 @@ export const tools = [
                 fields: {
                     type: "array",
                     items: { type: "string" },
-                    description: "Metrics to return. Default: impressions, clicks, costInLocalCurrency, landingPageClicks, oneClickLeads, externalWebsiteConversions, totalEngagements, videoViews, dateRange, pivotValues",
+                    description: "Metrics to return. Default: impressions, clicks, costInLocalCurrency, landingPageClicks, oneClickLeads, oneClickLeadFormOpens, externalWebsiteConversions, externalWebsitePostClickConversions, totalEngagements, videoViews, videoCompletions, approximateMemberReach, dateRange, pivotValues. The server adds a derived `frequency` field (impressions / approximateMemberReach) when both are non-zero. Reach is only populated at pivots CAMPAIGN, CREATIVE, and CAMPAIGN_GROUP — it returns 0 at pivot=ACCOUNT.",
                 },
                 campaign_ids: { type: "array", items: { type: "string" }, description: "Filter by numeric string campaign IDs" },
                 campaign_group_ids: { type: "array", items: { type: "string" }, description: "Filter by campaign group IDs" },

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mcp-linkedin-ads",
   "mcpName": "io.github.mharnett/linkedin-ads",
-  "version": "1.1.1",
+  "version": "1.1.2",
   "description": "MCP server for LinkedIn Campaign Manager API with full campaign, ad group, creative, and targeting support. Production-proven with 65+ campaigns under active management.",
   "main": "dist/index.js",
   "bin": {
@@ -25,7 +25,8 @@
     "build": "tsc && node -e \"fs=require('fs');cp=require('child_process');sha=cp.execSync('git rev-parse --short HEAD 2>/dev/null||echo unknown').toString().trim();fs.writeFileSync('dist/build-info.json',JSON.stringify({sha,builtAt:new Date().toISOString()}))\"",
     "start": "node dist/index.js",
     "dev": "tsx src/index.ts",
-    "test": "vitest run"
+    "test": "vitest run",
+    "smoke": "scripts/healthcheck.sh"
   },
   "keywords": [
     "mcp",