LinkedIn Marketing MCP Server

MCP (Model Context Protocol) server for LinkedIn Marketing API. Connect AI agents like Claude, GPT, or custom LLMs to LinkedIn Ads for automated campaign management, lead sync, and analytics.

What is this?

This is an MCP Server that exposes LinkedIn Marketing API operations as tools for AI agents. It runs on Apify in Standby mode, providing a persistent endpoint for real-time AI workflows.

Use cases:

• AI marketing assistants that manage LinkedIn campaigns
• Automated lead sync from LinkedIn to CRM
• AI-powered campaign optimization and budget management
• Conversational interfaces for LinkedIn Ads

MCP Tools Available

Tool	Description
validate_campaign	Validate campaign config before creation
create_campaign	Create LinkedIn ad campaign
get_campaigns	List campaigns with status
get_campaign	Get single campaign details
update_campaign	Update budget, bid, targeting, schedule
pause_campaign / resume_campaign	Control campaign status
get_leads	Fetch leads from Lead Gen Forms
get_analytics	Campaign performance metrics
get_demographic_analytics	Breakdown by industry, seniority, etc.
create_conversion_rule	Create CAPI conversion tracking
track_conversion	Send conversion events
recommend_targeting	AI-powered targeting suggestions

Quick Start

Connect with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "linkedin": {
      "command": "npx",
      "args": ["-y", "@anthropic/apify-mcp-server", "salesmart-srl/42rows-linkedin-actor"],
      "env": {
        "APIFY_TOKEN": "your_apify_token",
        "LINKEDIN_ACCESS_TOKEN": "your_linkedin_token",
        "LINKEDIN_AD_ACCOUNT_ID": "your_ad_account_id"
      }
    }
  }
}

Then ask Claude: "Show me my LinkedIn campaigns" or "Create a lead gen campaign targeting software directors in Germany"

Run as Batch Actor

For one-off operations without MCP:

{
  "operation": "get_leads",
  "accessToken": "YOUR_LINKEDIN_TOKEN",
  "adAccountId": "urn:li:sponsoredAccount:123456",
  "startDate": "2025-01-01",
  "endDate": "2025-01-31"
}

Validate Without API Access

Test campaign configurations offline (no token required):

{
  "operation": "validate",
  "campaigns": [{
    "name": "Q1 Lead Gen",
    "objective": "lead_generation",
    "daily_budget_eur": 50,
    "targeting": {
      "locations": ["Germany", "Netherlands"],
      "industries": ["software", "finance"],
      "seniorities": ["director", "vp"]
    }
  }]
}

Output Data

Campaigns

Field	Description
campaignId	LinkedIn campaign URN
name	Campaign name
status	ACTIVE, PAUSED, DRAFT
dailyBudget	Daily budget
impressions	Total impressions
clicks	Total clicks
ctr	Click-through rate
leads	Leads generated
cpl	Cost per lead

Leads

Field	Description
email	Lead email
firstName	First name
lastName	Last name
company	Company name
jobTitle	Job title
submittedAt	Submission timestamp

LinkedIn API Requirements

You need LinkedIn Marketing API access:

1. Create app at LinkedIn Developers
2. Request Marketing API Program access
3. Get OAuth 2.0 access token

Required scopes:

• rw_ads - Campaign management
• r_ads_reporting - Analytics
• r_leadgen - Lead sync
• rw_conversions - Conversion tracking (optional)

Pricing

$0.01 per execution - flat fee regardless of operation.

No platform compute costs (Pay-Per-Event model).

Rate Limits

LinkedIn API limits apply:

• 500 requests/day per app (Development)
• 100 requests/day per member
• Automatic retry with backoff

Documentation

• docs/USER-GUIDE.md
• docs/MCP-BEST-PRACTICES.md

Support

Issues: GitHub