Connectors
Updated

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_analytics with 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 with fields.
  • 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

  1. In the InsightfulPipe app, open Connectors, choose LinkedIn Ads and click Connect.
  2. Choose Read Only or Read + Write.
  3. Sign in with LinkedIn and approve access.
  4. Select the ad accounts to connect. Each one becomes its own connection.
  5. 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_ads scope.
  • 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_group and update_creative can 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_creative changes 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 of available_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_id from available_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.

Need help?

If you need help connecting a source or setting up an AI workflow, the team can help you get from first sync to production faster.