LinkedIn Ads MCP API reference
Every LinkedIn Ads tool the MCP server exposes, with its parameters. 25 tools, 139 metrics and 27 dimensions, on a dedicated endpoint.
38 rows
Campaign groups, campaigns, ad creatives, image/video libraries and native reporting.
Connection
- Platform id
linkedin_ads- Tool prefix
linkedin_- Account parameter
adAccountId- Dedicated endpoint
- https:/
/ mcp. getmcpads. com/ linkedin-ads/ mcp - Access
- Advertising API Development tier. Test-account writes only; Standard access is not yet approved.
- Tools
- 25, 11 of which write
- Metrics
- 139
- Dimensions
- 27
Scope requestedLink to this section
| 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. This preview restricts writes to test accounts and requires confirmation and a paid plan. | 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 |
CataloguesLink to this section
Write tools (11)Link to this section
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 test 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 test creative. | 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 test account library. | Write | On demand |
linkedin_ | Rename, pause/archive or edit budget, schedule, targeting or text-ad content of an owned test campaign/group/ad. | 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 (14)Link to this section
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 account and LinkedIn Development preview constraints before writes. | 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 resourcesLink to this section
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:/ |