# LinkedIn Ads MCP for AI Agents AI Agent Connect

> LinkedIn Ads lets you pull marketing data and campaign stats directly into your AI workflow. It connects to the LinkedIn Ads REST API so your agent can check how your ads are performing, look at spend across different accounts, and grab conversion data. You get a clear view of your professional marketing efforts without jumping between tabs or exporting CSVs every hour.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_aiJpqqiHwsYymweehIXYbLscmmAlMYJhMXP4QXUr/ai-agent-connect
- **Tags:** ad-campaigns, performance-reporting, lead-generation, marketing-analytics, conversion-tracking, b2b-marketing

## Description

You're staring at a mess of tabs. One has your LinkedIn campaign manager open, another has a spreadsheet where you're trying to manually sum up clicks from last week, and a third is your reporting tool. It's a headache. This Connector changes that by letting your AI agent do the heavy lifting for you. Instead of clicking through dozens of sub-menus to find out how much you spent on a specific creative, you just ask your agent to pull the numbers. It handles the API calls, looks at the different account pivots, and gives you the data you actually need to make decisions. Whether you're trying to see if a new lead gen campaign is actually converting or just need a quick pulse check on your total spend, it pulls the info in real-time. It's part of the Vinkius catalog, which makes it easy to plug into your existing setup. You get to stop being a data entry clerk and start being a strategist who actually has the facts at their fingertips.

## Tools

### list_ad_creatives
View the specific ad variations and configurations for your marketing assets. It's the best way to audit your active creative variations.

### list_ad_campaigns
Get a full list of every campaign running under a specific ad account. This makes it easy to see what's currently live.

### list_ad_accounts
See all the LinkedIn Ad Accounts you have access to in one list. Use this to get a bird's-eye view of your entire portfolio.

### get_ad_analytics
Pull real-time metrics like impressions, clicks, and spend based on your chosen pivots. This is useful for seeing how your budget is actually performing.

### list_campaign_groups
Browse different campaign groups for your accounts. This helps you stay organized when managing multiple marketing objectives.

### list_conversion_rules
See the specific rules used to track conversions and calculate your ROAS. This ensures you know exactly what your agent is measuring.

## Prompt Examples

**Prompt:** 
```
How much did we spend on the 'Lead Gen' campaign last month?
```

**Response:** 
```
### Campaign Performance: Lead Gen

| Metric | Value |
| :--- | :--- |
| **Total Spend** | $4,250.00 |
| **Impressions** | 125,000 |
| **Clicks** | 3,120 |
| **Avg. CPC** | $1.36 |

*The campaign is currently pacing 5% under budget for the month.*
```

**Prompt:** 
```
List all the ad creatives for our 'Brand Awareness' campaign.
```

**Response:** 
```
I've found 3 active creatives for the **Brand Awareness** campaign:

*   **Creative_01**: Video_Ad_Main_Hero (ID: 88291)
*   **Creative_02**: Static_Image_Retargeting (ID: 88295)
*   **Creative_03**: Carousel_Product_Showcase (ID: 88302)

Would you like to see the technical configurations for any of these?
```

**Prompt:** 
```
Are there any conversion rules set up for our new account?
```

**Response:** 
```
Yes, I've retrieved the following conversion rules for your account:

1.  **Website_Lead_Form**: Triggers when a user submits the 'Contact Us' form.
2.  **Product_Sign_Up**: Triggers on the 'Thank You' page after registration.
3.  **Demo_Request**: Triggers on the 'Book a Demo' confirmation page.

All rules are currently active.
```

## Capabilities

### List all active ad accounts
See every LinkedIn Ad Account you have access to in a single list.

### Monitor campaign performance
Get a clear view of your marketing objectives and progress.

### Query real-time spend and clicks
Pull live metrics like impressions, clicks, and cost across different pivots.

### Inspect individual ad creatives
Look at the specific variations and technical configurations of your ads.

### Retrieve conversion tracking rules
See the definitions for your conversion rules to monitor your return on ad spend.

### Browse campaign groups
Stay organized by listing different campaign groups for your accounts.

## Use Cases

### Comparing creative performance
A marketer needs to know which ad creative had the lowest cost per click last week. They ask the agent to use get_ad_analytics to compare spend and clicks across all creatives.

### Auditing multi-region campaigns
A growth lead wants to see all active campaigns across three different regions. They ask the agent to use list_ad_accounts and then list_ad_campaigns for each.

### Verifying conversion tracking
An analyst needs to verify that conversion rules are set up correctly for a new product launch. They use list_conversion_rules to check the definitions.

### Campaign organization check
A manager wants to see how many campaign groups are currently active for the Q4 holiday push. They ask the agent to use list_campaign_groups.

## Benefits

- Stop manual data entry by using get_ad_analytics to pull spend and click data directly into your reports.
- Quickly audit your brand assets by using list_ad_creatives to see every variation across all accounts.
- Get a bird's-eye view of your portfolio with list_ad_accounts to manage multiple brands from one place.
- Monitor your ROI more closely by using list_conversion_rules to verify how your success metrics are being tracked.
- Stay organized on large-scale accounts by using list_campaign_groups to separate different marketing objectives.

## How It Works

The bottom line is you get real-time LinkedIn marketing data in your chat window without touching the Ads Manager.

1. Subscribe to the LinkedIn Ads MCP on Vinkius.
2. Provide your LinkedIn Access Token and the specific API version.
3. Ask your AI client to pull reports or list your campaigns.

## Frequently Asked Questions

**Can I see my LinkedIn ad spend with this Connector?**
Yes, you can see spend, clicks, and impressions. You can ask your agent to pull these numbers for specific date ranges or across different campaign groups.

**Does this work for multiple LinkedIn accounts?**
Yes, it can list all the accounts you have access to. This makes it easy to get a high-level view of your entire marketing portfolio in one place.

**Can I use this to see which ads are performing best?**
Yes, you can query analytics for specific creatives. This allows you to quickly identify which ad variations are driving the most engagement or lowest costs.

**How do I see my conversion rules?**
The Connector can pull the definitions of your conversion rules. This is helpful for verifying that your success metrics are being tracked correctly across your accounts.

**Is this for managing my ads or just looking at data?**
This Connector is designed for reporting and monitoring data. It lets you read analytics and lists, but it doesn't allow you to edit ads or change budgets.

**Can I see my campaign groups?**
Yes, it can list all campaign groups for your accounts. This helps you stay organized when you have many different marketing objectives running at once.

**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.