Pinterest Ads MCP. Manage Ad Spend and Performance From Chat.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Pinterest Ads gives your AI agent direct access to manage all aspects of Pinterest advertising campaigns without ever opening the web dashboard.
You can list and create entire campaign structures, pull detailed analytics (impressions, ROAS, clicks) from specific ad groups or accounts, pause underperforming ads instantly, and monitor product catalog health for shopping ads—all via conversation.
What your AI agents can do
Enable campaign
Activates a campaign that was previously paused or disabled in your account.
Get account analytics
Retrieves overall performance metrics (ROAS, clicks, spend) for the entire Pinterest ad account.
Get adgroup analytics
Fetches detailed analytics and performance stats for a specific ad group within a campaign.
List all running campaigns or enable/pause specific ad groups and entire campaigns with simple commands.
Get detailed analytics—including clicks, conversions, ROAS, and impressions—separated by the whole account, campaign level, or individual ad group.
Monitor product catalog sync status and track performance metrics specifically for your shopping ads.
List individual ads (Pins) to check their specific engagement rates or view which creatives are driving the most traffic.
Query data on audience demographics and interests to refine your targeting parameters.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
Pinterest Ads: 8 Tools for Ad Campaign Management
Use these tools to list, analyze, update, and control every part of your Pinterest advertising structure—from the account level down to individual Pins.
019d75f3enable campaign
Activates a campaign that was previously paused or disabled in your account.
019d75f3get account analytics
Retrieves overall performance metrics (ROAS, clicks, spend) for the entire Pinterest ad account.
019d75f3get adgroup analytics
Fetches detailed analytics and performance stats for a specific ad group within a campaign.
019d75f3get campaign analytics
Retrieves core metrics like impressions, clicks, and conversions for an entire defined campaign.
019d75f3list adgroups
Generates a list of all existing ad groups within the account that you can then analyze or modify.
019d75f3list ads
Pulls a directory listing of every individual ad (Pin) currently running in your campaigns.
019d75f3list campaigns
Provides a comprehensive list of all campaign names and current statuses available to the agent.
019d75f3pause campaign
Deactivates an entire campaign or ad group, stopping spending immediately to save budget.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Pinterest Ads, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
Your AI agent gives you direct access to Pinterest Ads so you never gotta open that clunky web dashboard. You can handle your whole ad spend—from setting up a campaign structure to pulling performance data—all through conversation. It’s like having an ad specialist sitting right next to you, who pulls complex analytics in seconds.
Campaign Management and Control
list_campaigns gives you the full rundown of every running campaign and its current status so you know exactly what's live. You can then use enable_campaign to reactivate a campaign that got paused, or run pause_campaign to immediately kill spending on an entire campaign or ad group if it ain’t working.
If you wanna check the structure before making changes, list_adgroups pulls up every existing ad group in your account.
Pulling Granular Performance Metrics
You don't just want a summary; you need numbers separated by where they came from. You get overall performance metrics—like total ROAS, clicks, and spend for the whole thing—using get_account_analytics. For a deeper dive into a specific campaign, get_campaign_analytics pulls core metrics like impressions, conversions, and clicks across that entire defined campaign.
If you want to drill down even further, checking performance by an individual ad group is easy with get_adgroup_analytics, giving you the stats for just that segment.
Identifying Top-Performing Ads and Groups
list_ads pulls a complete directory of every single Pin running in your campaigns. You check this list to see which creative is actually driving traffic or if any ads need tweaking. While get_adgroup_analytics lets you analyze performance by ad group, the agent also handles querying audience data and catalog health for shopping ads so you know who you're talking to and that your products sync up right.
Workflow Summary
Your agent uses these tools together. You ask it for the ROAS on a specific collection's pins, and it runs list_ads first, then uses get_adgroup_analytics to pull the exact numbers you need—all without you having to click anything.
How Pinterest Ads MCP Works
- 1 First, subscribe to the Pinterest Ads integration on Vinkius. This grants your agent permission to talk to the platform.
- 2 Next, set up the necessary credentials in the Pinterest Developer Portal and link them securely to your account.
- 3 Finally, you ask your agent a question (e.g., 'How did Campaign X do last week?'). The agent runs the required tool (
get_campaign_analytics) and delivers the answer.
The bottom line is: You talk to your agent in plain English, and it handles all the API calls needed behind the scenes.
Who Is Pinterest Ads MCP For?
This is for the Digital Marketing Ops Manager who spends half their day clicking through dashboards just to compile a weekly report. If you're tired of copy-pasting numbers from Pinterest Ads into a Google Sheet, this is for you. It lets you run complex performance checks and budget adjustments using only natural conversation.
Checks the conversion attribution by running get_account_analytics to see how shopping ads perform against overall site sales.
Pulls granular data using list_adgroups and get_adgroup_analytics to pinpoint exactly which ad groups need budget reallocation or pausing via pause_campaign.
Manages multiple client accounts by asking the agent to summarize performance across several campaigns, eliminating manual dashboard hopping.
What Changes When You Connect
- Deep Dive Analytics: Instead of viewing a summary, your agent runs
get_adgroup_analyticsto pull the exact ROAS, CPC, and click counts for any specific ad group. You don't guess; you get hard numbers immediately. - Instant Budget Control: Stop spending money on poor performers. Use
pause_campaignorpause_adgroupto shut down campaigns that are burning budget without returning conversions. It’s an instant stop-gap measure. - Full Account Visibility: Get the bird's eye view with
get_account_analytics. This tool aggregates metrics across all your active ads and groups, letting you see overall trends without clicking through multiple dashboards. - Campaign Structure Control: Need to expand or scale? Use
list_campaignsto map out your current structure, then useenable_campaignwhen it's time to fire up a dormant, high-potential campaign. - Pin Performance Audit: Run
list_adsto see every single Pin currently running. This lets you quickly identify which creative assets are getting the highest engagement rates across the board.
Real-World Use Cases
The Weekend Review
A brand owner needs a quick performance snapshot for their weekend report. Instead of logging into Pinterest Ads Manager, they ask their agent: 'What were my top 3 performing ads this week?' The agent runs list_ads and then uses get_adgroup_analytics to pull the key metrics for those specific Pins, delivering a ready-to-use bulleted list.
The Budget Crisis
A campaign is spending money but generating zero conversions. The analyst realizes they need to cut losses immediately. They ask their agent: 'Pause the ad group for Fall Footwear.' The agent runs pause_adgroup instantly, stopping all unnecessary spend and saving budget.
The Expansion Project
A marketing team launches a new product line and needs to test it. They use the agent to run list_campaigns to see available slots, then ask for help setting up the structure, running enable_campaign, and monitoring early performance with get_campaign_analytics.
The Technical Audit
An e-commerce developer needs to confirm product catalog health. They use the agent's built-in shopping ad tools to check the sync status, ensuring that all 2000+ products are correctly listed and approved for advertising.
The Tradeoffs
Guessing which data is missing
A marketer sees low ROAS on a campaign but doesn't know if the problem is the ad group, the pin, or the overall account budget. They waste time cross-referencing multiple dashboards.
→
Don't guess. Use get_account_analytics first for the big picture, then drill down with list_adgroups, and finally check specific performance using get_adgroup_analytics to pinpoint the exact bottleneck.
Over-reliance on manual updates
A user needs to pause a campaign but has to navigate deep into the Ads Manager interface, finding the correct toggle switch and clicking it manually.
→
Just talk to your agent. Say: 'Pause Campaign X.' The agent handles running pause_campaign immediately, saving clicks and time.
Mixing up scope levels
A user runs list_ads but only gets a list of names—no performance numbers attached. They then try to pull analytics on the whole account without linking it back to the ads.
→
Always start broad, then narrow down. Use get_account_analytics for total spend, then use list_adgroups and run get_adgroup_analytics to link those numbers directly to a specific segment.
When It Fits, When It Doesn't
Use this MCP Server if your process involves checking performance data across multiple levels (Account > Campaign > Ad Group > Pin) and you need to execute structural changes like pausing or enabling. It's perfect for Performance Analysts who live in the data flow.
Don’t use it if all you need is a single, simple metric—like just knowing how many campaigns exist. For that, list_campaigns is enough. However, if your workflow requires running complex decision trees (e.g., 'If ROAS < 3x AND Clicks > 500, THEN pause ad group X'), this toolset provides the necessary granularity through its specific tools (get_adgroup_analytics, pause_campaign). If you are building a wrapper service that needs to orchestrate these calls, this is your source of truth. But if you just want general market intelligence, look at a dedicated data export API instead.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Pinterest Ads. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 8 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Reviewing Pinterest Ads performance shouldn't feel like navigating a maze.
Today, checking campaign health means logging into the Ads Manager. You click 'Campaigns,' you check ROAS; then you have to click on that campaign name, which takes you to another page where you select an ad group. Then, for every single ad group, you repeat the process just to pull core metrics like clicks or conversions. It's a multi-tab, deep-dive chore.
With this MCP server, that whole clicking routine disappears. You tell your agent: 'Pull all campaign analytics and show me total spend.' The agent runs `get_campaign_analytics` across the board, pulls everything into one structured response—no clicks necessary.
Pinterest Ads MCP Server: Control Ad Spend with Natural Language
The manual steps that go away include navigating between 'Ad Groups' and 'Campaigns' tabs to compare metrics, manually running reports for ROAS, or going through a settings menu just to pause an ad group. All of this is lost in button clicks.
Now, you simply tell your agent what needs fixing: 'Pause the ads that spent $500 but only generated 2 checkouts.' It runs `get_adgroup_analytics`, identifies the weak link, and executes `pause_campaign`—all without touching a single dashboard button.
Common Questions About Pinterest Ads MCP
How do I get my Pinterest Ads API credentials? +
- Go to developers.pinterest.com and log in with your Pinterest Business account.
- Click My Apps → Create App.
- Fill in the app name and description.
- After creation, copy your App ID and App Secret from the app dashboard.
- Generate an Access Token by authorizing your ad account.
- Paste all values below.
💡 You need a Pinterest Business Account with an active ads account. Convert a personal account at business.pinterest.com.
Can I track shopping ad performance? +
Yes. Your AI agent tracks product-level metrics including impressions, clicks, add-to-carts, checkouts, ROAS, and catalog sync health — giving you real-time visibility into your Pinterest shopping campaigns.
What audience targeting is available? +
Pinterest supports interest targeting, keyword targeting, demographics (age, gender, location), device targeting, customer lists, website visitors (retargeting), actalike audiences, and shopping behavior targeting.
Is this useful for e-commerce brands? +
Absolutely. Pinterest is one of the highest-intent social platforms for shopping — 80% of weekly users have discovered a new brand or product on Pinterest. Your AI agent helps you maximize ROAS across product catalog campaigns.
How do I use the `pause_campaign` tool with Pinterest Ads? +
You just tell your agent which campaign to pause. It executes the command immediately, stopping all ad spend on that specific campaign until you manually reactivate it.
What data do I get when running `get_adgroup_analytics` via Pinterest Ads? +
This tool reports metrics broken down by individual ad group. You can compare performance side-by-side to pinpoint exactly which groups need budget adjustments or creative changes.
Can I use the `get_account_analytics` function in Pinterest Ads? +
Yes, it pulls core metrics for your entire account. You get a comprehensive view of impressions, clicks, CTR, and ROAS without needing multiple reports.
How does Pinterest Ads help me manage multiple campaigns using `list_campaigns`? +
It lists all existing campaigns by name or ID. You can review the status of every campaign in one go, making it easy to identify which need updates or pausing.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
Criteo Marketing API
Equip your AI agent to manage Criteo marketing campaigns, ad sets, and budgets directly via the Criteo API.
LinkedIn Ads
Access marketing analytics, campaigns, and reporting via the LinkedIn Ads REST API.
Sprout Social
Empower your AI with a full social media command center. Draft posts, track global analytics, and master listening topics natively across all brands.
You might also like
Docdown
Equip your AI agent to generate documents, manage templates, and track output files via the Docdown API.
Impact.com
Manage partnership campaigns, ads, and affiliate payouts via Impact.com API.
Drift
Equip your AI agent to manage conversations, track contacts, and monitor agent availability via the Drift API.