# LinkedIn Ads

Source: https://pilot.braike.com/en/docs/regies/linkedin

The 24 tools Pilot MCP serves for LinkedIn Ads: 13 read-only, and 11 that write with the €29 plan, taken from the server.

Pilot MCP serves **13 read-only tools** for LinkedIn Ads, on every plan. With the €29 plan, it also serves **8** that create or change and **3** that delete. Their names start with `linkedin_`.

<Callout title="What each entry shows">
The name, description and parameters come from the list the server serves to your assistant (`tools/list`). Descriptions are in English: this is the text your assistant receives. Your assistant never fills in platform credentials: Pilot adds them on each call.
</Callout>

<Callout title="Writing and deleting">
Write tools are only served with the €29 plan: your assistant creates, changes, pauses and deletes there, with no access level to pick when you connect. On the free plan, it does not see them. A change that sets an object to deleted or archived counts as a deletion, and a deletion targets one object at a time. Changes apply directly on the ad platform: Pilot reads the object from the platform before and after the write, and logs it in your workspace. See [Read and write](/en/docs/limites-et-forfaits#ecritures).
</Callout>

## Tool families [#familles]

| Family | Tools |
| --- | ---: |
| [Other tools](#autres) | 13 |
| [Create and change (€29)](#modification) | 8 |
| [Delete (€29)](#suppression) | 3 |

## Other tools [#autres]

### `linkedin_linkedin_ads_account_performance` [#linkedin_linkedin_ads_account_performance]

**LinkedIn Ads: Account Performance** · read-only · idempotent

Get account-level aggregate performance metrics for a date range. Good for high-level summaries.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | yes | LinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:\<id\>). |
| `start_date` | `string` | yes | Start date YYYY-MM-DD (default: 30 days ago). |
| `end_date` | `string` | yes | End date YYYY-MM-DD (default: today). |
| `time_granularity` | `string` | no | ALL (default), DAILY, or MONTHLY. |

### `linkedin_linkedin_ads_analytics` [#linkedin_linkedin_ads_analytics]

**LinkedIn Ads: Analytics** · read-only · idempotent

Flexible analytics query with one pivot, custom fields and filters. Use for B2B demographic breakdowns (MEMBER\_JOB\_FUNCTION, MEMBER\_SENIORITY, MEMBER\_INDUSTRY, MEMBER\_COMPANY\_SIZE, MEMBER\_COUNTRY\_V2...), device splits or creative performance. Demographic values are approximate and URNs.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | yes | LinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:\<id\>). |
| `start_date` | `string` | yes | Start date YYYY-MM-DD (default: 30 days ago). |
| `end_date` | `string` | yes | End date YYYY-MM-DD (default: today). |
| `time_granularity` | `string` | no | ALL (default), DAILY, or MONTHLY. |
| `pivot` | `string` | yes | Pivot dimension, one of: ACCOUNT, CAMPAIGN\_GROUP, CAMPAIGN, CREATIVE, COMPANY, CONVERSION, CONVERSATION\_NODE, CONVERSATION\_NODE\_OPTION\_INDEX, SERVING\_LOCATION, CARD\_INDEX, PLACEMENT\_NAME, IMPRESSION\_DEVICE\_TYPE, EVENT\_STAGE, OBJECTIVE\_TYPE, CAMPAIGN\_TYPE, MEMBER\_COMPANY\_SIZE, MEMBER\_INDUSTRY, MEMBER\_SENIORITY, MEMBER\_JOB\_TITLE, MEMBER\_JOB\_FUNCTION, MEMBER\_COUNTRY\_V2, MEMBER\_REGION\_V2, MEMBER\_COMPANY, MEMBER\_COUNTY. |
| `fields` | `string[]` | no | Metrics to return (18 at most: LinkedIn counts dateRange and pivotValues in its 20-field cap). There is no costPerLead metric: compute costInLocalCurrency / oneClickLeads. Default: impressions, clicks, costInLocalCurrency, landingPageClicks, oneClickLeads, oneClickLeadFormOpens, externalWebsiteConversions, conversionValueInLocalCurrency, totalEngagements, videoViews, videoCompletions. |
| `campaign_ids` | `string[]` | no | Filter by campaign IDs. |
| `campaign_group_ids` | `string[]` | no | Filter by campaign group IDs. |

### `linkedin_linkedin_ads_campaign_performance` [#linkedin_linkedin_ads_campaign_performance]

**LinkedIn Ads: Campaign Performance** · read-only · idempotent

Get campaign-level performance metrics (impressions, clicks, spend, leads, website conversions, engagement, video views) for a date range.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | yes | LinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:\<id\>). |
| `start_date` | `string` | yes | Start date YYYY-MM-DD (default: 30 days ago). |
| `end_date` | `string` | yes | End date YYYY-MM-DD (default: today). |
| `time_granularity` | `string` | no | ALL (default), DAILY, or MONTHLY. |

### `linkedin_linkedin_ads_get_campaign` [#linkedin_linkedin_ads_get_campaign]

**LinkedIn Ads: Get Campaign** · read-only · idempotent

Get one LinkedIn campaign in full: status, objective, budget, bidding, schedule and targeting criteria.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | yes | LinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:\<id\>). |
| `campaign_id` | `string` | yes | Campaign ID (numeric, or urn:li:sponsoredCampaign:\<id\>). |

### `linkedin_linkedin_ads_get_campaign_group` [#linkedin_linkedin_ads_get_campaign_group]

**LinkedIn Ads: Get Campaign Group** · read-only · idempotent

Get one LinkedIn campaign group in full: name, status, run schedule and total budget.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | yes | LinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:\<id\>). |
| `campaign_group_id` | `string` | yes | Campaign group ID (numeric, or urn:li:sponsoredCampaignGroup:\<id\>). |

### `linkedin_linkedin_ads_get_conversion_action` [#linkedin_linkedin_ads_get_conversion_action]

**LinkedIn Ads: Get Conversion Action** · read-only · idempotent

Get one conversion tracking rule of an ad account: name, type, enabled, attribution type and windows, value.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | yes | LinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:\<id\>). |
| `conversion_id` | `string` | yes | Conversion rule ID (numeric, or urn:lla:llaPartnerConversion:\<id\>). |

### `linkedin_linkedin_ads_get_creative` [#linkedin_linkedin_ads_get_creative]

**LinkedIn Ads: Get Creative** · read-only · idempotent

Get one LinkedIn creative (ad): its campaign, intendedStatus, isServing, review status and content reference.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | yes | LinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:\<id\>). |
| `creative_id` | `string` | yes | Creative ID (numeric, or urn:li:sponsoredCreative:\<id\>). |

### `linkedin_linkedin_ads_list_accounts` [#linkedin_linkedin_ads_list_accounts]

**LinkedIn Ads: List Accounts** · read-only · idempotent

List the LinkedIn ad accounts (active and draft) the connected user can access, with currency and status.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | no | LinkedIn Ads account to use when the workspace has several, as returned by the account listing tool. Default: the first account linked to the workspace. |

### `linkedin_linkedin_ads_list_campaign_groups` [#linkedin_linkedin_ads_list_campaign_groups]

**LinkedIn Ads: List Campaign Groups** · read-only · idempotent

List campaign groups for a LinkedIn ad account. In Pilot's vocabulary a LinkedIn campaign group is a CAMPAIGN.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | yes | LinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:\<id\>). |
| `status` | `string[]` | no | Filter by status: ACTIVE, PAUSED, ARCHIVED, CANCELED, DRAFT (COMPLETED does not exist for campaign groups and is rejected). Default: ACTIVE, PAUSED. |

### `linkedin_linkedin_ads_list_campaigns` [#linkedin_linkedin_ads_list_campaigns]

**LinkedIn Ads: List Campaigns** · read-only · idempotent

List campaigns for a LinkedIn ad account, with optional status and campaign group filters. A LinkedIn campaign carries budget, bidding, objective and targeting (an ad group in Pilot's vocabulary).

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | yes | LinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:\<id\>). |
| `status` | `string[]` | no | Filter by status: ACTIVE, PAUSED, ARCHIVED, COMPLETED, CANCELED, DRAFT. Default: ACTIVE, PAUSED. |
| `campaign_group_id` | `string` | no | Filter by campaign group ID. |

### `linkedin_linkedin_ads_list_conversion_actions` [#linkedin_linkedin_ads_list_conversion_actions]

**LinkedIn Ads: List Conversion Actions** · read-only · idempotent

List conversion tracking rules of an ad account.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | yes | LinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:\<id\>). |

### `linkedin_linkedin_ads_list_creatives` [#linkedin_linkedin_ads_list_creatives]

**LinkedIn Ads: List Creatives** · read-only · idempotent

List the creatives (ads) of a LinkedIn ad account, optionally for given campaigns and statuses. Returns intendedStatus, isServing, review status and the content reference.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | yes | LinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:\<id\>). |
| `campaign_ids` | `string[]` | no | Filter by campaign IDs. |
| `statuses` | `string[]` | no | Filter by intendedStatus: ACTIVE, PAUSED, DRAFT, ARCHIVED, CANCELED. Default: all. |

### `linkedin_linkedin_ads_manage_insight_tag` [#linkedin_linkedin_ads_manage_insight_tag]

**LinkedIn Ads: Manage Insight Tag** · read-only · idempotent

Read the LinkedIn Insight Tag(s) of an ad account (read-only despite the name).

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | yes | LinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:\<id\>). |

## Create and change (€29) [#modification]

Served with the €29 plan.

### `linkedin_linkedin_ads_create_campaign` [#linkedin_linkedin_ads_create_campaign]

**LinkedIn Ads: Create Campaign** · create or change, €29 plan · creates an object on each call

Create a LinkedIn campaign in a campaign group, always as DRAFT: it serves nothing until linkedin\_ads\_update\_campaign sets it ACTIVE. targeting\_criteria uses geo URNs (urn:li:geo:...) only. political\_intent is required by LinkedIn for campaigns that target the EU. Re-reads the campaign and returns it.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | yes | LinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:\<id\>). |
| `campaign_group_id` | `string` | yes | Campaign group ID the campaign belongs to. |
| `name` | `string` | yes | Campaign name. |
| `objective_type` | `string` | yes | BRAND\_AWARENESS, ENGAGEMENT, JOB\_APPLICANTS, LEAD\_GENERATION, WEBSITE\_CONVERSIONS, WEBSITE\_VISIT, VIDEO\_VIEW or TALENT\_LEADS. |
| `type` | `string` | no | SPONSORED\_UPDATES (default), TEXT\_AD, SPONSORED\_INMAILS or DYNAMIC. |
| `cost_type` | `string` | yes | CPM, CPC or CPV. |
| `daily_budget` | `number` | yes | Daily budget, in the account currency. |
| `unit_cost` | `number` | no | Bid amount per cost\_type unit, in the account currency (optional: automated bidding when omitted). |
| `locale` | `string` | yes | Campaign locale, language\_COUNTRY, e.g. fr\_FR or en\_US. |
| `targeting_criteria` | `object` | yes | LinkedIn targetingCriteria object (\{ include: \{ and: \[...\] \}, exclude?: \{...\} \}). |
| `political_intent` | `string` | yes | NOT\_POLITICAL or POLITICAL. |
| `start_date` | `string` | no | Start date YYYY-MM-DD (default: today). |
| `end_date` | `string` | no | End date YYYY-MM-DD (optional). |
| `currency_code` | `string` | no | Account currency (read from the account when omitted). |

### `linkedin_linkedin_ads_create_campaign_group` [#linkedin_linkedin_ads_create_campaign_group]

**LinkedIn Ads: Create Campaign Group** · create or change, €29 plan · creates an object on each call

Create a LinkedIn campaign group, always as DRAFT: it serves nothing until linkedin\_ads\_update\_campaign\_group sets it ACTIVE. Re-reads the group and returns it.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | yes | LinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:\<id\>). |
| `name` | `string` | yes | Campaign group name. |
| `start_date` | `string` | no | Start date YYYY-MM-DD (default: today). |
| `end_date` | `string` | no | End date YYYY-MM-DD (optional; required by LinkedIn with a total budget). |
| `total_budget` | `number` | no | Total budget, in the account currency (optional). |
| `currency_code` | `string` | no | Account currency (read from the account when omitted). |

### `linkedin_linkedin_ads_create_conversion_action` [#linkedin_linkedin_ads_create_conversion_action]

**LinkedIn Ads: Create Conversion Action** · create or change, €29 plan · creates an object on each call

Create a new conversion tracking rule for an ad account. LinkedIn cannot delete a conversion rule afterwards: disable it with linkedin\_ads\_update\_conversion\_action (enabled: false).

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | yes | LinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:\<id\>). |
| `name` | `string` | yes | Conversion rule name. |
| `type` | `string` | yes | Conversion type, e.g. LEAD, PURCHASE, SIGN\_UP, ADD\_TO\_CART, DOWNLOAD, INSTALL, KEY\_PAGE\_VIEW, OTHER. |
| `attribution_type` | `string` | no | LAST\_TOUCH\_BY\_CAMPAIGN (default) or LAST\_TOUCH\_BY\_CONVERSION. |

### `linkedin_linkedin_ads_create_creative` [#linkedin_linkedin_ads_create_creative]

**LinkedIn Ads: Create Creative** · create or change, €29 plan · creates an object on each call

Create a LinkedIn creative (ad) in a campaign from an existing organization post (urn:li:share:\<id\> or urn:li:ugcPost:\<id\>). intended\_status is DRAFT (default) or PAUSED; set it ACTIVE afterwards with linkedin\_ads\_update\_creative\_status. Re-reads the creative and returns it.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | yes | LinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:\<id\>). |
| `campaign_id` | `string` | yes | Campaign ID the creative belongs to. |
| `post_urn` | `string` | yes | The post to sponsor: urn:li:share:\<id\> or urn:li:ugcPost:\<id\>. |
| `intended_status` | `string` | no | DRAFT (default) or PAUSED. |

### `linkedin_linkedin_ads_update_campaign` [#linkedin_linkedin_ads_update_campaign]

**LinkedIn Ads: Update Campaign** · create or change, €29 plan · creates an object on each call

Update a LinkedIn campaign: status (ACTIVE, PAUSED, ARCHIVED), daily or total budget, or name. Re-reads the campaign afterwards and returns its new state.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | yes | LinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:\<id\>). |
| `campaign_id` | `string` | yes | Campaign ID. |
| `status` | `string` | no | New status: ACTIVE, PAUSED or ARCHIVED. |
| `daily_budget` | `number` | no | New daily budget, in the account currency. |
| `total_budget` | `number` | no | New total (lifetime) budget, in the account currency. |
| `name` | `string` | no | New campaign name. |
| `currency_code` | `string` | no | Account currency (read from the account when omitted). |

### `linkedin_linkedin_ads_update_campaign_group` [#linkedin_linkedin_ads_update_campaign_group]

**LinkedIn Ads: Update Campaign Group** · create or change, €29 plan · creates an object on each call

Update a LinkedIn campaign group: status (ACTIVE, PAUSED, ARCHIVED), total budget, or name. Re-reads the group afterwards and returns its new state.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | yes | LinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:\<id\>). |
| `campaign_group_id` | `string` | yes | Campaign group ID. |
| `status` | `string` | no | New status: ACTIVE, PAUSED or ARCHIVED. |
| `total_budget` | `number` | no | New total budget, in the account currency. |
| `name` | `string` | no | New campaign group name. |
| `currency_code` | `string` | no | Account currency (read from the account when omitted). |

### `linkedin_linkedin_ads_update_conversion_action` [#linkedin_linkedin_ads_update_conversion_action]

**LinkedIn Ads: Update Conversion Action** · create or change, €29 plan · creates an object on each call

Update a conversion tracking rule of the ad account: name, enabled, attribution\_type, attribution windows, value. The rule is read first and must belong to account\_id. Re-reads it afterwards and returns its new state.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | yes | LinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:\<id\>). |
| `conversion_id` | `string` | yes | Conversion rule ID. |
| `name` | `string` | no | New name. |
| `enabled` | `boolean` | no | Turn the rule on (true) or off (false). |
| `attribution_type` | `string` | no | LAST\_TOUCH\_BY\_CAMPAIGN or LAST\_TOUCH\_BY\_CONVERSION. |
| `post_click_attribution_window_size` | `number` | no | Post-click window in days: 1, 7, 30 or 90. |
| `view_through_attribution_window_size` | `number` | no | View-through window in days: 1, 7, 30 or 90. |
| `value` | `number` | no | Default conversion value, in the account currency. |
| `currency_code` | `string` | no | Account currency (read from the account when omitted). |

### `linkedin_linkedin_ads_update_creative_status` [#linkedin_linkedin_ads_update_creative_status]

**LinkedIn Ads: Update Creative Status** · create or change, €29 plan · creates an object on each call

Change the intendedStatus of a LinkedIn creative (ad): ACTIVE, PAUSED, ARCHIVED or CANCELED. A creative under review cannot be paused.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | yes | LinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:\<id\>). |
| `creative_id` | `string` | yes | Creative ID (numeric, or urn:li:sponsoredCreative:\<id\>). |
| `intended_status` | `string` | yes | ACTIVE, PAUSED, ARCHIVED or CANCELED. |

## Delete (€29) [#suppression]

Served with the €29 plan. A deletion targets one object at a time.

### `linkedin_linkedin_ads_delete_campaign` [#linkedin_linkedin_ads_delete_campaign]

**LinkedIn Ads: Delete Campaign** · delete, €29 plan, one object at a time · creates an object on each call

Delete a LinkedIn campaign that is still DRAFT. Any other status is refused before anything is sent: archive it with linkedin\_ads\_update\_campaign instead. Re-reads it afterwards to confirm it is gone.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | yes | LinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:\<id\>). |
| `campaign_id` | `string` | yes | Campaign ID. |

### `linkedin_linkedin_ads_delete_campaign_group` [#linkedin_linkedin_ads_delete_campaign_group]

**LinkedIn Ads: Delete Campaign Group** · delete, €29 plan, one object at a time · creates an object on each call

Delete a LinkedIn campaign group that is still DRAFT. Any other status is refused before anything is sent: archive it with linkedin\_ads\_update\_campaign\_group instead. Re-reads it afterwards to confirm it is gone.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | yes | LinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:\<id\>). |
| `campaign_group_id` | `string` | yes | Campaign group ID. |

### `linkedin_linkedin_ads_delete_creative` [#linkedin_linkedin_ads_delete_creative]

**LinkedIn Ads: Delete Creative** · delete, €29 plan, one object at a time · creates an object on each call

Delete a LinkedIn creative (ad) whose intendedStatus is still DRAFT. Any other status is refused before anything is sent: archive or cancel it with linkedin\_ads\_update\_creative\_status instead. Re-reads it afterwards to confirm it is gone.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | yes | LinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:\<id\>). |
| `creative_id` | `string` | yes | Creative ID (numeric, or urn:li:sponsoredCreative:\<id\>). |
