PilotMCP
Platforms and tools

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

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.

ParameterTypeRequiredDescription
account_idstringyesLinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:<id>).
start_datestringyesStart date YYYY-MM-DD (default: 30 days ago).
end_datestringyesEnd date YYYY-MM-DD (default: today).
time_granularitystringnoALL (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.

ParameterTypeRequiredDescription
account_idstringyesLinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:<id>).
start_datestringyesStart date YYYY-MM-DD (default: 30 days ago).
end_datestringyesEnd date YYYY-MM-DD (default: today).
time_granularitystringnoALL (default), DAILY, or MONTHLY.
pivotstringyesPivot 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.
fieldsstring[]noMetrics 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_idsstring[]noFilter by campaign IDs.
campaign_group_idsstring[]noFilter 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.

ParameterTypeRequiredDescription
account_idstringyesLinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:<id>).
start_datestringyesStart date YYYY-MM-DD (default: 30 days ago).
end_datestringyesEnd date YYYY-MM-DD (default: today).
time_granularitystringnoALL (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.

ParameterTypeRequiredDescription
account_idstringyesLinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:<id>).
campaign_idstringyesCampaign 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.

ParameterTypeRequiredDescription
account_idstringyesLinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:<id>).
campaign_group_idstringyesCampaign 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.

ParameterTypeRequiredDescription
account_idstringyesLinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:<id>).
conversion_idstringyesConversion 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.

ParameterTypeRequiredDescription
account_idstringyesLinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:<id>).
creative_idstringyesCreative 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.

ParameterTypeRequiredDescription
account_idstringnoLinkedIn 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.

ParameterTypeRequiredDescription
account_idstringyesLinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:<id>).
statusstring[]noFilter 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).

ParameterTypeRequiredDescription
account_idstringyesLinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:<id>).
statusstring[]noFilter by status: ACTIVE, PAUSED, ARCHIVED, COMPLETED, CANCELED, DRAFT. Default: ACTIVE, PAUSED.
campaign_group_idstringnoFilter 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.

ParameterTypeRequiredDescription
account_idstringyesLinkedIn 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.

ParameterTypeRequiredDescription
account_idstringyesLinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:<id>).
campaign_idsstring[]noFilter by campaign IDs.
statusesstring[]noFilter 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).

ParameterTypeRequiredDescription
account_idstringyesLinkedIn 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.

ParameterTypeRequiredDescription
account_idstringyesLinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:<id>).
campaign_group_idstringyesCampaign group ID the campaign belongs to.
namestringyesCampaign name.
objective_typestringyesBRAND_AWARENESS, ENGAGEMENT, JOB_APPLICANTS, LEAD_GENERATION, WEBSITE_CONVERSIONS, WEBSITE_VISIT, VIDEO_VIEW or TALENT_LEADS.
typestringnoSPONSORED_UPDATES (default), TEXT_AD, SPONSORED_INMAILS or DYNAMIC.
cost_typestringyesCPM, CPC or CPV.
daily_budgetnumberyesDaily budget, in the account currency.
unit_costnumbernoBid amount per cost_type unit, in the account currency (optional: automated bidding when omitted).
localestringyesCampaign locale, language_COUNTRY, e.g. fr_FR or en_US.
targeting_criteriaobjectyesLinkedIn targetingCriteria object ({ include: { and: [...] }, exclude?: {...} }).
political_intentstringyesNOT_POLITICAL or POLITICAL.
start_datestringnoStart date YYYY-MM-DD (default: today).
end_datestringnoEnd date YYYY-MM-DD (optional).
currency_codestringnoAccount 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.

ParameterTypeRequiredDescription
account_idstringyesLinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:<id>).
namestringyesCampaign group name.
start_datestringnoStart date YYYY-MM-DD (default: today).
end_datestringnoEnd date YYYY-MM-DD (optional; required by LinkedIn with a total budget).
total_budgetnumbernoTotal budget, in the account currency (optional).
currency_codestringnoAccount 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).

ParameterTypeRequiredDescription
account_idstringyesLinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:<id>).
namestringyesConversion rule name.
typestringyesConversion type, e.g. LEAD, PURCHASE, SIGN_UP, ADD_TO_CART, DOWNLOAD, INSTALL, KEY_PAGE_VIEW, OTHER.
attribution_typestringnoLAST_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.

ParameterTypeRequiredDescription
account_idstringyesLinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:<id>).
campaign_idstringyesCampaign ID the creative belongs to.
post_urnstringyesThe post to sponsor: urn:li:share:<id> or urn:li:ugcPost:<id>.
intended_statusstringnoDRAFT (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.

ParameterTypeRequiredDescription
account_idstringyesLinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:<id>).
campaign_idstringyesCampaign ID.
statusstringnoNew status: ACTIVE, PAUSED or ARCHIVED.
daily_budgetnumbernoNew daily budget, in the account currency.
total_budgetnumbernoNew total (lifetime) budget, in the account currency.
namestringnoNew campaign name.
currency_codestringnoAccount 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.

ParameterTypeRequiredDescription
account_idstringyesLinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:<id>).
campaign_group_idstringyesCampaign group ID.
statusstringnoNew status: ACTIVE, PAUSED or ARCHIVED.
total_budgetnumbernoNew total budget, in the account currency.
namestringnoNew campaign group name.
currency_codestringnoAccount 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.

ParameterTypeRequiredDescription
account_idstringyesLinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:<id>).
conversion_idstringyesConversion rule ID.
namestringnoNew name.
enabledbooleannoTurn the rule on (true) or off (false).
attribution_typestringnoLAST_TOUCH_BY_CAMPAIGN or LAST_TOUCH_BY_CONVERSION.
post_click_attribution_window_sizenumbernoPost-click window in days: 1, 7, 30 or 90.
view_through_attribution_window_sizenumbernoView-through window in days: 1, 7, 30 or 90.
valuenumbernoDefault conversion value, in the account currency.
currency_codestringnoAccount 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.

ParameterTypeRequiredDescription
account_idstringyesLinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:<id>).
creative_idstringyesCreative ID (numeric, or urn:li:sponsoredCreative:<id>).
intended_statusstringyesACTIVE, 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.

ParameterTypeRequiredDescription
account_idstringyesLinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:<id>).
campaign_idstringyesCampaign 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.

ParameterTypeRequiredDescription
account_idstringyesLinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:<id>).
campaign_group_idstringyesCampaign 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.

ParameterTypeRequiredDescription
account_idstringyesLinkedIn ad account ID (numeric, or urn:li:sponsoredAccount:<id>).
creative_idstringyesCreative ID (numeric, or urn:li:sponsoredCreative:<id>).

On this page