LinkedIn Ads: MCP tool reference
The Valkiria MCP server at https://valkiria.pro/mcp gives a connected assistant 25 tools for ad accounts, campaign groups, campaigns and creatives in LinkedIn Ads. 12 of them only read. The assistant picks the tool itself; this page lists what exists, under the names it reports in its tool calls.
01
Tools that read (12)
These only return data. They are not counted against the monthly allowance.
- linkedin_list_ads: Ads (creatives) of one LinkedIn campaign, live from LinkedIn, with lifetime impressions, clicks, spend and conversions per ad
- linkedin_list_accounts: LinkedIn ad accounts connected to Valkiria by the caller, from the last sync: provider id, name, currency, status, the organization (company page) the account belongs to when LinkedIn reported it, and the last sync time. Use the account id in the other linkedin_ tools. Read-only.
- linkedin_list_campaign_groups: Campaign groups of one LinkedIn ad account, live from LinkedIn: id, name, status, total budget (account currency, as LinkedIn reports it) and schedule. A campaign always belongs to a group; use a group id with linkedin_add_campaign. Read-only.
- linkedin_list_campaigns: Campaigns of one LinkedIn ad account, live from LinkedIn (active, paused and draft), optionally of one campaign group: id, name, status, type, objective, cost type, daily and total budget and bid in the account currency, schedule and group. For metrics use linkedin_campaign_performance. Read-only.
- linkedin_campaign_performance: LinkedIn campaigns with their metrics for the period, from the same dated facts the Analytics screen shows: spend (account currency), impressions, clicks, CTR, conversions and cost per conversion, per campaign (providerCampaignId is the LinkedIn campaign id). recordedDays below requestedDays means some days are not synced yet. Provider facts carry no revenue: revenue and roas are null, not zero. Read-only.
- linkedin_campaign_structure: One LinkedIn campaign read live: status, type, objective, cost type, daily and total budget and bid (account currency), schedule, its campaign group, and its ads (creatives) with status, review status, serving holds and lifetime impressions, clicks, spend and conversions per ad. Read-only.
- linkedin_creative_performance: Lifetime performance per ad (creative) of one LinkedIn campaign, live from LinkedIn: impressions, clicks, spend (account currency), website conversions, lead-form leads, with CTR and cost per click computed from them. Sorted by spend. A missing creative had no delivery. Read-only.
- linkedin_campaign_targeting: Current targeting of one LinkedIn campaign, live, as facets with URN and name: locations, industries, jobFunctions, seniorities, staffCountRanges, interfaceLocales (a "!" prefix marks an excluded facet). hasOtherCriteria=true means the campaign also targets facets set in Campaign Manager (titles, skills, audiences) that are kept on every change. Use it as the base for linkedin_update_campaign_targeting. Read-only.
- linkedin_targeting_search: LinkedIn's own targeting catalogue for one facet: the full list (industries, jobFunctions, seniorities, staffCountRanges, interfaceLocales) or typeahead matches for query (locations need a query of 2+ characters). Returns URNs and names to use in linkedin_update_campaign_targeting or linkedin_add_campaign. Read-only.
- linkedin_list_conversions: Conversion rules of one LinkedIn ad account, live: name, type, method (Insight Tag or Conversions API), whether enabled, attribution windows in days and when LinkedIn last received a signal. A rule that never fired has lastCallbackAt null. Read-only.
- linkedin_wasted_spend: LinkedIn campaigns that spent money in the period without a single conversion, from the dated analytics facts, with each one's share of total spend. minSpend filters noise (account currency, default 0). Zero conversions only means LinkedIn attributed none: check linkedin_list_conversions before pausing. Provider facts carry no revenue: revenue and roas are null, not zero. Read-only.
- linkedin_engagement_metrics: Engagement per campaign of one LinkedIn ad account for the period, live from LinkedIn reporting: impressions, clicks, likes, comments, shares, follows, video views and completions, spend (account currency) and engagement rate = (clicks + likes + comments + shares + follows) / impressions. Read-only.
02
Tools that change or generate (13)
A change requested through these tools follows the safety rules below: it is a proposal unless the write policy you set for the account allows it.
- linkedin_create_draft: Create a LinkedIn campaign group, campaign or ad as a DRAFT in the ad account. Drafts do not deliver or spend; a person launches them in Valkiria.
- linkedin_change: Pause or resume a LinkedIn campaign or ad, or set a campaign daily budget. Goes through the write policy: applied when it allows, otherwise queued for approval on the Approvals page. Resuming or raising a budget can start spending.
- linkedin_pause_campaign: Propose pausing a LinkedIn campaign. Pausing stops its spend and can be undone. Nothing changes in the ad account: this creates a proposal with a before-snapshot and returns proposal_id and approval_url; the owner approves or rejects it in Valkiria.
- linkedin_resume_campaign: Propose resuming a paused LinkedIn campaign. Resuming starts spend again, so it always waits for the owner. Drafts cannot be launched this way. Nothing changes in the ad account: this creates a proposal with a before-snapshot and returns proposal_id and approval_url; the owner approves or rejects it in Valkiria.
- linkedin_pause_creative: Propose pausing a LinkedIn ad (creative). Pausing stops its spend and can be undone. Nothing changes in the ad account: this creates a proposal with a before-snapshot and returns proposal_id and approval_url; the owner approves or rejects it in Valkiria.
- linkedin_resume_creative: Propose resuming a paused LinkedIn ad (creative). Resuming starts spend again, so it always waits for the owner. Drafts cannot be launched this way. Nothing changes in the ad account: this creates a proposal with a before-snapshot and returns proposal_id and approval_url; the owner approves or rejects it in Valkiria.
- linkedin_update_campaign_budget: Propose a new daily or total (lifetime) budget for a LinkedIn campaign. The amount is in the ad account currency in normal units and is sent to LinkedIn as a decimal amount with the currency code, never in minor units; currencies without decimals (JPY, KRW…) take whole amounts. The campaign must already have a budget of that type. Undo restores the previous amount. Nothing changes in the ad account: this creates a proposal with a before-snapshot and returns proposal_id and approval_url; the owner approves or rejects it in Valkiria.
- linkedin_update_campaign_schedule: Propose a new start and/or end time for a LinkedIn campaign. endTime=null removes the end date, so the campaign runs until paused. LinkedIn refuses a new start time once a campaign has started; its answer is reported as is. Undo restores the previous schedule. Nothing changes in the ad account: this creates a proposal with a before-snapshot and returns proposal_id and approval_url; the owner approves or rejects it in Valkiria.
- linkedin_update_campaign_targeting: Propose a targeting change for a LinkedIn campaign as a patch: each facet you pass replaces that facet, null removes it, every facet you do not pass is kept. The patch is merged onto the targeting the campaign has at approval time, and facets set in Campaign Manager (job titles, skills, matched audiences) are always kept, so nothing is wiped. At least one location must remain. Facets: locations, industries, jobFunctions, seniorities, staffCountRanges, interfaceLocales; prefix "!" to exclude (e.g. "!seniorities"). Values are URNs from linkedin_targeting_search. Read the current targeting with linkedin_campaign_targeting. Undo restores the previous facets. Nothing changes in the ad account: this creates a proposal with a before-snapshot and returns proposal_id and approval_url; the owner approves or rejects it in Valkiria.
- linkedin_update_campaign_group: Propose a change to a LinkedIn campaign group: rename it, pause or resume it (which pauses or resumes delivery of all its campaigns), or set its total budget in the ad account currency (normal units, never minor units). Pass only what should change. Undo restores the previous values. Nothing changes in the ad account: this creates a proposal with a before-snapshot and returns proposal_id and approval_url; the owner approves or rejects it in Valkiria.
- linkedin_add_campaign: Propose a new campaign in an existing LinkedIn campaign group. It is created as a DRAFT (default) or PAUSED, never active: a person launches it. politicalIntent is the advertiser's legal declaration and is never assumed. Budgets and bid are in the ad account currency in normal units. targeting needs at least one location. Facets: locations, industries, jobFunctions, seniorities, staffCountRanges, interfaceLocales; prefix "!" to exclude (e.g. "!seniorities"). Values are URNs from linkedin_targeting_search. Nothing changes in the ad account: this creates a proposal with a before-snapshot and returns proposal_id and approval_url; the owner approves or rejects it in Valkiria.
- linkedin_add_creative: Propose a new ad (creative) in an existing LinkedIn campaign from content that already exists: either postUrn (a published company-page post, urn:li:share or urn:li:ugcPost, keeping its reactions) or mediaUrn (an image, video or document already uploaded to LinkedIn) with commentary and organizationId, which becomes a sponsored-only post. The ad is always created PAUSED. Nothing changes in the ad account: this creates a proposal with a before-snapshot and returns proposal_id and approval_url; the owner approves or rejects it in Valkiria.
- linkedin_clone_campaign: Propose a copy of a LinkedIn campaign in the same campaign group, created as a DRAFT: same type, objective, cost type, bid, budgets, locale and targeting (including facets set in Campaign Manager), name with "(Copy)" unless you give one. LinkedIn has no copy endpoint, so the campaign is re-created from its settings; its ads are not copied — add them with linkedin_add_creative. Nothing changes in the ad account: this creates a proposal with a before-snapshot and returns proposal_id and approval_url; the owner approves or rejects it in Valkiria.
03
How changes stay safe
- Two scopes, chosen by you at sign-in: read, and propose. With read alone the assistant cannot request any change.
- A change requested from an assistant is a proposal. It waits in Approvals in Valkiria until the account owner approves it, unless the write policy you set for that account allows that kind of change by itself.
- New campaigns are created paused. Starting new spend and deleting always wait for a person.
- The assistant can list what is waiting for approval and reject a proposal. It cannot approve one: approval stays with the owner in Valkiria.
- The change history shows who or what made each change and the value before and after, with Undo where the change can be reversed.
- You can disconnect an assistant at any time on the Connect AI page; a developer API key can be deleted the same way.
04
Limits
- The assistant sees only your own Valkiria workspace, and only the ad accounts connected there.
- Numbers are as fresh as the last sync or import; the assistant can tell you when that was.
- Money stays in each account's own currency. Different currencies are not converted or added up.
- Reading data is not counted against the monthly allowance; changes and AI generations are. Allowances per plan are on the pricing page.
05
FAQ
Connect an assistant and call the first tool
Create a free account, connect an ad account and add the connector. The first pass only reads.