LinkedIn Ads
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_.
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.
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.
Tool families
| Family | Tools |
|---|---|
| Other tools | 13 |
| Create and change (€29) | 8 |
| Delete (€29) | 3 |
Other tools
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 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 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 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 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 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 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 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 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 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 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 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 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)
Served with the €29 plan.
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 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 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 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 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 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 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 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)
Served with the €29 plan. A deletion targets one object at a time.
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 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 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>). |