# Pinterest Ads MCP for AI Agents AI Agent Connect

> Pinterest Ads MCP lets you manage your entire advertising account through your AI agent. You can list campaigns, pull performance metrics, audit saved audiences, and check your pins or boards without switching tabs. It gives your agent the eyes it needs to see your ad structure and the data it needs to help you optimize spend.

## Overview
- **Category:** growth-engine
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_cBlpHQ7VdEWgUvbXLIVe5k23T3xdCj4uRLgMAlkw/ai-agent-connect
- **Tags:** ad-campaign-management, performance-tracking, audience-targeting, keyword-analysis, content-management, marketing-automation

## Description

Managing a visual discovery platform like Pinterest usually means jumping between different dashboards to check if your ads are actually converting. You have to hunt for specific campaign IDs, dig through nested menus for audience sizes, and manually export spreadsheets just to see how your spend is performing against your goals. It's a lot of clicking for very little high-level insight. This Connector changes that by letting your AI agent handle the heavy lifting of data retrieval. Instead of hunting for information, you just ask your agent to find the performance of your specific campaigns or to list all the keywords you're currently bidding on. By connecting your account to the Vinkius catalog, you give your agent the ability to audit your creative assets and audience targeting in real time. You can check if your boards are populated correctly or if your product catalogs are syncing without leaving your chat interface. It turns your AI into a marketing analyst that can pull the facts you need to make better decisions on your visual marketing strategy. You get a direct line to your advertising data, making it easier to see what's working and what isn't. You can quickly verify your targeting parameters or pull historical performance metrics to see your return on investment. It removes the friction of manual data collection and puts the focus back on your creative strategy.

## Tools

### list_pinterest_ad_groups
Lists all ad groups in your account. Use this to see how your advertising is organized.

### get_pinterest_analytics
Pulls advertising analytics for specific date ranges. Use this to see your ROI and engagement metrics.

### get_pinterest_campaign
Retrieves the details for a specific campaign. This helps you check the status and settings of one ad.

### list_pinterest_ads
Lists every individual ad in your account. This is useful for auditing your creative assets.

### list_pinterest_audiences
Lists your saved audiences. Use this to verify your targeting parameters and reach.

### list_pinterest_boards
Lists your Pinterest boards. Use this to manage your organic content and visual presence.

### list_pinterest_campaigns
Lists all Pinterest ad campaigns. This gives you a high-level overview of your active ads.

### list_pinterest_catalogs
Lists your product catalogs. Use this to ensure your e-commerce items are syncing correctly.

### list_pinterest_keywords
Lists keywords for a specific ad group. Use this to refine your search and discovery strategy.

### list_pinterest_pins
Lists your Pinterest pins. This helps you verify your creative content across different boards.

## Prompt Examples

**Prompt:** 
```
How did my 'Summer Sale' ads perform last week?
```

**Response:** 
```
Here is the performance summary for your **Summer Sale** campaign from last week:

| Metric | Value |
| :--- | :--- |
| **Total Spend** | $450.20 |
| **Impressions** | 12,400 |
| **Clicks** | 312 |
| **CTR** | 2.5% |

Would you like to see the breakdown for specific ad groups?
```

**Prompt:** 
```
List all my active ad groups.
```

**Response:** 
```
I've retrieved your active ad groups:

*   **Summer Sale - Retargeting**
*   **New Collection - Interest**
*   **Brand Awareness - Lookalike**

Which one of these would you like to dive into?
```

**Prompt:** 
```
What keywords are we using for the 'New Collection' campaign?
```

**Response:** 
```
The following keywords are currently associated with your **New Collection** ad group:

*   minimalist decor
*   modern furniture
*   scandi style
*   apartment styling
*   interior design ideas

Do you want me to check the performance of any specific keyword?
```

## Capabilities

### Pull campaign performance metrics
Get specific data on spend, impressions, and clicks for your ads.

### List active ad groups and ads
See every ad group and individual ad currently running in your account.

### Audit saved audiences
Check your saved audience segments to ensure your targeting is correct.

### Retrieve pin and board data
Fetch a list of your pins and boards to manage your visual content.

### Extract ad group keywords
Get the list of keywords associated with your ad groups to refine search reach.

### Fetch product catalog details
List your product catalogs to verify that your e-commerce items are syncing.

## Use Cases

### Checking campaign ROI
A marketer asks their agent to pull the spend and click data for the 'Summer Sale' campaign from last week to see if it hit the target.

### Auditing audience segments
An e-commerce owner asks the agent to list all saved audiences to make sure no old segments are still active.

### Verifying creative content
A content creator asks the agent to show all pins on their 'Home Decor' board to ensure they are correctly categorized.

### Refining keyword strategy
A strategist asks the agent to list the keywords for their 'Winter Wear' ad group to identify gaps in their search reach.

## Benefits

- Stop manual data entry by using get_pinterest_analytics to pull ROI metrics instantly.
- Audit your targeting accuracy by checking saved audiences with list_pinterest_audiences.
- Keep your creative assets organized by listing pins and boards with list_pinterest_pins.
- Refine your search strategy by pulling ad group keywords using list_pinterest_keywords.
- Verify your e-commerce setup quickly by checking product catalogs with list_pinterest_catalogs.
- Get a bird's-eye view of your spend by listing all campaigns with list_pinterest_campaigns.

## How It Works

The bottom line is you get a direct line from your chat interface to your Pinterest advertising data.

1. Subscribe to the Pinterest Ads MCP via the Vinkius catalog.
2. Enter your Pinterest OAuth2 Access Token and Ad Account ID.
3. Ask your AI client to pull analytics or list your active campaigns.

## Frequently Asked Questions

**Can the Pinterest Ads MCP show me my actual spend?**
Yes, it pulls specific performance metrics including spend, impressions, and clicks for your campaigns.

**Does the Pinterest Ads MCP work with my product catalog?**
Yes, it can list your product catalogs so you can verify that your e-commerce items are syncing correctly.

**Can I use the Pinterest Ads MCP to see my boards?**
Yes, it allows your agent to list your Pinterest boards and pins to help you manage your visual content.

**How does the Pinterest Ads MCP help with my audience targeting?**
It lets you audit your saved audiences quickly, making it easy to see who you're reaching without digging through menus.

**Can the Pinterest Ads MCP help me with keyword research?**
Yes, it can pull the keywords associated with your ad groups so you can see what search terms are driving traffic.

**Is the Pinterest Ads MCP good for e-commerce?**
It's excellent for e-commerce because it handles product catalogs and audience data, which are core to your online sales.

**How do I find my Pinterest Ad Account ID?**
In your Pinterest Business account, go to the Ads Manager. Your Ad Account ID is usually visible in the URL or in the account settings section.

**Can I see performance metrics for specific dates?**
Yes! Use the `get_pinterest_analytics` tool and provide the `start_date` and `end_date` parameters along with the columns (metrics) you wish to retrieve.

**What metrics can I retrieve?**
Common metrics include SPEND_IN_DOLLAR, IMPRESSION, CLICKTHROUGH, REPIN, and TOTAL_CONCLICK. You can provide multiple metrics separated by commas.