Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, email [email protected] and we’ll put it right.

LinkedIn Campaign Manager

NPM · LINKEDIN-CAMPAIGN-MANAGER-MCP · SCANNED AUG 3

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

+26 this week 61 Trust /100
Trust breakdown (6 categories)

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. How we score →

Supply Chain Security87
  • No malware found by supply-chain analysis.Pass
  • Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree.Partial
  • No install/post-install scripts declared.Pass
  • Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree. View diagnostics → Partial
Provenance & Transparency19
  • Repository check failed: the declared repository URL returned HTTP 404. See how to fix → View diagnostics → Fail
  • Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
  • Clear OSI-approved license (MIT).Pass
  • Actively maintained (last published 97 days ago).Pass
  • Security-disclosure policy not yet verified: we couldn't inspect the source repository.Unverified
Schema Quality & AI Usability66
  • AI-judged instruction clarity (excellent).Pass
  • 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. See how to fix → Fail
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management27
  • Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage85
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 54% of tool parameters carry a description.Partial
Capabilities100
  • Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · linkedin-campaign-manager-mcp

# add to Claude Code
claude mcp add zleventer-linkedin-campaign-manager-mcp -- npx -y linkedin-campaign-manager-mcp
# add to Codex CLI
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
    }
  }
}
# add to OpenClaw
openclaw mcp add zleventer-linkedin-campaign-manager-mcp --command npx --arg -y --arg linkedin-campaign-manager-mcp
# ~/.hermes/config.yaml
mcp_servers:
  zleventer-linkedin-campaign-manager-mcp:
    command: "npx"
    args: ["-y", "linkedin-campaign-manager-mcp"]
// mcp.json
{
  "mcpServers": {
    "zleventer-linkedin-campaign-manager-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "linkedin-campaign-manager-mcp"
      ]
    }
  }
}
Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 3 Aug 26 +4
    • Stability: unverified → 0.27 functional
  • 2 Aug 26 +45
    • Provenance: unverified → fail security
    • Install scripts: unverified → pass security
    • Known CVEs: unverified → partial security
    • Malware scan: unverified → pass security
    • Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window). security
    • Tool coverage: 100 → unverified functional
    • Schema quality: unverified → excellent functional
    • License: unverified → pass functional
    • Dependency health: unverified → partial functional
    • Maintenance: unverified → pass functional
    • MCP protocol: unverified → pass functional
    • Licence: MIT functional
  • 31 Jul 26 −23
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
  • 30 Jul 26 +17
    • Tool coverage: unverified → 100 functional
  • 28 Jul 26 −17
    • Tool coverage: 100 → unverified functional
    • First check of Schema quality: unverified functional
  • 27 Jul 26 35

    First indexed and scored.

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 3 Aug 2026 · Analysed npm/[email protected]

Provenance none

Ecosystem: npm · Outcome: none

Dependencies 95 packages

95 packages in the resolved dependency tree · 95 deprecated · 29 stale.

The dependency tree was only partially resolved, so these counts may be incomplete.

MCP tools — 19 exposed · ~3,216 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens
li_compare_periods ~206

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.

NameTypeReqDescription
ad_account_idstring
campaign_idsarray
comparisonstringwow: last 7d vs prior 7d. mom: last 30d vs prior 30d. yoy: last 30d vs same 30d last year.
fieldsstring
pivotstring

No output schema declared.

No examples provided.

li_get_account ~118

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.

NameTypeReqDescription
ad_account_idstringAd 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>/.

No output schema declared.

No examples provided.

li_get_audience_insights ~164

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.

NameTypeReqDescription
ad_account_idstring
page_sizeinteger
typestringFilter segment type: USER (contact list / matched audience), COMPANY (company list for ABM), COMBINED (combined / lookalike segment).

No output schema declared.

No examples provided.

li_get_budget_pacing ~167

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.

NameTypeReqDescription
ad_account_idstring
campaign_idsarrayLimit pacing report to these campaigns. Omit to report all active campaigns in the account.
period_daysintegerNumber of days to look back for spend. Should match your budget period (e.g., 30 for monthly).

No output schema declared.

No examples provided.

li_get_campaign ~129

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.

NameTypeReqDescription
ad_account_idstringAd account numeric ID or URN. Defaults to LINKEDIN_DEFAULT_AD_ACCOUNT.
campaign_idstringyesCampaign numeric ID or URN (urn:li:sponsoredCampaign:123). Required.

No output schema declared.

No examples provided.

li_get_campaign_performance ~285

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.

NameTypeReqDescription
ad_account_idstringAd account ID/URN. Used when campaign_ids is omitted. Defaults to LINKEDIN_DEFAULT_AD_ACCOUNT.
campaign_idsarrayCampaign numeric IDs or URNs. Omit to report at account level.
end_datestringEnd of date range. Default: yesterday.
fieldsstringComma-separated metrics. Default: impressions,clicks,costInUsd,costInLocalCurrency,externalWebsiteConversions,oneClickLeads,landingPageClicks,videoViews,follows,reactions,comments,shares
pivotstring
start_datestringStart of date range. Accepts YYYY-MM-DD, today, yesterday, or NdaysAgo. Default: 28daysAgo.
time_granularitystring

No output schema declared.

No examples provided.

li_get_conversion_events ~153

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.

NameTypeReqDescription
ad_account_idstringAd account numeric ID or URN. Defaults to LINKEDIN_DEFAULT_AD_ACCOUNT.
enabled_onlybooleanIf true, only return enabled conversion events. Set false to include disabled/archived events.
page_sizeinteger

No output schema declared.

No examples provided.

li_get_conversion_performance ~212

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.

NameTypeReqDescription
ad_account_idstring
campaign_idsarrayCampaign numeric IDs or URNs to scope the conversion report. Omit for account-level.
end_datestring
fieldsstringComma-separated metrics. Default: externalWebsiteConversions,externalWebsitePostClickConversions,externalWebsitePostViewConversions,impressions,clicks,costInUsd,costInLocalCurrency
start_datestringStart of date range. Accepts YYYY-MM-DD, today, yesterday, or NdaysAgo. Default: 28daysAgo.

No output schema declared.

No examples provided.

li_get_creative ~136

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.

NameTypeReqDescription
ad_account_idstringAd account numeric ID or URN. Defaults to LINKEDIN_DEFAULT_AD_ACCOUNT.
creative_idstringyesCreative numeric ID or URN (urn:li:sponsoredCreative:123). Required.

No output schema declared.

No examples provided.

li_get_demographics_report ~229

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.

NameTypeReqDescription
ad_account_idstring
campaign_idsarray
end_datestring
fieldsstring
pivotstringyesDemographic 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_datestring

No output schema declared.

No examples provided.

li_get_leadgen_form_performance ~180

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.

NameTypeReqDescription
ad_account_idstring
campaign_idsarrayScope to specific campaigns (pass campaign IDs or URNs). Omit to report across all campaigns in the account.
end_datestring
start_datestringStart of date range. Default: 28daysAgo.

No output schema declared.

No examples provided.

li_get_leadgen_forms ~138

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.

NameTypeReqDescription
ad_account_idstring
page_sizeinteger
statestringFilter by form state. ACTIVE forms are live on ads. DRAFT forms are not yet submitted for review.

No output schema declared.

No examples provided.

li_get_leadgen_responses ~199

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.

NameTypeReqDescription
ad_account_idstring
lead_form_idstringFilter to a specific Lead Gen Form (numeric ID or URN).
page_sizeinteger
submitted_afterstringISO date (YYYY-MM-DD). Only include responses submitted on or after this date.
submitted_beforestringISO date (YYYY-MM-DD). Upper bound for submission date.

No output schema declared.

No examples provided.

li_get_video_analytics ~171

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.

NameTypeReqDescription
ad_account_idstring
campaign_idsarrayCampaign numeric IDs or URNs to scope the report. Omit to report at account level.
end_datestring
start_datestring
time_granularitystring

No output schema declared.

No examples provided.

li_list_ad_accounts ~125

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.

NameTypeReqDescription
page_sizeintegerNumber of results per page (max 100).
statusstringFilter by ad account status. Omit to return accounts in all statuses.

No output schema declared.

No examples provided.

li_list_campaign_groups ~90

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.

NameTypeReqDescription
ad_account_idstring
page_sizeinteger
statusstring

No output schema declared.

No examples provided.

li_list_campaigns ~163

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.

NameTypeReqDescription
ad_account_idstringAd account numeric ID or URN. Defaults to LINKEDIN_DEFAULT_AD_ACCOUNT.
campaign_group_idstringFilter to campaigns belonging to a specific campaign group (numeric ID or URN).
page_sizeinteger
statusstringFilter by campaign status. Omit to return campaigns in all statuses.

No output schema declared.

No examples provided.

li_list_creatives ~133

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.

NameTypeReqDescription
ad_account_idstring
campaign_idstringFilter to creatives in a specific campaign (numeric ID or URN).
page_sizeinteger
statusstringFilter by intendedStatus.

No output schema declared.

No examples provided.

li_search_targeting_facets ~218

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.

NameTypeReqDescription
countintegerMaximum number of matching facet values to return (max 50).
facetstringyesTargeting 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…
localestringLocale for facet label localization. Default: en_US.
querystringyesSearch string to filter facet values. Example: 'supply chain' for jobTitles.

No output schema declared.

No examples provided.