# LinkedIn Ads

> Every LinkedIn Ads tool the MCP server exposes, with its parameters. 25 tools, 139 metrics and 27 dimensions, on a dedicated endpoint.

[Documentation](https://www.getmcpads.com/docs) / [Sources](https://www.getmcpads.com/docs/sources)

Campaign groups, campaigns, ad creatives, image/video libraries and native reporting.

> **Note** Advertising API Development tier. Test-account writes only; Standard access is not yet approved.

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 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. This preview restricts writes to test accounts and requires confirmation and a paid plan. | Yes |
| `r_organization_admin` | Read organization information needed for advertising identities. | No |
| `r_organization_social` | Read organization posts and media used in advertising. | No |
| `w_organization_social` | Create sponsored organization content. This connector creates dark ads only, without publishing to the organic feed. | Yes |

> **Note** What the gateway can change here: Development preview: create and edit test campaigns and ads, upload image/video assets and update media-library names. Confirmation and a paid plan required. Production writes remain disabled.

## Catalogues

- [Metrics](https://www.getmcpads.com/docs/sources/linkedin-ads/metrics): 139 metrics, with the field name each one maps to.
- [Dimensions](https://www.getmcpads.com/docs/sources/linkedin-ads/dimensions): 27 dimensions, with their constraints.

## Write tools (11)

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_campaign`](https://www.getmcpads.com/docs/sources/linkedin-ads/tools/linkedin_create_campaign) | Create an inactive (DRAFT) text or sponsored-content campaign. | Write | On demand |
| [`linkedin_create_campaign_group`](https://www.getmcpads.com/docs/sources/linkedin-ads/tools/linkedin_create_campaign_group) | Create a DRAFT campaign group in a selected test account. | Write | On demand |
| [`linkedin_create_media_ad`](https://www.getmcpads.com/docs/sources/linkedin-ads/tools/linkedin_create_media_ad) | Create a DRAFT sponsored image/video ad, with a dark post (feedDistribution NONE). | Write | On demand |
| [`linkedin_create_text_ad`](https://www.getmcpads.com/docs/sources/linkedin-ads/tools/linkedin_create_text_ad) | Create a DRAFT text ad with an existing account-library image. | Write | On demand |
| [`linkedin_delete_draft_ad`](https://www.getmcpads.com/docs/sources/linkedin-ads/tools/linkedin_delete_draft_ad) | Delete one owned DRAFT test creative. | Write | On demand |
| [`linkedin_duplicate_ad`](https://www.getmcpads.com/docs/sources/linkedin-ads/tools/linkedin_duplicate_ad) | Duplicate a selected account ad into a verified campaign as DRAFT, reusing its exact content reference. | Write | On demand |
| [`linkedin_finalize_upload`](https://www.getmcpads.com/docs/sources/linkedin-ads/tools/linkedin_finalize_upload) | Finalize a video after all signed parts were uploaded. | Write | On demand |
| [`linkedin_initialize_upload`](https://www.getmcpads.com/docs/sources/linkedin-ads/tools/linkedin_initialize_upload) | Initialize image/video upload to selected test account library. | Write | On demand |
| [`linkedin_update_entity`](https://www.getmcpads.com/docs/sources/linkedin-ads/tools/linkedin_update_entity) | Rename, pause/archive or edit budget, schedule, targeting or text-ad content of an owned test campaign/group/ad. | Write | On demand |
| [`linkedin_update_media`](https://www.getmcpads.com/docs/sources/linkedin-ads/tools/linkedin_update_media) | Rename or archive an owned account-library image/video. | Write | On demand |
| [`linkedin_upload_part`](https://www.getmcpads.com/docs/sources/linkedin-ads/tools/linkedin_upload_part) | Upload one base64 file part using the signed initialization receipt. | Write | On demand |

## Read tools (14)

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_find_targeting`](https://www.getmcpads.com/docs/sources/linkedin-ads/tools/linkedin_find_targeting) | Look up native targeting URNs such as countries by name. | Read | On demand |
| [`linkedin_get_account_details`](https://www.getmcpads.com/docs/sources/linkedin-ads/tools/linkedin_get_account_details) | Read one LinkedIn ad account in full, with the members who hold a role on it. | Read | Announced |
| [`linkedin_get_campaign_groups`](https://www.getmcpads.com/docs/sources/linkedin-ads/tools/linkedin_get_campaign_groups) | List campaign groups in a LinkedIn ad account, with budget, schedule and serving status. | Read | Announced |
| [`linkedin_get_campaigns`](https://www.getmcpads.com/docs/sources/linkedin-ads/tools/linkedin_get_campaigns) | List campaigns in a LinkedIn ad account with status, objective, format, bid strategy, budget and schedule. | Read | Announced |
| [`linkedin_get_creatives`](https://www.getmcpads.com/docs/sources/linkedin-ads/tools/linkedin_get_creatives) | List the creatives of a LinkedIn ad account, optionally for given campaigns. | Read | On demand |
| [`linkedin_get_delivery_status`](https://www.getmcpads.com/docs/sources/linkedin-ads/tools/linkedin_get_delivery_status) | Explain why LinkedIn ads are or are not serving, from the account down to the creative. | Read | On demand |
| [`linkedin_get_demographics`](https://www.getmcpads.com/docs/sources/linkedin-ads/tools/linkedin_get_demographics) | Break LinkedIn delivery down by professional demographics: company, company size, industry, seniority, job title, job function or location. | Read | On demand |
| [`linkedin_get_entity`](https://www.getmcpads.com/docs/sources/linkedin-ads/tools/linkedin_get_entity) | Read one campaign group, campaign or creative and verify account ownership. | Read | On demand |
| [`linkedin_get_insights`](https://www.getmcpads.com/docs/sources/linkedin-ads/tools/linkedin_get_insights) | Run a LinkedIn Ads report grouped by one pivot. | Read | Announced |
| [`linkedin_get_media`](https://www.getmcpads.com/docs/sources/linkedin-ads/tools/linkedin_get_media) | Refresh one image/video URL and verify library association. | Read | On demand |
| [`linkedin_get_setup_guide`](https://www.getmcpads.com/docs/sources/linkedin-ads/tools/linkedin_get_setup_guide) | Read account and LinkedIn Development preview constraints before writes. | Read | Announced |
| [`linkedin_list_ad_creatives`](https://www.getmcpads.com/docs/sources/linkedin-ads/tools/linkedin_list_ad_creatives) | Gallery of ad-linked images and playable videos with actual ad names. | Read | Announced |
| [`linkedin_list_media`](https://www.getmcpads.com/docs/sources/linkedin-ads/tools/linkedin_list_media) | List account image/video library files with download URLs and native processing status; not ad performance. | Read | On demand |
| [`linkedin_run_statistics_report`](https://www.getmcpads.com/docs/sources/linkedin-ads/tools/linkedin_run_statistics_report) | 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://manifest` |
| linkedin-metrics | `linkedin://metrics` |
| linkedin-pivots | `linkedin://pivots` |
| linkedin-reporting-rules | `linkedin://reporting-rules` |
| linkedin-targeting | `linkedin://targeting` |
| linkedin-recipes | `linkedin://recipes` |
| linkedin-read-endpoints | `linkedin://read-endpoints` |

---

This page as HTML: https://www.getmcpads.com/docs/sources/linkedin-ads
Every page under /docs is available as Markdown: append `.md`, or send `Accept: text/markdown`.