# LinkedIn Ads MCP

> LinkedIn Ads MCP gives your AI agent direct, programmatic access to your professional ad accounts and performance data. Instead of logging into LinkedIn's dashboard, you ask for specific metrics—like impressions, clicks, or total spend—and get real-time structured results. It lets you automatically list every account, monitor campaign groups, track conversion rules, and pull granular analytics across any date range using simple natural language commands.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** ad-campaigns, performance-reporting, lead-generation, marketing-analytics, conversion-tracking, b2b-marketing

## Description

Managing ad performance means wrestling with dashboards, exporting CSV files, and cross-referencing dates manually. This MCP changes that. Now, your AI client connects directly to the LinkedIn Ads API through Vinkius, letting you query complex marketing data without ever touching a spreadsheet or logging into a reporting portal. You can ask your agent to list every ad account you manage, then immediately pull performance metrics for specific campaigns—like clicks and total cost—for Q1 only. If you need to know how many ads ran last week across all creative variations, you just ask. The system handles the querying of everything from campaign groups to individual conversion rules, providing clean data right where your agent needs it.

## Tools

### get_ad_analytics
Queries specific performance metrics like impressions, clicks, and total spend for a defined date range and ad account pivot.

### list_campaign_groups
Fetches all campaign groups associated with a given ad account ID.

### list_ad_accounts
Retrieves a complete list of all LinkedIn Ad Accounts linked to your professional profile.

### list_conversion_rules
Provides a definition list of conversion tracking rules used to measure your return on ad spend (ROAS).

### list_ad_creatives
Lists and inspects all individual ad creatives, detailing their technical configurations.

### list_ad_campaigns
Lists every individual, active ad campaign within an ad account for review.

## Prompt Examples

**Prompt:** 
```
List all my LinkedIn Ad accounts.
```

**Response:** 
```
I've retrieved your ad accounts. You have 2 active accounts: 'Global Marketing (ID: 500123)' and 'Retargeting EMEA (ID: 500456)'.
```

**Prompt:** 
```
Show performance metrics for account ID '500123' for the year 2024.
```

**Response:** 
```
I've queried the analytics. For the year 2024, account 500123 has generated 1,500,000 impressions and 45,000 clicks, with a total spend of $12,500.00.
```

**Prompt:** 
```
List all campaigns associated with my account.
```

**Response:** 
```
I found 5 campaigns in your account, including 'Brand Awareness Q1', 'Lead Gen Webinar', and 'Product Demo'. Which one would you like to see demographics for?
```

## Capabilities

### Identify ad accounts
This action retrieves a complete list of every LinkedIn Ad Account you have access to.

### Query performance metrics
You can pull detailed analytics, including impressions, clicks, and total spend, by specifying the exact date range and ad account pivot.

### Map campaign structures
The MCP lists all associated campaign groups or individual campaigns tied to a specific account ID.

### Inspect ad creatives
You can list and examine the technical details of every individual ad variation running in your accounts.

### Track conversion goals
This retrieves definitions for all conversion rules, helping you monitor return on ad spend (ROAS).

## Use Cases

### Need to audit all active campaigns before budget reallocation.
A Marketing Director asks their agent: 'List every campaign group and ad creative in the Global account.' The MCP runs list_campaign_groups and then list_ad_creatives, providing a comprehensive inventory report that saves hours of manual navigation.

### Cross-checking spend against goal definitions.
A Data Analyst needs to know if the campaign metrics match the business goals. The agent calls get_ad_analytics for Q3 and then uses list_conversion_rules to verify that 'leads generated' is correctly counted, giving a reliable ROAS figure.

### Investigating performance dips on a specific ad.
A Growth Engineer notices poor clicks. They prompt the agent to use get_ad_analytics for the last 7 days and then call list_ad_creatives, immediately pinpointing if the issue is with the creative itself or the overall account spend.

### Creating a quarterly performance report template.
A consultant uses the MCP to repeatedly execute get_ad_analytics for different quarter ranges and then calls list_ad_accounts, structuring a repeatable data pipeline that feeds directly into their client's presentation deck.

## Benefits

- Get immediate account visibility by using the list_ad_accounts tool, which instantly provides an inventory of every ad account you manage. You never have to manually check multiple dashboards just to confirm active accounts.
- Stop guessing your ROI. The MCP lets you pull conversion rules via list_conversion_rules, ensuring that any performance data you get back is correctly mapped against defined goals and metrics.
- Analyze trends across time by using the get_ad_analytics tool. You simply specify a date range—like 'last 30 days'—and receive precise totals for impressions, clicks, and spend without running separate reports.
- Maintain full oversight of your ad inventory. By listing all campaign groups and campaigns (list_campaign_groups / list_ad_campaigns), you get an instant map of what is currently running and where the budget is allocated.
- Streamline creative audits by using list_ad_creatives. If you suspect a specific ad variation isn't performing, this tool lets you pull its technical details for immediate inspection and diagnosis.

## How It Works

The bottom line is you get structured data output from complex advertising systems without writing a single API call or navigating multiple web dashboards.

1. First, subscribe to this MCP and provide your LinkedIn Access Token along with the necessary API version and permissions.
2. Next, connect this credential set to your preferred AI client—Claude, Cursor, or any compatible agent.
3. Finally, prompt your agent using natural language. You can ask it to 'Show me Q2 spending for Account XYZ,' and it executes the required tools automatically.

## Frequently Asked Questions

**How often can I use the LinkedIn Ads MCP?**
You can query performance metrics as often as needed, limited only by your API rate limits and access scope. The agent runs the queries for you on demand.

**Does the LinkedIn Ads MCP help me create ads?**
No, this MCP is purely for reading data. You use tools like list_ad_accounts to view what exists, but it does not allow ad creation or budget modifications.

**What if I need performance data from multiple accounts?**
You can provide a list of account IDs, and the MCP will run get_ad_analytics for each one, consolidating the results into one comprehensive report for your agent to read.

**Can I track metrics beyond clicks and impressions?**
Yes. By using list_conversion_rules, you first define what 'success' means (e.g., lead form submission) and then get_ad_analytics reports on that specific conversion goal.

**Is the LinkedIn Ads MCP better than exporting data?**
Absolutely. Exporting is static; it requires you to run the report, download it, and revisit it later. This MCP connects live and gives you up-to-the-minute answers instantly.

**Which scopes are required for this server?**
Your access token must have at least `r_ads_reporting` and `r_ads` scopes to list accounts and fetch performance metrics.

**How do I specify the time range for analytics?**
You must provide a Restli-formatted string in the `params` field, including `dateRange=(start:(day:X,month:Y,year:Z))`. Refer to LinkedIn API documentation for exact syntax.

**Is the API Key (Personal Access Token) supported?**
LinkedIn uses OAuth2 tokens. You can generate a long-lived Access Token through the LinkedIn Developer Portal's Token Generator tool for development use.