LinkedIn Ads MCP API reference
Every LinkedIn Ads tool the MCP server exposes, with its parameters. 30 tools, 139 metrics and 27 dimensions, on a dedicated endpoint.
View as MarkdownNo row matches.
Campaign groups, campaigns, ad creatives, image/video libraries and native reporting.
To connect another identity without replacing your existing access, open this source in the dashboard and choose Add another account. Select accounts from the combined list and save. See account scoping for selection, plan limits and reconnection.
Connection
- Platform id
linkedin_ads- Tool prefix
linkedin_- Account parameter
adAccountId- Dedicated endpoint
- https:/
/ mcp. getmcpads. com/ linkedin-ads/ mcp - Access
- Connect LinkedIn and select the advertising accounts your assistant may access. Native account roles and organization permissions apply.
- Tools
- 30, 15 of which write
- Metrics
- 139
- Dimensions
- 27
Scope requested
| Scope | Grants | Allows writes |
|---|---|---|
r_ads | Read authorized LinkedIn advertising accounts, campaigns and creatives. | No |
r_ads_reporting | Read native LinkedIn advertising performance reports. | No |
rw_ads | Manage advertising campaigns, creatives and media. Writes require a selected account, native permissions, confirmation and a paid plan. New advertising entities are created as drafts. | Yes |
r_ | Read organization information needed for advertising identities. | No |
r_ | Read organization posts and media used in advertising. | No |
w_ | Create sponsored organization content. This connector creates dark ads only, without publishing to the organic feed. | Yes |
Catalogues
- Metrics139 metrics, with the field name each one maps to.
- Dimensions27 dimensions, with their constraints.
Write tools (15)
Absent from the tool list on the Free plan. Each one previews by default and needs a second call with confirm: true.
| Tool | What it does | Kind | Discovery |
|---|---|---|---|
linkedin_ | Create an inactive (DRAFT) text or sponsored-content campaign. | Write | On demand |
linkedin_ | Create a DRAFT campaign group in a selected authorized account. | Write | On demand |
linkedin_ | Create a DRAFT sponsored image/video ad, with a dark post (feedDistribution NONE). | Write | On demand |
linkedin_ | Create a DRAFT text ad with an existing account-library image. | Write | On demand |
linkedin_ | Delete one owned DRAFT creative in the selected account. | Write | On demand |
linkedin_ | Duplicate a selected account ad into a verified campaign as DRAFT, reusing its exact content reference. | Write | On demand |
linkedin_ | Finalize a video after all signed parts were uploaded. | Write | On demand |
linkedin_ | Initialize image/video upload to selected authorized account library. | Write | On demand |
linkedin_ | Rename an owned LinkedIn ad (creative) in the selected account. | Write | On demand |
linkedin_ | Rename the selected LinkedIn ad account. | Write | On demand |
linkedin_ | Rename an owned LinkedIn campaign in the selected account. | Write | On demand |
linkedin_ | Rename an owned LinkedIn campaign group in the selected account. | Write | On demand |
linkedin_ | Rename, pause/archive or edit budget, schedule, targeting or text-ad content of an owned campaign/group/ad in the selected account. | Write | On demand |
linkedin_ | Rename or archive an owned account-library image/video. | Write | On demand |
linkedin_ | Upload one base64 file part using the signed initialization receipt. | Write | On demand |
Read tools (15)
Tools marked Announced appear in your client's tool list. The rest are reachable through search_tools and run_tool, which run the same checks.
| Tool | What it does | Kind | Discovery |
|---|---|---|---|
linkedin_ | Look up native targeting URNs such as countries by name. | Read | On demand |
linkedin_ | Read one LinkedIn ad account in full, with the members who hold a role on it. | Read | Announced |
linkedin_ | List campaign groups in a LinkedIn ad account, with budget, schedule and serving status. | Read | Announced |
linkedin_ | List campaigns in a LinkedIn ad account with status, objective, format, bid strategy, budget and schedule. | Read | Announced |
linkedin_ | List the creatives of a LinkedIn ad account, optionally for given campaigns. | Read | On demand |
linkedin_ | Explain why LinkedIn ads are or are not serving, from the account down to the creative. | Read | On demand |
linkedin_ | Break LinkedIn delivery down by professional demographics: company, company size, industry, seniority, job title, job function or location. | Read | On demand |
linkedin_ | Read one campaign group, campaign or creative and verify account ownership. | Read | On demand |
linkedin_ | Run a LinkedIn Ads report grouped by one pivot. | Read | Announced |
linkedin_ | Refresh one image/video URL and verify library association. | Read | On demand |
linkedin_ | Read the LinkedIn Revenue Attribution Report: pipeline and closed won revenue from the CRM, attributed to LinkedIn advertising. | Read | On demand |
linkedin_ | Read account, supported formats and native LinkedIn write requirements before preparing changes. | Read | Announced |
linkedin_ | Gallery of ad-linked images and playable videos with actual ad names. | Read | Announced |
linkedin_ | List account image/video library files with download URLs and native processing status; not ad performance. | Read | On demand |
linkedin_ | Run a LinkedIn Ads report grouped by up to three pivots at once. | Read | On demand |
MCP resources
Read these with resources/read for machine readable metadata about the source.
| Name | URI |
|---|---|
| linkedin-manifest | linkedin:/ |
| linkedin-metrics | linkedin:/ |
| linkedin-pivots | linkedin:/ |
| linkedin-reporting-rules | linkedin:/ |
| linkedin-targeting | linkedin:/ |
| linkedin-recipes | linkedin:/ |
| linkedin-read-endpoints | linkedin:/ |
Manage your ads from your AI assistant
Start for free
Free with 1 ad account, no card. Pro is free for 7 days.