# Pinterest Ads MCP > Pinterest Ads MCP Server connects your entire Pinterest advertising account to any AI client. Manage campaigns, track performance data, and audit audiences directly through natural conversation. You can list all ad groups, fetch detailed analytics for specific dates, or verify pins and boards without opening the Pinterest dashboard. It's full control over visual discovery marketing from your chat interface. ## Overview - **Category:** growth-engine - **Price:** Free - **Tags:** ad-campaign-management, performance-tracking, audience-targeting, keyword-analysis, content-management, marketing-automation ## Description You connect your whole **Pinterest Ads** account to any AI agent—Claude, Cursor, whatever you use—and run your entire ad stack conversationally. You manage campaigns, track performance data, and audit audiences without ever having to open the Pinterest dashboard. It's full control over visual marketing from right in your chat interface. When you need a quick read on how things are doing, you can call **`get_pinterest_analytics`**. That tool pulls detailed ad spending metrics like total spend, impressions count, and clicks for any date range you specify. You'll know exactly where the money's going and what kind of reach you got. To get a full picture of your structure, you can first use **`list_pinterest_campaigns`** to see every advertising campaign currently running on the account. Once you pick one, **`get_pinterest_campaign`** pulls all the specific details for that single campaign. From there, if you want to drill down, **`list_pinterest_ad_groups`** gives you a structured list of every active ad group under those main campaigns. You can even check out what search terms are driving traffic by running **`list_pinterest_keywords`**, which shows the specific keywords assigned to any defined ad group. For your creative content, you've got visibility on both product listings and general assets. Use **`list_pinterest_catalogs`** to see all the product catalogs linked up with your ads—you gotta know those for e-commerce targeting. You can also run **`list_pinterest_audiences`**, which gives you a list of saved custom audiences and product catalog segments; this lets you audit exactly who you're trying to hit. If you need to review the actual creative, **`list_pinterest_pins`** retrieves individual pins from specific boards, letting you check your content assets against your current strategy. Meanwhile, if you just want a general overview of your visual organization, **`list_pinterest_boards`** shows every board connected to the account. It's all about knowing what's running and why. You use **`list_pinterest_ads`** to get a straightforward list of every active Pinterest advertisement currently up on the platform. This setup lets your agent handle complex tasks—you don't have to copy-paste data or jump between tabs. If you need to see which products are available for ads, **`list_pinterest_catalogs`** shows those linked product inventories. When you run these tools together, your AI client handles the heavy lifting. You tell it what you want—like "Show me all ad groups that used the keyword 'NYC fashion' last week"—and it spits out the actionable data. It’s about immediate control over every aspect of visual discovery marketing from the comfort of your chat window. ## Tools ### get_pinterest_analytics Fetches detailed advertising metrics like spend, impressions, and clicks for a given date range. ### get_pinterest_campaign Pulls all specific details about one selected advertising campaign. ### list_pinterest_ad_groups Provides a list of all ad groups associated with your account. ### list_pinterest_ads Retrieves a list of active Pinterest advertisements running currently. ### list_pinterest_audiences Generates a list of saved custom audiences and product catalog segments for targeting. ### list_pinterest_boards Shows all boards connected to your account, letting you audit your creative organization. ### list_pinterest_campaigns Lists every advertising campaign currently set up on your Pinterest Ads account. ### list_pinterest_catalogs Shows all product catalogs linked to your ads, essential for e-commerce targeting. ### list_pinterest_keywords Lists the specific search keywords that belong to a defined ad group. ### list_pinterest_pins Retrieves individual pins from specified boards, useful for content auditing. ## Prompt Examples **Prompt:** ``` List all my active Pinterest ad campaigns. ``` **Response:** ``` I've retrieved your campaigns. You have 3 active ones: 'Summer Sale 2026', 'New Collection Launch', and 'Brand Awareness'. Would you like analytics for any of these? ``` **Prompt:** ``` How much did we spend on Pinterest ads between 2026-10-01 and 2026-10-15? ``` **Response:** ``` Total spend for that period was $1,245.50 across all campaigns, generating 45,000 impressions and 1,200 clicks. ``` **Prompt:** ``` Show me the pins from my 'Home Decor' board. ``` **Response:** ``` I've retrieved the pins from 'Home Decor'. There are 12 pins, including 'Modern Living Room Ideas' and 'Minimalist Kitchen Setup'. Would you like the details for any specific pin? ``` ## Capabilities ### Get Performance Analytics It fetches detailed ad spending data, impressions, and clicks for defined date ranges. ### View Campaign Details You retrieve full information on a specific advertising campaign based on its ID or name. ### List Ad Groups It pulls a structured list of all active ad groups under your main campaigns. ### Audit Saved Audiences You get a list of saved custom audiences and product catalogs for targeting review. ### List Pinterest Pins It retrieves pins from specific boards, allowing you to audit your content assets. ### Identify Ad Campaigns You get a comprehensive list of all running advertising campaigns on the account. ## Use Cases ### Quarterly Performance Review A marketing director needs to compare Q1 spending vs. Q2 performance. Instead of downloading spreadsheets and manually compiling data, they ask the agent to run `get_pinterest_analytics` for both periods. The agent aggregates the total spend and click metrics, giving a single comparative summary in minutes. ### Pre-Launch Content Check A content strategist is launching a new collection. They use the agent to run `list_pinterest_boards` followed by running `list_pinterest_pins` on all relevant boards. This confirms that every board has at least five pins and that no old, irrelevant content remains. ### Audience Refresh The e-commerce team updated its product lines. They run `list_pinterest_catalogs` to ensure the new items were added correctly, then use `list_pinterest_audiences` to confirm that the target audience segments are properly linked to the refreshed catalog. ### Ad Structure Cleanup The ad account is messy. The specialist runs `list_pinterest_campaigns` and then sequentially uses `list_pinterest_ad_groups` for each campaign. This allows them to quickly map out which campaigns are over-spending or have redundant ad groups needing consolidation. ## Benefits - See campaign spend breakdown instantly. Instead of navigating five different tabs to check `get_pinterest_analytics`, you just ask the agent for metrics between two dates, getting a clean total spend figure right away. - Targeting is simpler with `list_pinterest_audiences`. You don't have to open the Ads Manager just to see if your saved audiences are up-to-date or if your product catalog listing changed. It gives you immediate visibility into who you’re reaching. - Audit content flow with `list_pinterest_pins` and `list_pinterest_boards`. You can check 12 pins across three boards in a single prompt, saving hours of manual clicking just to verify creative assets before launch. - Understand your ad structure using `list_pinterest_ad_groups` and `list_pinterest_campaigns`. Instead of guessing which campaigns are running or what groups exist, you get a definitive list so you know exactly where to focus your efforts. - Keep search strategy tight. The `list_pinterest_keywords` tool lets you dump all keywords associated with an ad group into the chat, allowing your AI client to immediately suggest better synonyms or related terms. ## How It Works The bottom line is, you treat Pinterest as just another data source in your chat, not a separate web application. 1. First, subscribe to this server and provide your Pinterest OAuth2 Access Token and Ad Account ID. 2. Your AI client authenticates with the MCP Server using those credentials. 3. You issue a natural language command (e.g., 'What were our clicks last week?'), and the agent executes the required tool call. ## Frequently Asked Questions **How do I check if my audience targeting is working with list_pinterest_audiences?** Use `list_pinterest_audiences` to verify the existence and status of your saved segments. If an audience is listed but marked as inactive, you know exactly where the problem is before running ads. **What data can get_pinterest_analytics fetch?** This tool fetches core metrics like total spend, impressions, and clicks across your campaigns. Remember to specify a date range so the results are accurate for your review period. **I need to check my content pins; should I use list_pinterest_pins?** Yes, `list_pinterest_pins` pulls individual pin details from specific boards. It’s better than just listing the board name because it gives you the actual assets you need to audit. **How do I see all my ad groups using list_pinterest_ad_groups?** Simply run `list_pinterest_ad_groups`. This tool provides a clean, comprehensive list of every ad group attached to your active campaigns. It’s the first step in diagnosing structure issues. **If I change my ad account credentials, how do I ensure `list_pinterest_campaigns` uses the updated connection?** You must reauthenticate your AI client with your Pinterest OAuth2 Access Token. Once that's done, any call to `list_pinterest_campaigns` automatically pulls data from the live, verified account. The server doesn't store credentials; it just needs a current token to run the tool. **When I update my product inventory, how does using `list_pinterest_catalogs` help me manage the change?** It retrieves the current structure and status of your linked product catalog. You can check if specific SKUs or categories are missing from the list, helping you verify that your entire inventory is synced for advertising. **How do I use `list_pinterest_keywords` to refine my ad group strategy after a campaign runs?** It lists all keywords associated with a specific ad group. Reviewing this list lets you spot low-performing terms or identify high-volume concepts that haven't been targeted yet, giving you clear areas for optimization. **What detailed settings can I get about one campaign using `get_pinterest_campaign`?** It pulls granular data beyond just the name. You get details like the current budget status, start and end dates, specific targeting parameters used for that campaign, and ad type. **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.