LinkedIn Ads MCP Server
Summary: The supplied server schema exposes read-only LinkedIn Ads tools for inspecting accounts, campaign structure, reporting, demographics, delivery, media, and targeting from an MCP client; it does not expose write tools.
Run health checks and list reachable configured ad accounts.
Read account details, campaign groups, campaigns, creatives, and individual entities.
Run insights and multi-pivot statistics reports with computed ratios.
Analyze professional demographics and CRM revenue attribution.
Validate report queries offline and diagnose ad delivery/serving status.
Find targeting URNs and list/refresh image and video library media.
List ad creatives with media and landing URLs, without delivery reporting.
Note: The README mentions optional write tools disabled by default, but the provided schema contains only read-only tools.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@LinkedIn Ads MCP Server show last month's campaign performance for account 512345678"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
LinkedIn Ads MCP server
Bring your LinkedIn Ads accounts into your MCP client.
Read campaign structure, performance and professional demographics, and prepare draft campaigns and ads for explicitly selected accounts.
Watch the film · What's new · Install · Tool reference · Try hosted getmcpads

The film shows hosted getmcpads with sample data. Its MCP Apps, from creative galleries and alerts to Google Sheets exports and bulk launches, belong to the hosted product. This repository provides the standalone native API tools.
18 read tools · 15 write tools, disabled by default.
Run locally with your own LinkedIn app credentials and a client that supports stdio MCP, such as Claude Desktop, Claude Code or Cursor. Your requests go directly to the LinkedIn Marketing API. For managed connections, including supported ChatGPT setups, use the hosted option.
What's new
v1.0.2: Maintainer metadata update · November 8, 2026
List the getmcpads team as maintainer in
package.json, the README andSOURCE_SYNC.md.No change to tools, parameters, descriptions or runtime behaviour.
Earlier releases
Version | Date | Highlights |
1.0.1 | October 26, 2026 | Zod 4 security update |
1.0.0 | October 23, 2026 | First standalone release |
Source synchronization: SOURCE_SYNC.md.
Upgrade notes
Requires Node.js 22.23.4, 24.22.1, 26.12.1 or a newer release. These carry the October 2026 security fixes, and the server prints a warning on stderr when it runs on an older one. CI covers Node 22, 24 and 26.
This is the first release. Hosted creative galleries, campaign launches and MCP Apps UI are outside it.
Related MCP server: LinkedIn Ads MCP Toolkit
Install this release
This is a GitHub source release. npm and MCP Registry versions are published separately. The commands below select this exact version; unpinned npx examples later in this document select the version currently available on npm.
git clone --branch v1.0.2 --depth 1 https://github.com/get-mcp-ads/linkedin-ads-mcp-server.git
cd linkedin-ads-mcp-server
npm ci
npm run buildConfigure your MCP client to run node with the absolute path to dist/cli.js and the variables documented below. Once the package is on npm, the client can run npx -y @getmcpads/linkedin-ads-mcp-server instead, which starts the linkedin-ads-mcp binary.
{
"mcpServers": {
"linkedin-ads": {
"command": "node",
"args": ["/absolute/path/to/linkedin-ads-mcp-server/dist/cli.js"],
"env": {
"LINKEDIN_ADS_ACCESS_TOKEN": "your-member-access-token",
"LINKEDIN_ADS_ACCOUNT_IDS": "512345678"
}
}
}
}npm run doctor reports which variables are set, never their values, and checks the Node.js release.
Prefer a managed connection? Use LinkedIn Ads with hosted getmcpads. Connect your account, select the data your assistant may access and use the hosted MCP connection. See the site for current features and plans.
Configuration
Provide these environment variables through the client's secret configuration:
Variable | Purpose |
| Member access token from your own LinkedIn app. Required unless the three refresh variables are set. |
| Programmatic refresh token, for apps LinkedIn approved for them. The access token is then renewed in memory. |
| Client ID of your app. Used with the refresh token. |
| Client secret of your app. Used with the refresh token. |
| Required. 1 to 100 comma-separated numeric ad account IDs. Every other account is refused before any request, reads included. |
| Optional. Scopes actually granted to the token. When set, writes refuse to run without |
| Defaults to |
|
|
|
|
The server validates the configuration at startup and names the variable to fix. It runs no OAuth browser flow and writes nothing to disk: a token renewed through the refresh token stays in memory until the process ends.
What your LinkedIn app needs
LinkedIn Marketing API access is granted per application, so this server runs with an app you own. LinkedIn's quick start describes the steps:
Create a LinkedIn Page, then a developer application in the LinkedIn Developer Portal.
Request the Advertising API product from the app's Products tab and complete the access form. LinkedIn reviews each request.
Every application starts on the Development tier: reads have no account limit, and edits are limited to five ad accounts you administer. On this tier, add each ad account ID under Products, View Ad Accounts. The Standard tier removes the edit limit and is requested through the Developer Support Portal. See access tiers.
Generate a member access token with the Token Generator, or your own authorization code flow, with the scopes below. Access tokens last 60 days. Apps approved for programmatic refresh tokens receive a refresh token valid for a year, which this server can use.
Scopes used by the tools of this server:
Scope | Needed for |
| Account, campaign group, campaign, creative and media library reads, and targeting lookup. |
|
|
|
|
| Every write tool. |
|
|
LinkedIn roles still decide what the token can do. A VIEWER on an ad account can only read, even with rw_ads; writes need ACCOUNT_BILLING_ADMIN, ACCOUNT_MANAGER, CAMPAIGN_MANAGER or CREATIVE_MANAGER (account roles). Media uploads and sponsored image or video ads belong to the Company Page referenced by the ad account, which needs an administrator or sponsored content poster role on that Page. linkedin_health_check lists the configured accounts the token reaches and the ones it does not.
Safety and coverage
Writes preview by default. Review the exact account, target and parameters before repeating the call with confirm: true.
Campaign groups, campaigns and ads are created as DRAFT, and sponsored posts use feedDistribution: NONE, so nothing reaches the organic feed. New campaigns keep audience expansion and the LinkedIn Audience Network off. No tool activates delivery: activation, where spend starts, happens in Campaign Manager. A preview flags an edit of budget, bid, schedule or targeting, which can change what an already running campaign spends.
Do not retry a write automatically when its result is uncertain. A failed write reports verify_before_retry when a mutation reached LinkedIn and not_applied when none did. This server never retries a mutation; reads retry a network error, HTTP 429 or a 5xx at most twice.
Account checks apply before every request. Campaign, group and creative filters are verified against the account before a report, and every write re-reads its account and parent entities. Unknown arguments are rejected.
Requests go only to api.linkedin.com, the token endpoint and the signed upload URLs on www.linkedin.com, without following redirects, with timeouts and bounded responses. Upload URLs travel inside HMAC-signed receipts that end with the process, and the upload request carries no token. Tokens and secrets are redacted from every result and error.
Budgets and bids are decimal strings in the account currency, such as "20.00" with "EUR", not micros or cents. A report needs at least one entity scope, accepts at most 20 fields and is capped at 15,000 rows; the server applies these limits before the call and says when LinkedIn drops a field instead of returning zero.
This server exposes the native LinkedIn tools of the hosted gateway, plus account discovery, a health check and offline query validation. Audience size estimates, bid and supply forecasts, matched audiences, conversion rules, lead form definitions, experiments, Page statistics and generic endpoint reads are not included in this release. Submitted lead data is never exposed.
Use tools/list or server-card.json for exact schemas and the Marketing API documentation for provider details.
Hosted option
getmcpads for LinkedIn Ads manages the hosted connection and account selection. Hosted and source releases can differ. Contact: hello@getmcpads.com.
Development
npm run typecheck
npm run lint
npm run build
npm test
npm run catalogAll tests run offline with mocked fetch responses. No live account is read or changed.
Tools
Every tool is listed below. See server-card.json for complete parameter and output schemas. Every tool except linkedin_list_ad_accounts, linkedin_health_check and linkedin_validate_query takes a configured adAccountId.
Tool | Purpose |
| Check the token, the configured accounts it reaches, the reporting endpoint and the API version, without returning the token |
| List the configured ad accounts the member can reach, with currency, status and serving status |
| Read one ad account in full, with the members who hold a role on it |
| List campaign groups with budget, schedule and serving status |
| List campaigns with status, objective, format, bid, budget and schedule, optionally with targeting |
| List creatives with intended status, review verdict and serving hold reasons |
| Read one campaign group, campaign or creative and verify account ownership |
| Read the account, supported formats and native write requirements before preparing changes |
| Run a report grouped by one pivot, with computed ratios |
| Run a report grouped by up to three pivots at once |
| Break delivery down by professional demographics, with names resolved and the limits stated |
| Read CRM pipeline and closed won revenue attributed to LinkedIn advertising |
| Check a pivot and metric combination against the reporting rules, without a request |
| Explain why ads are or are not serving, from the account down to the creative |
| Look up native targeting URNs, such as countries or job titles, by name |
| List the account image or video library with download URLs and processing status |
| Refresh one image or video URL and verify its library association |
| List the images and videos used by ads, with the actual ad names and landing pages |
Disabled by default. Calls preview unless explicitly confirmed. Check the configuration and exact schema before use.
Tool | Purpose |
| Create a DRAFT campaign group |
| Create a DRAFT text ad or sponsored content campaign with budget, bid, targeting and schedule |
| Create a DRAFT text ad with an image from the account library |
| Create a DRAFT sponsored image or video ad on a dark post |
| Rename, pause or archive, or edit budget, bid, schedule, targeting or text ad content |
| Rename a campaign group, and nothing else |
| Rename a campaign, and nothing else |
| Rename an ad (creative), and nothing else |
| Rename the ad account, and nothing else |
| Copy an ad into a verified campaign as DRAFT |
| Delete one DRAFT ad, without touching its post or media |
| Start an image or video upload to the account library and return a signed receipt |
| Upload one part of the file to LinkedIn's signed upload URL |
| Finalize a video once every part is uploaded |
| Rename or archive a library image or video |
Resource | Content |
| Configured accounts, API version, entity hierarchy and safety rules |
| The metric catalog, with formulas of computed ratios and the pivots each metric is unavailable with |
| Pivots and the finder that serves each one |
| Scoping, row cap, retention, freshness, demographic limits and throttling |
| Shape of the targeting criteria, lookup and audience limits |
| Tool sequences for common questions |
License
Apache License 2.0. See NOTICE.
More from getmcpads
Meta Ads · Google Ads · Google Analytics 4 · Google Search Console · TikTok Ads · Pinterest Ads · X Ads
Maintained by the getmcpads team at getmcpads. Questions: hello@getmcpads.com.
Available Tools
18 toolslinkedin_find_targetinglinkedin find targetingBRead-onlyIdempotent
Look up native targeting URNs such as countries by name.
Inputs: query (required), adAccountId (required), facet. Returns: result
linkedin_get_account_detailslinkedin get account detailsARead-onlyIdempotent
Read one LinkedIn ad account in full, with the members who hold a role on it. Roles decide what the connection can do, so a read that fails on one account and works on another is usually a role, not a scope.
Inputs: adAccountId (required), includeUsers. Returns: result
linkedin_get_campaign_groupslinkedin get campaign groupsARead-onlyIdempotent
List campaign groups in a LinkedIn ad account, with budget, schedule and serving status. On LinkedIn the campaign group is where a shared budget and a bid strategy live, so it is the level that explains why sibling campaigns stopped together.
Inputs: adAccountId (required), name, status, pageSize, +1 more. Returns: result
linkedin_get_campaignslinkedin get campaignsARead-onlyIdempotent
List campaigns in a LinkedIn ad account with status, objective, format, bid strategy, budget and schedule. On LinkedIn the campaign holds the targeting and the bid, and the creatives under it are the ads.
Inputs: adAccountId (required), name, type, status, +4 more. Returns: result
linkedin_get_creativeslinkedin get creativesARead-onlyIdempotent
List the creatives of a LinkedIn ad account, optionally for given campaigns. A creative is the ad itself, and it carries its own intended status, its review verdict and the reasons it is being held back.
Inputs: adAccountId (required), pageSize, pageToken, campaignIds, +2 more. Returns: result
linkedin_get_delivery_statuslinkedin get delivery statusARead-onlyIdempotent
Explain why LinkedIn ads are or are not serving, from the account down to the creative. LinkedIn keeps a user status and a system serving status side by side, and it is almost always the second one that says why nothing is running.
Inputs: adAccountId (required), campaignIds, includeCreatives. Returns: result
linkedin_get_demographicslinkedin get demographicsARead-onlyIdempotent
Break LinkedIn delivery down by professional demographics: company, company size, industry, seniority, job title, job function or location. These are the numbers LinkedIn is bought for, and they come with limits the tool states alongside the rows.
Inputs: breakdown (required), startDate (required), adAccountId (required), limit, +5 more. Returns: result
linkedin_get_entitylinkedin get entityARead-onlyIdempotent
Read one campaign group, campaign or creative and verify account ownership.
Inputs: kind (required), entityId (required), adAccountId (required). Returns: result
linkedin_get_insightslinkedin get insightsARead-onlyIdempotent
Run a LinkedIn Ads report grouped by one pivot. This is the analytics finder: one pivot, any granularity, and up to 20 fields including dateRange and pivotValues. Ratios such as CTR, CPC and CPM do not exist in the API and are computed here from the raw terms.
Inputs: startDate (required), adAccountId (required), pivot, endDate, +8 more. Returns: result
linkedin_get_medialinkedin get mediaCRead-onlyIdempotent
Refresh one image/video URL and verify library association.
Inputs: mediaId (required), adAccountId (required). Returns: result
linkedin_get_revenue_attributionlinkedin get revenue attributionARead-onlyIdempotent
Read the LinkedIn Revenue Attribution Report: pipeline and closed won revenue from the CRM, attributed to LinkedIn advertising. Only answers for accounts whose Business Manager has a CRM connected, and only over a window of 30 to 366 days.
Inputs: startDate (required), adAccountId (required), pivots, endDate, +2 more. Returns: result
linkedin_get_setup_guidelinkedin get setup guideARead-onlyIdempotent
Read account, supported formats and native LinkedIn write requirements before preparing changes.
Inputs: adAccountId (required). Returns: result
linkedin_health_checklinkedin health checkARead-onlyIdempotent
Read-only LinkedIn Ads health check. Confirms the token works, lists which configured ad accounts it can reach, checks the reporting endpoint and reports the API version header in use, without ever returning the token itself.
Inputs: adAccountId. Returns: result
linkedin_list_ad_accountslinkedin list ad accountsARead-onlyIdempotent
List the LinkedIn sponsored ad accounts configured in LINKEDIN_ADS_ACCOUNT_IDS that the authenticated member can reach, with currency, status and serving status. Accounts outside the configured list are never returned. Test accounts are excluded unless asked for.
Inputs: status, adAccountIds, includeTestAccounts. Returns: result
linkedin_list_ad_creativeslinkedin list ad creativesARead-onlyIdempotent
List the images and playable videos used by the ads of an account, with the actual ad names. Separates landing URLs from media URLs. Does not report delivery.
Inputs: adAccountId (required), adIds, limit, pageToken. Returns: result
linkedin_list_medialinkedin list mediaARead-onlyIdempotent
List account image/video library files with download URLs and native processing status; not ad performance.
Inputs: kind (required), adAccountId (required), limit, start. Returns: result
linkedin_run_statistics_reportlinkedin run statistics reportARead-onlyIdempotent
Run a LinkedIn Ads report grouped by up to three pivots at once. This is the statistics finder, the only way to cross campaign with device, or campaign group with serving location, in a single request.
Inputs: pivots (required), startDate (required), adAccountId (required), endDate, +7 more. Returns: result
linkedin_validate_querylinkedin validate queryARead-onlyIdempotent
Check a pivot and metric combination against the LinkedIn reporting rules before spending a call on it. Returns the fields that would actually be sent, the ones LinkedIn would drop, and the twenty field ceiling. Makes no request to LinkedIn.
Inputs: pivots (required), metrics (required), endDate, startDate, +1 more. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 18 tools
Most tools have distinct purposes clearly separated by resource and action, especially account, campaign, creative, delivery, and media tools. Some ambiguity remains between the reporting tools (get_insights, run_statistics_report, get_demographics) and between get_creatives and list_ad_creatives, though descriptions provide guidance.
All tool names use the linkedin_ prefix with snake_case and follow a predictable verb_noun pattern such as get_campaigns, list_media, run_statistics_report, and validate_query. Minor variations like health_check do not disrupt the overall consistency.
Eighteen tools is reasonable for a LinkedIn Ads surface covering accounts, campaigns, creatives, reporting, demographics, media, and delivery diagnostics. It is slightly heavy but each tool appears to earn its place in this complex domain.
The server provides strong read, reporting, validation, and diagnostic coverage across the LinkedIn Ads hierarchy. However, it lacks write operations such as creating, updating, pausing, or adjusting campaigns, budgets, creatives, and targeting, which are notable gaps for an ads management server.
Maintenance
Related MCP Connectors
Meta Ads MCP: read ad accounts and signal health; propose governed changes under Ask or Full.
Read-only MCP access to your DEXUN AdWhiz account: ad accounts, AI recommendations, savings.
Meta Ads MCP: Facebook and Instagram reports, campaigns, creatives, audiences. Approval on writes.
Google Ads MCP: reports, search terms, negatives, budgets, campaigns. Approval on every write.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables MCP clients to read ad account, campaign, ad group, and ad data plus performance insights, and optionally create, pause, activate, or update paused campaigns, ad groups, and ads through a secured Streamable HTTP endpoint.MIT
- AlicenseAqualityBmaintenanceEnables MCP-compatible clients to query advertising data, analyze spend, conversions, and audiences, compare campaigns, generate dashboards, and manage campaigns with optional read-only safeguards.28Apache 2.0
- AlicenseNot gradedqualityBmaintenanceEnables MCP clients to read App Store campaign and performance data and to prepare preview-first, opt-in changes for explicitly allowlisted ad accounts.354 npmApache 2.0
- AlicenseBqualityBmaintenanceEnables MCP clients to read Snapchat Ads campaigns and performance and to prepare preview-first changes for selected ad accounts, with opt-in write tools and explicit confirmation before applying updates.21328 npmApache 2.0