# LinkedIn Campaign Manager (npm · linkedin-campaign-manager-mcp)

MCP server for LinkedIn Ads — 19 read-only tools for campaigns, performance, and Lead Gen Forms.

- Trust score: 61/100 (medium)
- Change this week: +26
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- npm · `linkedin-campaign-manager-mcp`: 61/100 (this document), [markdown](https://verifymcp.io/servers/zleventer-linkedin-campaign-manager-mcp/linkedin-campaign-manager-mcp.md), [page](https://verifymcp.io/servers/zleventer-linkedin-campaign-manager-mcp/linkedin-campaign-manager-mcp)

## Channel facts

- Registry: `npm`
- Package: `linkedin-campaign-manager-mcp`
- Version: `1.0.1`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Supply Chain Security**: 87/100
  - No malware found by supply-chain analysis.
  - Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree.
  - No install/post-install scripts declared.
  - Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 19/100
  - Repository check failed: the declared repository URL returned HTTP 404.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 97 days ago).
  - Security-disclosure policy not yet verified: we couldn't inspect the source repository.
- **Schema Quality & AI Usability**: 66/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 3216 tokens (~169/item across 19 items; 19 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 27/100
  - Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 85/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 54% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add zleventer-linkedin-campaign-manager-mcp -- npx -y linkedin-campaign-manager-mcp
```

### Codex

```bash
codex mcp add zleventer-linkedin-campaign-manager-mcp -- npx -y linkedin-campaign-manager-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "zleventer-linkedin-campaign-manager-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "linkedin-campaign-manager-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add zleventer-linkedin-campaign-manager-mcp --command npx --arg -y --arg linkedin-campaign-manager-mcp
```

### Hermes

```yaml
mcp_servers:
  zleventer-linkedin-campaign-manager-mcp:
    command: "npx"
    args: ["-y", "linkedin-campaign-manager-mcp"]
```

### Other

```json
{
  "mcpServers": {
    "zleventer-linkedin-campaign-manager-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "linkedin-campaign-manager-mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 61, +4)

- [functional improvement] Stability: unverified → 0.27

### 2026-08-02 (score 57, +45)

- [security regression] Provenance: unverified → fail
- [security improvement] Install scripts: unverified → pass
- [security improvement] Known CVEs: unverified → partial
- [security improvement] Malware scan: unverified → pass
- [security] Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window).
- [functional regression] Tool coverage: 100 → unverified
- [functional improvement] Schema quality: unverified → excellent
- [functional improvement] License: unverified → pass
- [functional improvement] Dependency health: unverified → partial
- [functional improvement] Maintenance: unverified → pass
- [functional improvement] MCP protocol: unverified → pass
- [functional] Licence: MIT

### 2026-07-31 (score 12, −23)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 35, +17)

- [functional improvement] Tool coverage: unverified → 100

### 2026-07-28 (score 18, −17)

- [functional regression] Tool coverage: 100 → unverified
- [functional] First check of Schema quality: unverified

### 2026-07-27 (score 35)

First indexed and scored.

## MCP tools (19)

### `li_list_ad_accounts` (~125 tokens)

List all LinkedIn ad accounts the authenticated user has access to. Returns account ID, name, status, currency, type (BUSINESS/ENTERPRISE), and reference organization URN. Use this first to discover the ad_account_id needed by other tools. Filter by status (ACTIVE/CANCELED/DRAFT/PENDING_DELETION/REMOVED) or omit to see all accounts.

Input parameters:

- `page_size` (integer): Number of results per page (max 100).
- `status` (string): Filter by ad account status. Omit to return accounts in all statuses.

### `li_get_account` (~118 tokens)

Get full details for a single LinkedIn ad account, including currency code, status, account type (BUSINESS/ENTERPRISE), total budget, billing info, and the associated organization URN. Useful for confirming account currency before interpreting spend data, or checking billing status before troubleshooting ad delivery issues.

Input parameters:

- `ad_account_id` (string): Ad account numeric ID or URN (urn:li:sponsoredAccount:123). Defaults to LINKEDIN_DEFAULT_AD_ACCOUNT. The numeric ID is visible in Campaign Manager URLs: /accounts/<id>/.

### `li_list_campaigns` (~163 tokens)

List campaigns in a LinkedIn ad account. Returns campaign name, status, objectiveType (WEBSITE_VISITS/LEAD_GENERATION/BRAND_AWARENESS/etc.), optimizationTargetType, bid amount, daily/total budget, run schedule, and targeting criteria summary. Filter by status or campaign_group_id. Use li_get_campaign for full targeting detail on a specific campaign.

Input parameters:

- `ad_account_id` (string): Ad account numeric ID or URN. Defaults to LINKEDIN_DEFAULT_AD_ACCOUNT.
- `campaign_group_id` (string): Filter to campaigns belonging to a specific campaign group (numeric ID or URN).
- `page_size` (integer)
- `status` (string): Filter by campaign status. Omit to return campaigns in all statuses.

### `li_get_campaign` (~129 tokens)

Get complete detail for a single LinkedIn campaign, including the full targetingCriteria object (all included/excluded facets), bid strategy, unit cost, daily/total budget, run schedule, objective, optimization target, format, and locale. Use this when you need to audit targeting setup, diagnose budget configuration, or confirm campaign structure before pulling performance data.

Input parameters:

- `ad_account_id` (string): Ad account numeric ID or URN. Defaults to LINKEDIN_DEFAULT_AD_ACCOUNT.
- `campaign_id` (string, required): Campaign numeric ID or URN (urn:li:sponsoredCampaign:123). Required.

### `li_list_campaign_groups` (~90 tokens)

List campaign groups in a LinkedIn ad account. Campaign groups are containers that group related campaigns under a shared name and optional total budget cap. Returns group name, status, total budget, run schedule, and the campaigns count. Use to understand account structure before pulling campaign-level data.

Input parameters:

- `ad_account_id` (string)
- `page_size` (integer)
- `status` (string)

### `li_list_creatives` (~133 tokens)

List ad creatives in a LinkedIn ad account. Returns creative content type (SPONSORED_STATUS_UPDATE/MESSAGE/etc.), intendedStatus, associated campaigns, and content URNs. Filter by campaign_id to see all creatives on a specific campaign, or by status to find paused/archived ads. Use li_get_creative for full content detail on a specific creative.

Input parameters:

- `ad_account_id` (string)
- `campaign_id` (string): Filter to creatives in a specific campaign (numeric ID or URN).
- `page_size` (integer)
- `status` (string): Filter by intendedStatus.

### `li_get_creative` (~136 tokens)

Get full detail for a single LinkedIn ad creative, including the creative content (headline, body copy, destination URL, image/video URNs, call-to-action label), intendedStatus, associated campaign URNs, and creative type. Use when auditing ad copy and creative assets, debugging a rejected creative, or pulling the landing page URL to cross-reference with GA4 UTM data.

Input parameters:

- `ad_account_id` (string): Ad account numeric ID or URN. Defaults to LINKEDIN_DEFAULT_AD_ACCOUNT.
- `creative_id` (string, required): Creative numeric ID or URN (urn:li:sponsoredCreative:123). Required.

### `li_get_campaign_performance` (~285 tokens)

Fetch performance metrics for LinkedIn campaigns over a date range. Returns impressions, clicks, spend (USD and local currency), website conversions, one-click lead form submissions, landing-page clicks, video views, follows, reactions, comments, and shares. Pass campaign_ids for specific campaigns or use ad_account_id for account-level totals. Supports DAILY/MONTHLY/YEARLY/ALL time granularity and CAMPAIGN/CAMPAIGN_GROUP/CREATIVE/ACCOUNT pivots. Default range: last 28 days.

Input parameters:

- `ad_account_id` (string): Ad account ID/URN. Used when campaign_ids is omitted. Defaults to LINKEDIN_DEFAULT_AD_ACCOUNT.
- `campaign_ids` (array): Campaign numeric IDs or URNs. Omit to report at account level.
- `end_date` (string): End of date range. Default: yesterday.
- `fields` (string): Comma-separated metrics. Default: impressions,clicks,costInUsd,costInLocalCurrency,externalWebsiteConversions,oneClickLeads,landingPageClicks,videoViews,follows,reactions,comments,shares
- `pivot` (string)
- `start_date` (string): Start of date range. Accepts YYYY-MM-DD, today, yesterday, or NdaysAgo. Default: 28daysAgo.
- `time_granularity` (string)

### `li_get_demographics_report` (~229 tokens)

Break down LinkedIn campaign performance by a demographic dimension of the people who saw or clicked your ads. Pivot options: MEMBER_JOB_TITLE (which titles engage most), MEMBER_JOB_FUNCTION, MEMBER_SENIORITY (director vs. manager vs. C-suite), MEMBER_COMPANY (which accounts clicked), MEMBER_COMPANY_SIZE, MEMBER_INDUSTRY, MEMBER_COUNTRY_V2, MEMBER_REGION_V2. Returns impressions, clicks, spend, leads, and conversions per dimension value. Useful for buyer-persona fit analysis and ABM account-list validation.

Input parameters:

- `ad_account_id` (string)
- `campaign_ids` (array)
- `end_date` (string)
- `fields` (string)
- `pivot` (string, required): Demographic dimension to break down by. MEMBER_JOB_TITLE / MEMBER_JOB_FUNCTION / MEMBER_SENIORITY are useful for persona fit; MEMBER_COMPANY / MEMBER_COMPANY_SIZE for ABM audience analysis; MEMBER_IN…
- `start_date` (string)

### `li_compare_periods` (~206 tokens)

Compare LinkedIn campaign performance across two time periods. wow (week-over-week): last 7d vs prior 7d. mom (month-over-month): last 30d vs prior 30d. yoy (year-over-year): last 30d vs same 30d last year. Returns per-entity rows (keyed by campaign/creative URN) with _current, _prior, _delta, and _pct_change columns for every requested metric. Deltas are computed server-side so you do not need to post-process. Useful for weekly/monthly performance reports and anomaly detection.

Input parameters:

- `ad_account_id` (string)
- `campaign_ids` (array)
- `comparison` (string): wow: last 7d vs prior 7d. mom: last 30d vs prior 30d. yoy: last 30d vs same 30d last year.
- `fields` (string)
- `pivot` (string)

### `li_get_video_analytics` (~171 tokens)

Fetch video-specific performance metrics for LinkedIn campaigns, broken down by creative. Returns videoStarts, videoViews, videoFirstQuartileCompletions, videoMidpointCompletions, videoThirdQuartileCompletions, videoCompletions, plus a computed videoCompletionRate (completions / starts × 100). Use to evaluate video ad quality — high completion rates indicate compelling content; low rates signal drop-off. Scope to specific campaigns via campaign_ids or report at account level.

Input parameters:

- `ad_account_id` (string)
- `campaign_ids` (array): Campaign numeric IDs or URNs to scope the report. Omit to report at account level.
- `end_date` (string)
- `start_date` (string)
- `time_granularity` (string)

### `li_get_budget_pacing` (~167 tokens)

Calculate budget utilization for active LinkedIn campaigns. Compares spend over the specified period_days window against total or estimated period budget, and returns a utilization_pct for each campaign. Useful for mid-flight pacing checks: if utilization is below 80% near the end of a month, the campaign may be under-delivering; above 100% means it is over-pacing. Accepts optional campaign_ids to limit scope; defaults to all ACTIVE campaigns in the account.

Input parameters:

- `ad_account_id` (string)
- `campaign_ids` (array): Limit pacing report to these campaigns. Omit to report all active campaigns in the account.
- `period_days` (integer): Number of days to look back for spend. Should match your budget period (e.g., 30 for monthly).

### `li_get_conversion_events` (~153 tokens)

List LinkedIn conversion event definitions on an ad account. Returns each event's name, type (URL/FILE_DOWNLOAD/SIGN_UP/etc.), enabled status, attributionType, post-click and view-through attribution window sizes, and associated Insight Tag. These are the events tracked by the LinkedIn Insight Tag on your website. Use to audit conversion event setup, confirm event names before pulling conversion performance, or verify attribution window configuration.

Input parameters:

- `ad_account_id` (string): Ad account numeric ID or URN. Defaults to LINKEDIN_DEFAULT_AD_ACCOUNT.
- `enabled_only` (boolean): If true, only return enabled conversion events. Set false to include disabled/archived events.
- `page_size` (integer)

### `li_get_conversion_performance` (~212 tokens)

Fetch conversion performance broken down by conversion event (CONVERSION pivot). Returns externalWebsiteConversions, externalWebsitePostClickConversions, externalWebsitePostViewConversions, impressions, clicks, and spend per conversion event. Use to compare cost-per-conversion across event types, diagnose which Insight Tag events are driving value, or build a funnel from impression → click → conversion. Scope to specific campaigns or report at account level.

Input parameters:

- `ad_account_id` (string)
- `campaign_ids` (array): Campaign numeric IDs or URNs to scope the conversion report. Omit for account-level.
- `end_date` (string)
- `fields` (string): Comma-separated metrics. Default: externalWebsiteConversions,externalWebsitePostClickConversions,externalWebsitePostViewConversions,impressions,clicks,costInUsd,costInLocalCurrency
- `start_date` (string): Start of date range. Accepts YYYY-MM-DD, today, yesterday, or NdaysAgo. Default: 28daysAgo.

### `li_get_audience_insights` (~164 tokens)

List DMP (Data Management Platform) segments attached to a LinkedIn ad account. Segments represent matched audiences (USER type: contact list uploads, website retargeting, lookalike audiences) and company lists (COMPANY type: for account-based marketing). Returns segment name, type, source, estimated size (where LinkedIn reports it), and status. Use to audit available audiences before building campaigns, or to confirm a matched audience uploaded successfully and has enough members to serve ads.

Input parameters:

- `ad_account_id` (string)
- `page_size` (integer)
- `type` (string): Filter segment type: USER (contact list / matched audience), COMPANY (company list for ABM), COMBINED (combined / lookalike segment).

### `li_search_targeting_facets` (~218 tokens)

Search LinkedIn targeting facet values to find the correct URNs for audience targeting. Facets include: jobTitles (e.g., 'Supply Chain Director'), skills (e.g., 'S&OP'), companies, industries, seniorities, locations, and more. Returns matching facet values with their LinkedIn URNs, which can then be used to configure campaign targeting via the Campaign Manager UI. Useful for researching targeting options, confirming exact category names, or building audience documentation.

Input parameters:

- `count` (integer): Maximum number of matching facet values to return (max 50).
- `facet` (string, required): Targeting facet to search. Use jobTitles for job title targeting, skills for skill-based targeting, companies to find specific company targets, industries for vertical targeting, seniorities for seni…
- `locale` (string): Locale for facet label localization. Default: en_US.
- `query` (string, required): Search string to filter facet values. Example: 'supply chain' for jobTitles.

### `li_get_leadgen_forms` (~138 tokens)

List LinkedIn Lead Gen Forms on an ad account. Returns form name, state (ACTIVE/DRAFT/ARCHIVED), the list of questions asked (field type, label, pre-fill source), the thank-you page URL and message, and the associated landing page (if any). Use to audit form question setup, confirm form state before troubleshooting lead delivery, or verify which forms are attached to active campaigns.

Input parameters:

- `ad_account_id` (string)
- `page_size` (integer)
- `state` (string): Filter by form state. ACTIVE forms are live on ads. DRAFT forms are not yet submitted for review.

### `li_get_leadgen_responses` (~199 tokens)

Retrieve actual Lead Gen Form submission data from LinkedIn. Each response includes questionResponses with field-by-field values (first name, last name, email, company, job title, phone, etc.) and submission timestamp. Filter by lead_form_id and/or submitted_after/before date range. Use for lead-to-CRM reconciliation against SFDC or Marketo, for auditing lead quality, or for confirming that a form integration is capturing the right fields. NOTE: This endpoint returns PII — handle output as sensitive data.

Input parameters:

- `ad_account_id` (string)
- `lead_form_id` (string): Filter to a specific Lead Gen Form (numeric ID or URN).
- `page_size` (integer)
- `submitted_after` (string): ISO date (YYYY-MM-DD). Only include responses submitted on or after this date.
- `submitted_before` (string): ISO date (YYYY-MM-DD). Upper bound for submission date.

### `li_get_leadgen_form_performance` (~180 tokens)

Fetch LinkedIn Lead Gen Form performance analytics broken down by creative. Returns impressions, clicks, Lead Gen Form opens (oneClickLeadFormOpens), lead submissions (oneClickLeads), spend, and computed metrics: formOpenRate (opens / clicks), leadSubmitRate (submissions / opens), costPerLead (spend / submissions), and CTR. Use to identify high-performing LGF creatives, diagnose drop-off between form open and submission, or compare cost-per-lead across campaigns.

Input parameters:

- `ad_account_id` (string)
- `campaign_ids` (array): Scope to specific campaigns (pass campaign IDs or URNs). Omit to report across all campaigns in the account.
- `end_date` (string)
- `start_date` (string): Start of date range. Default: 28daysAgo.

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/zleventer-linkedin-campaign-manager-mcp/linkedin-campaign-manager-mcp#diagnostics

## Score history

- 2026-08-03: 61
- 2026-08-02: 57
- 2026-08-01: 12
- 2026-07-31: 12
- 2026-07-30: 35
- 2026-07-28: 18
- 2026-07-27: 35

## Links

- npm package: https://www.npmjs.com/package/linkedin-campaign-manager-mcp
- Socket report: https://socket.dev/npm/package/linkedin-campaign-manager-mcp
- Changelog RSS feed: https://verifymcp.io/servers/zleventer-linkedin-campaign-manager-mcp/linkedin-campaign-manager-mcp/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/zleventer-linkedin-campaign-manager-mcp/linkedin-campaign-manager-mcp/changelog.json
- HTML version of this page: https://verifymcp.io/servers/zleventer-linkedin-campaign-manager-mcp/linkedin-campaign-manager-mcp