LinkedIn Ads MCP server for your AI

Post a comment on a post, or a reply on a comment, as the signed-in member or as the organization.

Delete a comment from a post — the moderation action for spam or abuse under a sponsored post.

List the LinkedIn Pages the signed-in member administers, and their role on each.

Find a LinkedIn Page by its vanity name — the slug in linkedin.com/company/<vanityName>.

Get the signed-in LinkedIn member's own profile — id, name and headline.

Get a LinkedIn Page (organization) by id: name, vanity name, website, industry, staff-count range, logo and description.

ORGANIC engagement for a Page's posts — impressions, clicks, likes, comments, shares and engagement rate, either aggregated or per post.

List the comments on a post (or the replies on a comment).

Attach an existing post to a campaign as an ad (a 'creative').

Create the post AND the ad in ONE call — the recommended way to build Sponsored Content, because it avoids the orphaned-dark-post problem where a post is created but the creative fails.

Create a creative on the ACCOUNT-LESS /creatives resource — the form LinkedIn documents for Text Ads, Spotlight Ads, Follower Ads, Dynamic Job Ads and VAST-tag Video Ads.

Find ads (creatives) in the connected ad account, filtered by campaign, content reference, creative URN or intended status.

Get a renderable HTML preview iframe for an existing ad, exactly as a member would see it.

Get one ad (creative) by URN: its campaign, content reference, intended and computed status, review status and any `servingHoldReasons` — which is where you find out that an ad was rejected in review rather than simply not delivering.

Change an ad — most often to turn it on or off with {"intendedStatus":"ACTIVE"} or {"intendedStatus":"PAUSED"}.

Change a Text, Spotlight, Follower, Jobs or VAST-tag video ad — copy, landing page, logo, or `intendedStatus` to pause and resume it.

Add or remove companies in an account-list Matched Audience, by company name, website, email domain, stock symbol or LinkedIn organization URN.

Add or remove people in a contact-list Matched Audience by streaming hashed identifiers.

Attach a conversion rule to a campaign so that campaign's conversions are attributed to it.

Create a conversion rule on the connected ad account — the definition of a valuable action (sign-up, purchase, demo request) that LinkedIn should attribute to ads.

Create a Matched Audience (DMP segment) on the connected ad account — a list-upload audience of contacts or companies, or a container for engagement-retargeting rules.

List the ad segments available to the connected ad account, with their sizes and statuses.

List the conversion rules defined on the connected ad account.

List the Matched Audiences on the connected ad account, with their sizes and statuses.

List the website domains LinkedIn has seen the connected account's Insight Tag firing on, with their verification state — the quickest check that a pixel is actually installed.

Get one Matched Audience: its type, status, destination and — the field that matters — the matched audience COUNT, which tells you whether it is large enough to target yet.

Send server-side conversion events to LinkedIn (the Conversions API) so offline and CRM conversions can be attributed to ads without a browser pixel.

Get the RESULTS of an A/B test: per-treatment performance on the key metric, lift, and whether the difference is statistically significant.

Search A/B tests on the connected ad account by campaign, campaign group, key metric or state.

Create a post.

Browse the connected ad account's image media library, so an existing image can be reused instead of re-uploaded.

List the Direct Sponsored Content (dark posts) created under the connected ad account — the posts that exist only as ads.

Get an image asset: its status (the upload must reach AVAILABLE before a post can use it), download URL and dimensions.

Get one post by URN — its commentary, media, author, visibility and lifecycle state.

Get a video asset: transcoding status (must be AVAILABLE before a post can use it), duration, thumbnail and download URL.

Step 1 of adding an image to an ad: register the upload and get back an `uploadUrl` plus the new `urn:li:image:...` id.

Step 1 of adding a video to an ad: register the upload and get back the new `urn:li:video:...` id plus one or more PART upload URLs (LinkedIn videos upload in chunks).

List the saved audience templates on the connected ad account.

List the allowed VALUES of one targeting facet — e.g.

List every targeting FACET LinkedIn supports — locations, industries, seniorities, job titles, job functions, skills, employers, company sizes, member groups, interests, degrees, fields of study, years of experience, member behaviors, buyer groups and the rest — with each facet's URN and which entity type its values are.

Turn targeting URNs back into human names — the reverse lookup.

Search a targeting facet by free text and get back the matching entity URNs — how you turn "San Francisco", "Software Engineer" or "Salesforce" into the URN targetingCriteria needs.

Retrieve the LEADS themselves — each submitted Lead Gen Form response with the member's answers.

List the Lead Gen Forms owned by the connected ad account (or by an organization).

Company Intelligence for the connected ad account: which COMPANIES engaged with your ads over a lookback window, with engagement counts and firmographics.

THE reporting tool: performance metrics for the connected ad account, grouped by ONE pivot and one time granularity.

Get LinkedIn's suggested bid and the competitive bid range for a targeting audience BEFORE you create a campaign — the bid floor, the suggested bid and the low/high range for the chosen bid type and objective.

Like linkedin_ads_get_ad_analytics but grouped by UP TO THREE pivots at once — e.g.

Forecast the impressions, clicks and spend a proposed campaign would achieve for a given audience, budget, bid and flight — LinkedIn's media-planning estimate.

CRM-attributed revenue for the connected ad account: revenue won, open and closed-won opportunities, win rate, average deal size, days to close and return on ad spend.

Get the estimated size of a targeting audience.

Create a campaign inside a campaign group.

Create a campaign group in the connected ad account.

Get the LinkedIn ad account this connection is locked to: its name, type, status, CURRENCY, notified-on-* settings, the organization it bills to and its serving statuses.

Get one campaign by id — budget, bid, schedule, status, objective, full targetingCriteria and `servingStatuses`.

Get one campaign group by id: name, status, run schedule, total budget, objective and serving statuses.

Search campaign groups in the connected ad account by id, name, status or test flag.

Search campaigns in the connected ad account by id, campaign group, name, type, status or test flag.

Change a campaign: pause or resume it ({"status":"PAUSED"} / {"status":"ACTIVE"}), change budget or bid, extend the schedule, or replace the targeting.

Change a campaign group: rename it, move it between DRAFT/ACTIVE/PAUSED/ARCHIVED, extend its run schedule or adjust its total budget.

List the people who have access to the connected ad account and the role each one holds.

List EVERY ad account the signed-in LinkedIn member can reach, with their role on each.

Fetch several LinkedIn Pages by id in one call — the efficient way to name the organizations behind a set of campaigns.

Get like and comment summaries for several posts in one call.

Get social settings for several posts in one call.

Create a LinkedIn Event on behalf of an organization — the object an Event Ad promotes.

Subscribe the developer application to push notifications about an organization's social actions, instead of polling.

Like a post or comment as the signed-in member or as the organization.

React to a post or comment as the signed-in member or the organization.

Cancel a social-action event subscription.

Remove a like from a post or comment.

Remove an actor's reaction from a post or comment.

List the showcase pages and child organizations under a parent LinkedIn Page.

List the signed-in member's event subscriptions of a given type — the audit view of which webhooks are live.

List the LinkedIn Events organized by a company — the way to find the event URN an Event Ad should point at.

List a company's LinkedIn Events that have registration lead-gen forms enabled — the events whose registrations you can pull as leads.

List everyone with a role on one LinkedIn Page — who can administer it and who may post Direct Sponsored Content.

Batch-check several authorization actions for the signed-in member across organizations in one call.

Poll the brand-monitoring feed for a LinkedIn Page: new comments, mentions and shares involving the organization — the way to catch conversation on sponsored posts without watching each one.

List the reactions on a post or comment, with their types — a finer view than the raw like count.

Page view analytics for a showcase (brand) page, the same shape as the organization page statistics.

Get one comment on a post.

Get a LinkedIn Event: its name, times, mode, organizer, registration settings and attendee counts.

Get one social-action event subscription and its status.

Get the signed-in member's own follower count.

Creator analytics for one of the signed-in member's own posts — impressions, reactions, comments and reshares over time.

Creator video analytics for one of the signed-in member's own video posts — plays, watch time and completion.

Check whether a member is authorized to take a specific action on a LinkedIn Page (e.g.

Follower analytics for a LinkedIn Page — follower gains over time, and the lifetime follower breakdown by seniority, industry, function, company size, country and association.

Get an organization's follower count.

Page view analytics for a LinkedIn Page: views and unique visitors by page section (overview, careers, jobs, life) and by visitor demographic.

Get one actor's reaction on a post or comment, including the reaction type (LIKE, PRAISE, EMPATHY, INTEREST, APPRECIATION, ENTERTAINMENT).

Get the like and comment SUMMARY for a post or comment — total counts and whether the member has reacted.

Get a post's social SETTINGS — whether commenting and resharing are enabled, and the comment moderation state.

List the likes on a post or comment.

Batch-resolve organization ids to Page details through the Organization Lookup API, which accepts organization, organizationBrand and school ids together.

Grant or change a member's role on a LinkedIn Page — for example granting DIRECT_SPONSORED_CONTENT_POSTER so they can create dark posts for ads.

Change a LinkedIn Event — its name, description, times or registration settings.

Change a post's social settings — most usefully to disable commenting on a sponsored post that is attracting abuse.

Delete several ads in one call.

Delete several account-less creatives in one call.

Delete several message nodes from a Sponsored Conversation.

Fetch several Sponsored Conversations by URN in one call.

Fetch several ads by URN in one call.

Fetch several account-less creatives by URN in one call.

Fetch several Message Ad bodies by URN in one call.

Change several ads in one call — e.g.

Change several account-less creatives in one call.

Change several message nodes of a Sponsored Conversation in one call.

Create a Sponsored Conversation — the branching message tree behind a Conversation Ad.

Create an account-less creative together with its inline content in one call — LinkedIn's documented path for Article Ads and other formats whose content is created alongside the ad.

Create the message body for a Message Ad (Sponsored InMail): sender, subject, body, call-to-action and optional lead-gen form.

Render a preview of a creative that has NOT been saved yet — the way to show a draft ad to a human before committing it.

Render a preview of an unsaved creative AND its unsaved inline post together — the preview counterpart of linkedin_ads_create_creative_inline.

Add one message node to a Sponsored Conversation: its body copy and the reply buttons that branch to other nodes.

Delete an ad.

Delete a Text, Spotlight, Follower, Jobs or VAST-tag video ad.

Find creatives on the account-less /creatives resource by campaign or intended status — the listing counterpart for Text, Spotlight, Follower, Jobs and VAST-tag video ads.

Get one Sponsored Conversation by URN, including the structure of its message tree.

Get a creative from the account-less /creatives resource by URN (Text, Spotlight, Follower, Jobs and VAST-tag video ads).

Get one Message Ad body by URN.

Get one message node of a Sponsored Conversation.

List every message node in a Sponsored Conversation — the way to read the whole tree.

Send a test copy of a Message Ad to a named LinkedIn member so a human can check it in their real inbox before the campaign runs.

Change a Sponsored Conversation's name, sender or first message.

Change a Message Ad body — subject, body copy, call to action or sender.

Change one message node of a Sponsored Conversation — its copy or its reply buttons.

Attach conversion rules to campaigns in bulk — the efficient way to wire a new conversion rule to many campaigns.

Detach several conversion rules from campaigns in one call.

Remove several engagement-retargeting rules from a Matched Audience in one call.

Delete several Matched Audiences in one call.

Check several campaign-to-conversion associations in one call.

Fetch several conversion rules by id in one call.

Fetch several Matched Audiences by id in one call.

Fetch several Insight Tag domain records in one call.

Change several conversion rules in one call — e.g.

Update several Insight Tag domain records in one call.

Create a website-retargeting page set: a named group of URL rules that defines which site visitors go into a retargeting audience.

Add an engagement-retargeting rule to a Matched Audience — 'people who watched 50% of this video ad', 'people who opened this lead form', 'people who visited this company page'.

Add a destination to a Matched Audience, i.e.

Get a signed URL for uploading a bulk audience list FILE.

Create a LinkedIn Insight Tag for the connected ad account — the browser pixel behind website conversion tracking, retargeting and website demographics.

Create a Predictive Audience from a seed Matched Audience: LinkedIn models people who resemble your seed and are likely to hit a business objective.

Attach a third-party impression or click tracking tag (DoubleClick, Innovid, and similar verification vendors) to a creative.

Detach a page set from an ad segment.

Detach a conversion rule from a campaign.

Remove all dynamic UTM tracking parameters from a campaign.

Remove an engagement-retargeting rule from a Matched Audience.

Delete a Matched Audience.

Delete a Predictive Audience.

Remove a third-party tracking tag from its creative.

List which conversion rules are attached to the given campaigns — the way to audit whether a campaign is actually tracking anything.

List which other ad accounts have been granted access to the connected account's Insight Tag data.

List the Insight Tags on the connected ad account.

List the third-party tracking tags attached to a creative.

Get one ad segment — the targetable form of a Matched Audience, which is what a campaign's targetingCriteria actually references.

Check whether one conversion rule is attached to one campaign.

Read the dynamic UTM tracking parameters currently set on a campaign.

Get one conversion rule: its type, attribution windows, whether it is enabled, and which campaigns it is attached to.

Get one engagement-retargeting rule on a Matched Audience.

Get one engagement source type and its metadata.

Get one engagement trigger and its metadata.

Get one destination of a Matched Audience and its sync status.

Get one Insight Tag: its name, id and the domains it has been seen firing on.

Get the Insight Tag record for one domain on the connected account.

Get one Predictive Audience and its build status.

Get one third-party tracking tag by id.

Share the connected account's Insight Tag with another ad account, so that account can build retargeting audiences and track conversions from the same pixel.

List the engagement-retargeting rules on a Matched Audience.

List the engagement SOURCES you can retarget from — video ads, lead gen forms, company page, events, single image ads, message ads and so on.

List the TRIGGERS valid for one engagement source — e.g.

List every destination configured on a Matched Audience.

List the Predictive Audiences built from a seed Matched Audience.

Revoke another ad account's access to the connected account's Insight Tag.

Attach a website page set (or other source) to an ad segment, so visitors matching those rules build the retargeting audience.

Set dynamic UTM tracking parameters on a campaign, so every click from it carries your analytics tags without editing each creative's landing page.

Change an ad segment's name or status.

Change a conversion rule — rename it, enable or disable it, change the attribution windows or its value.

Rename a Matched Audience or change its description or access policy.

Rename an Insight Tag or change the domains associated with it.

Update the Insight Tag settings for one domain on the connected account.

Change a Predictive Audience's name or target size.

Remove survey questions from a Brand Lift test.

Fetch several A/B tests by id in one call.

Create an A/B test across campaigns: LinkedIn splits the audience between the treatment campaigns and measures a key metric, so results are causal rather than a before/after comparison.

Add the survey questions to a Brand Lift test — one question per key metric, with its answer options.

Create a Brand Lift test: LinkedIn surveys an exposed group and a control group to measure the campaign's effect on awareness, consideration or favourability — the measurement that click metrics cannot give.

Create a saved media plan with a reach or impressions forecast, so a plan can be reviewed and reused before campaigns exist.

Delete an A/B test.

Delete a Brand Lift test and its survey configuration.

List the Brand Lift tests on the connected ad account, optionally filtered by scope or execution state.

Forecast reach and frequency for a proposed media plan across several audiences and budgets at once — the planning view that precedes building campaigns.

Get one A/B test: its treatments, key metric, schedule and execution state.

Get industry benchmark values for a Brand Lift test's metrics, so a measured lift can be judged against comparable campaigns rather than in isolation.

Find out the minimum budget a Brand Lift test needs to reach significance for the chosen key metrics.

Get Brand Lift RESULTS: the measured lift per key metric between the exposed and control groups, with confidence.

Get one Brand Lift test: its scope, key metrics, schedule and execution state.

Get one saved media plan with its forecast.

List the survey questions configured on a Brand Lift test.

List the saved media plans on the connected ad account.

Get results for several A/B tests at once.

Change an A/B test — rename it, adjust the schedule, or move `userIntendedState` between DRAFT, ACTIVE and ARCHIVED to start or stop it.

Change or ACTIVATE a Brand Lift test — set `executionState` to start it once its survey questions are in place.

Dry-run an A/B test definition and get back the problems (overlapping audiences, insufficient budget, incompatible objectives) WITHOUT creating anything.

Dry-run a Brand Lift test definition and get back what is wrong with it, without creating anything.

Fetch several document assets by URN in one call.

Fetch several image assets by URN in one call.

Fetch several posts by URN in one call — e.g.

Fetch several video assets by URN in one call.

Finish a multi-part upload on the legacy Vector Assets API, supplying the part ETags returned by each part PUT.

Delete a post.

Step 3 of a video upload: tell LinkedIn every part has been PUT, supplying the ETags the part uploads returned.

List the posts published by an organization or member, newest first.

Browse the connected ad account's video media library to reuse an existing video.

Get a legacy Vector asset by id, including its media artifacts and processing status.

Get a document asset: its processing status and page count.

Step 1 of a Document Ad: register the PDF/PPT upload and get an uploadUrl plus the new `urn:li:document:...` id.

Register an upload on the legacy Vector Assets API and get an upload URL — still the documented path for a few asset types such as LinkedIn Event background images.

Update an image asset's media-library metadata, e.g.

Edit a published post — its commentary, call-to-action label, landing page or ad context.

Update a video asset's media-library metadata within the ad account library.

Delete several saved audience templates in one call.

Request LinkedIn's global publisher list — the platform-wide inventory of sites and apps in the Audience Network — so it can be reviewed before choosing exclusions.

Register an uploaded allow-list or block-list file of websites and app-store URLs as a publisher restriction, for brand safety on the LinkedIn Audience Network.

Get a signed URL to download an existing publisher restriction file, to see which domains it contains.

Get a signed URL to upload a publisher allow/block list file to.

Save a targeting definition as a reusable template on the connected ad account, so the same audience can be applied to future campaigns without rebuilding it.

Delete a saved audience template.

List the publisher restriction files registered against the connected ad account.

Given entities you already target, get LinkedIn's suggestions for similar ones within the same facet — e.g.

Get one publisher restriction file record: its name, type (allow or block) and processing status.

Get one saved audience template by id, including its full targetingCriteria — copy that straight into a campaign.

List LinkedIn's country groupings (the legacy geo vocabulary).

Search LinkedIn's Bing-backed geography by name and get geo URNs — the location vocabulary shared by ad targeting and organic post targeting.

Change a saved audience template's name, description or targeting.

Fetch several submitted leads by response id in one call.

Fetch several Lead Gen Forms by id in one call.

Create a Lead Gen Form — the in-platform form a member submits without leaving LinkedIn, pre-filled from their profile.

Subscribe a webhook URL to new-lead notifications, so leads are pushed to you as they arrive instead of being polled.

Register an HTTPS endpoint that LinkedIn may push lead notifications to.

Cancel a lead-notification subscription.

List the lead-notification subscriptions on the connected ad account — the way to audit where your leads are being sent.

Get one Lead Gen Form: its headline, questions, privacy policy, thank-you message and state.

Get one submitted lead by its response id, with the member's answers.

Get one lead-notification subscription: which forms it covers and where it delivers.

Change a Lead Gen Form — its name, headline, description, thank-you message or state (e.g.

Profile an audience: the industries, job functions, seniorities, company sizes, locations and interests over-represented in a matched audience or targeting definition, versus a benchmark.

Per-video engagement for one post or video entity: time watched, views, viewers, and completion curve — the detail the campaign-level metrics do not carry.

Create several LinkedIn ad accounts in one call.

Create several campaigns in the connected ad account in one call.

Delete several DRAFT campaign groups in one call.

Fetch several campaign groups by id in one call.

Fetch several campaigns by id in one call.

Change several campaign groups in one call — e.g.

Change several campaigns in one call — the efficient way to pause or re-budget a set.

Create a new LinkedIn ad account.

DELETE the connected ad account.

Delete a DRAFT campaign.

Delete a DRAFT campaign group.

Read the connected account's brand-safety trust preferences: which publisher-restriction file (allow list or block list) is applied to LinkedIn Audience Network delivery, and whether the LinkedIn global publisher block list is in force.

Search the ad accounts this login can reach, by id, name, status, type or test flag.

Update the connected ad account's editable settings — `name`, `status` (ACTIVE, DRAFT, CANCELED), `notifiedOnCreativeApproval`, `notifiedOnEndOfCampaign`, `notifiedOnCampaignOptimization`, `notifiedOnCreativeRejection`.

Replace the connected account's brand-safety trust preferences.

Check whether the signed-in member may create sponsored (dark) posts on behalf of an organization through this ad account — the permission a Video Ad or any Direct Sponsored Content build depends on.

Grant a LinkedIn member access to the connected ad account with a role.

Revoke a member's access to the connected ad account.

Get one person's access record on the connected ad account: their role and whether the grant is active.

Change an existing user's role on the connected ad account.