Run LinkedIn Ads from Cursor
Valkiria reads the LinkedIn ad account you connected over LinkedIn OAuth and gives the assistant campaign groups, campaigns, the ads inside them and their results, plus the leads already stored in Valkiria. Cursor reads the Valkiria server from a config file and authenticates with a developer API key in a header. The key carries the scopes you gave it, so you decide up front whether the editor can only read or also propose.
01
Connect Cursor in 3 steps
- In Valkiria create a developer API key with the scopes you need.
- Add the server to .cursor/mcp.json as shown below, replacing vk_live_… with your key.
- Restart Cursor and tell the assistant: "Get started with Valkiria".
- This recipe uses a header instead of a sign-in, so it needs a developer API key. Developer API keys are part of the plans that include API access; the pricing page shows which.
- Keep the key out of version control: put .cursor/mcp.json in .gitignore or use a user-level config.
{
"mcpServers": {
"valkiria": {
"url": "https://valkiria.pro/mcp",
"headers": { "Authorization": "Bearer vk_live_…" }
}
}
}02
What works for LinkedIn Ads today
Connection: LinkedIn OAuth with advertising and reporting scopes.
The assistant can read
- Ad accounts, campaign groups and campaigns with impressions, clicks, spend, leads and conversions.
- The ads of one campaign, live from LinkedIn, with lifetime impressions, clicks, spend and conversions per ad.
- Dated spend and results per currency for an explicit date range.
The assistant can propose or request
- Create a campaign group, a campaign or an ad as a DRAFT in the ad account. Drafts do not deliver or spend.
- Pause or resume a campaign or an ad, or set a campaign daily budget. The request goes through your write policy: applied when the policy allows it, otherwise queued for approval.
- Create and update automation rules.
- Create a monitor that checks the account on a schedule and notifies you or queues a proposal, and schedule a report by email. Neither changes an ad account by itself.
03
Prompts to try: LinkedIn Ads in Cursor
Copy one, replace the parts in brackets and send it. The assistant picks the tools itself.
List my LinkedIn campaign groups and campaigns with spend and leads for the last 30 days.
Show the ads inside [campaign] with impressions, clicks, spend and conversions per ad.
What is my cost per lead on LinkedIn this quarter, by campaign?
Create a draft Sponsored Content campaign in the [group] campaign group. Draft only, no launch.
Export LinkedIn campaign results for this quarter to reports/linkedin-quarter.csv with cost per lead per campaign.
Read icp.md in this repo and create a LinkedIn campaign draft whose name and objective match it. Draft only.
04
How changes stay safe
- This client authenticates with a developer API key in a header. The key can only do what its scopes allow; create a read-only key if the editor should never propose changes.
- 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.
05
Limits
LinkedIn Ads
- Live Lead Gen Forms sync depends on LinkedIn granting the Lead Sync product; until then the assistant sees stored and imported leads.
- Resuming a campaign or raising a budget can start spending, so under the default policy it waits for approval.
Cursor
- A developer API key is required, and developer API keys are not included in every plan.
- A key does what its scopes allow until you delete it, so create a read-only key if the editor should never propose changes.
- 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.
06
FAQ
Ask Cursor about your LinkedIn Ads account
Create a free account, connect an ad account and add the connector. The first pass only reads.