LinkedIn Ads

Platform Overview

The LinkedIn Ads MCP server enables programmatic management and analysis of LinkedIn Sponsored Content campaigns through the LinkedIn Marketing API v202602. It provides tools for B2B audience targeting, campaign performance tracking, lead generation monitoring, and professional demographic breakdowns unique to LinkedIn's platform.

Your prompt → Claude + Hopkin → LinkedIn Marketing API v202602
                                    ↓
                              Campaign Data
                              B2B Audience Insights
                              Lead Gen Metrics
                              Professional Targeting

Common Workflows

Performance Reporting

"Show me how my campaigns performed over the last 30 days, broken down by campaign group."

Calls linkedin_ads_get_performance_report with pivots=['CAMPAIGN_GROUP'], date_preset='LAST_30_DAYS'. Returns spend, impressions, clicks, conversions, leads, and engagement metrics aggregated by campaign group with optional per-conversion-action breakdown.

"What's my account-level summary for this month, including conversion breakdown?"

Calls linkedin_ads_get_account_summary with date_preset='THIS_MONTH'. Returns total spend, impressions, clicks, leads, one-click conversions, and a per-conversion-action summary (e.g., signups vs. downloads).

"I need daily performance trends by campaign for the last 7 days."

Calls linkedin_ads_get_performance_report with pivots=['CAMPAIGN'], time_granularity='DAILY', date_preset='LAST_7_DAYS'. Returns daily spend, impressions, clicks, and conversions broken down by individual campaigns.

Campaign Management

"List all my active campaigns in account 123456789."

Calls linkedin_ads_list_campaigns with account_id='123456789', status=['ACTIVE']. Returns campaign names, IDs, budgets, run schedules, targeting summary, and serving status.

"Show me all campaign groups and which campaigns belong to each."

Calls linkedin_ads_list_campaign_groups to get all campaign groups, then for each group calls linkedin_ads_list_campaigns with campaign_group_id. Displays the hierarchy with budget and status for each level.

"What creatives (ads) are running in my top-performing campaign?"

Calls linkedin_ads_list_creatives with campaign_ids=['campaign-id'], resolve_content=true. Returns ad copy, headlines, body text, associated URLs, and status for each creative in the campaign.

B2B Audience Analysis

"Which job functions are driving the most conversions?"

Calls linkedin_ads_get_insights with pivot='MEMBER_JOB_FUNCTION', date_preset='LAST_30_DAYS', include_conversion_breakdown=true. Returns impressions, clicks, spend, and conversions by job function (e.g., Engineering, Sales, Marketing, HR). Note: Requires ≥3 events per dimension; data delayed 12-24 hours.

"Break down my campaign performance by seniority level and industry."

Calls linkedin_ads_get_insights twice — once with pivot='MEMBER_SENIORITY' and once with pivot='MEMBER_INDUSTRY'. Returns CTR, CPC, CPA metrics by seniority level and by industry. Useful for identifying which professional segments have the best ROI.

"What's my reach and engagement by company size?"

Calls linkedin_ads_get_insights with pivot='MEMBER_COMPANY_SIZE', date_preset='LAST_30_DAYS'. Returns approximate member reach, impressions, engagements, and cost metrics segmented by company size (1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+).

Lead Generation

"How many one-click leads did I get, and which campaigns generated the most?"

Calls linkedin_ads_get_performance_report with pivots=['CAMPAIGN'], date_preset='LAST_30_DAYS'. Extracts the oneClickLeads metric broken down by campaign. Can then cross-reference with linkedin_ads_get_account_summary for conversion action details.

"What conversion actions are configured for my account?"

Calls linkedin_ads_get_partner_conversions with account_id to see all conversion tracking actions (e.g., form submissions, website conversions, lead magnet downloads). Essential before analyzing conversion breakdown reports.

Recipes

"I want to understand which geographic markets are performing best. Show me impressions, clicks, and spend broken down by country."

Calls linkedin_ads_get_insights with pivot='MEMBER_COUNTRY_V2', date_preset='LAST_30_DAYS', include_conversion_breakdown=true. Returns per-country metrics to identify high-performing markets for budget reallocation. Data shows member reach by country plus conversion details.

"Compare the performance of my SPONSORED_UPDATES campaigns vs SPONSORED_CONTENT campaigns across all metrics."

Calls linkedin_ads_list_campaigns with type=['SPONSORED_UPDATES'], then type=['SPONSORED_CONTENT'] to get campaign IDs. Then calls linkedin_ads_get_performance_report with separate pivots=['CAMPAIGN'] for each type filtered by campaign_ids. Reveals which content format type drives better ROI.

"I need a full performance breakdown: account summary, daily trends by campaign, and audience demographics by job function."

Chains three calls: (1) linkedin_ads_get_account_summary for overall metrics, (2) linkedin_ads_get_performance_report with pivots=['CAMPAIGN'], time_granularity='DAILY', (3) linkedin_ads_get_insights with pivot='MEMBER_JOB_FUNCTION'. Stitches results into a comprehensive executive summary with daily trends and audience insight.

"Which creatives are running in my highest-spend campaigns, and how are they performing?"

Calls linkedin_ads_get_performance_report with pivots=['CAMPAIGN'], sorts by spend, identifies top N campaigns, then calls linkedin_ads_list_creatives with those campaign_ids and resolve_content=true to see ad copy and performance.

"Show me the complete campaign hierarchy, including campaign groups, campaigns, and creatives, for a specific account."

Calls (1) linkedin_ads_list_campaign_groups, (2) linkedin_ads_list_campaigns grouped by campaign_group_id, (3) linkedin_ads_list_creatives for each campaign with resolve_content=true. Builds a nested view of the entire account structure with ad copy and status.

"I want to optimize budget allocation. Show me CPA by campaign, industry, and job function to identify the most efficient segments."

Calls linkedin_ads_get_performance_report with pivots=['CAMPAIGN'], then linkedin_ads_get_insights with pivot='MEMBER_INDUSTRY', and pivot='MEMBER_JOB_FUNCTION'. Filters for rows with >0 spend and conversions, calculates CPA, and ranks by efficiency. Highlights underspend opportunities in high-performing segments.

Tips

• **MEMBER_* Demographic Pivots Have Constraints**: LinkedIn's demographic breakdowns (job function, seniority, industry, company size, country) require at least 3 events per dimension and have a 12-24 hour data delay. Rows below the threshold are silently dropped, so totals may not match account-level aggregates.

• Performance Report vs. Insights: Use linkedin_ads_get_performance_report for standard analysis (campaign, campaign group, creative pivots, up to 3 dimensions). Use linkedin_ads_get_insights only when you need a MEMBER_* demographic pivot or a custom metric. Performance Report includes conversion breakdown by default; Insights includes it optionally.

• Conversion Action Tracking: Always check linkedin_ads_get_partner_conversions first to understand what conversion tracking is configured. Conversion breakdown in performance and insights reports only includes configured actions; if the action isn't set up, it won't appear in the data.

• Date Ranges and Presets: LinkedIn supports LAST_7_DAYS, LAST_14_DAYS, LAST_30_DAYS, THIS_MONTH, LAST_MONTH, and LAST_90_DAYS presets. For custom ranges, use start_date and end_date (ISO format YYYY-MM-DD). Conversion data lags 24-72 hours, so avoid querying for "today" — use at least the last 7 days for stable numbers.