# LinkedIn Ads setup

> Connect LinkedIn Ads to Claude, ChatGPT, Codex or any MCP client, what to ask it once it is connected, and the 25 tools behind the answers.

[Guides](https://www.getmcpads.com/guides)

## For you

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.

## Connect it

1. Open the dashboard and choose this platform.
2. Approve the consent screen. The gateway stores an encrypted refresh token, never a password.
3. Tick the accounts to expose. Nothing is readable until you do.
4. Paste the endpoint into your assistant, or use the shared one for every platform at once.

LinkedIn Ads on its own endpoint

```text
https://mcp.getmcpads.com/linkedin-ads/mcp
```

## What to ask

```text

```

## What answers each one

| Question | Tools |
| --- | --- |

## What it can change

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.

> **Warning** 11 write tools, absent from the tool list on the Free plan. Each one previews by default and needs a second call with confirm before anything changes.

- [LinkedIn Ads reference](https://www.getmcpads.com/docs/sources/linkedin-ads): All 25 tools, with their parameters.
- [Metrics](https://www.getmcpads.com/docs/sources/linkedin-ads/metrics): 139 metrics you can request.
- [Dimensions](https://www.getmcpads.com/docs/sources/linkedin-ads/dimensions): 27 dimensions and report attributes.
- [Skills](https://www.getmcpads.com/skills): 0 operating procedures use this source.

## For your agent

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

|  |  |
| --- | --- |
| Platform id | `linkedin_ads` |
| Tool prefix | `linkedin_` |
| Account parameter | `adAccountId` |
| Dedicated endpoint | https://mcp.getmcpads.com/linkedin-ads/mcp |
| Tools | 25, 11 of which write |
| Announced by default | `linkedin_get_account_details`, `linkedin_get_campaign_groups`, `linkedin_get_campaigns`, `linkedin_get_insights`, `linkedin_get_setup_guide`, `linkedin_list_ad_creatives` |
| Metrics | 139, see /docs/sources/linkedin-ads/metrics |
| Dimensions | 27, see /docs/sources/linkedin-ads/dimensions |

## Scope requested from the platform

| 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 |

## Reaching a tool that is not announced

```text
search_tools({ task: "..." })      find it
describe_tool({ name: "..." })     read its schema
run_tool({ name, args })           execute, with the same checks
```

## What will refuse you

- An account not ticked by the owner. Call `list_accounts` and use a `adAccountId` from it.
- A write on a plan without writes. The tool is absent from the list and refused if called anyway.
- A write without `confirm: true` returns a preview and applies nothing. That is not an error.
- A call to this platform on another platform's dedicated endpoint. The refusal names the URL that serves it.

## Questions this source answers

| Question | Tools, in order |
| --- | --- |

---

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