Connectors
LinkedIn Ads MCP connector
The LinkedIn Ads connector lets AI agents report on and manage LinkedIn Campaign Manager ad accounts through InsightfulPipe's hosted MCP server at https://linkedin-ads.insightfulmcp.com/. Agents can pull analytics by pivot, including demographics and revenue attribution, and create campaign groups, campaigns, creatives and lead forms.
LinkedIn Ads MCP server reference
- Endpoint
https://linkedin-ads.insightfulmcp.com/- Server name
linkedin-ads-mcp- Actions
- 28 (18 read, 10 write). Workspace owners, admins and operators choose which actions each connected account exposes, and destructive actions are off by default.
Add it from a terminal, then click Authorize access in the browser window that opens:
claude mcp add --transport http linkedin-ads-mcp https://linkedin-ads.insightfulmcp.com/
gemini mcp add --transport http linkedin-ads-mcp https://linkedin-ads.insightfulmcp.com/
codex mcp add linkedin-ads-mcp --url https://linkedin-ads.insightfulmcp.com/What agents can do
- Analytics:
get_analyticswith a pivot, time granularity and date range, plus shortcuts for account, campaign, campaign group and creative analytics, demographic analytics and revenue analytics. Clicks, impressions and cost are returned by default, and you can request other metrics withfields. - Campaign structure: list, create and update campaign groups and campaigns, and read tracking parameters and budget pricing.
- Creatives: create inline creatives, update a creative's name and status, and upload images and videos.
- Lead generation and conversions: list and create lead forms, and list conversions.
- Accounts: list every ad account your LinkedIn login can reach.
Before you connect
- A LinkedIn login with access to the ad account in Campaign Manager.
Connect LinkedIn Ads
- In the InsightfulPipe app, open Connectors, choose LinkedIn Ads and click Connect.
- Choose Read Only or Read + Write.
- Sign in with LinkedIn and approve access.
- Select the ad accounts to connect. Each one becomes its own connection.
- Add the MCP server to Claude, ChatGPT or another client, then click Authorize access.
Permissions and safety
- Writes need Read + Write, which grants the
rw_adsscope. - New campaigns are created PAUSED. Campaign groups and creatives are created ACTIVE because LinkedIn rejects paused ones, but nothing serves while the campaign is paused.
update_campaign,update_campaign_groupandupdate_creativecan set ACTIVE, ARCHIVED or PENDING_DELETION, so an update can start delivery or remove an object.- There are no delete actions, so no LinkedIn Ads action is classified destructive. All writes are available on Read + Write connections unless an owner, admin or operator turns them off in Configure actions for this account.
- Budgets and bids are passed to LinkedIn without extra checks.
Limits
- No audience, matched audience or targeting facet actions.
- Conversions are read-only, and lead form responses can't be retrieved.
update_creativechanges only the name and status.- Media uploads return an upload URL and the client uploads the file. Video files over 4 MB use multipart upload followed by
finalize_video_upload. Formats: JPG, PNG, GIF, MP4 and MOV. - With several ad accounts connected, pass
ad_account_id. Without it the connector returns the list ofavailable_accounts.
Example prompts
- "Show LinkedIn Ads spend, clicks and leads by campaign for this quarter."
- "Break down impressions for the Q3 ABM campaign by job seniority and company size."
- "Create a paused campaign in the Webinars campaign group with a $100 daily budget."
Troubleshooting
- Several accounts found: ask the agent to use a specific
ad_account_idfromavailable_accounts. - "This account is connected read-only, so this action cannot be enabled for it." Reconnect with Read + Write.
- An account is missing: confirm your LinkedIn login has access to it in Campaign Manager, then reconnect and select it.