How to Use the Pinterest Ads MCP in Windsurf

Q: How does Windsurf manage my Pinterest Ads campaigns autonomously?

Cascade uses the listcampaigns and pausecampaign tools to audit and adjust your live campaigns. You set the target CPA, and Cascade runs the necessary steps to pause or enable campaigns based on daily performance metrics.

Q: Can I use this Pinterest Ads MCP Server to pause underperforming ad groups in Windsurf?

Yes. Cascade calls getadgroupanalytics to evaluate conversion rates and then uses pausecampaign to stop underperforming campaigns. This keeps your ad spend focused on high-ROAS ad groups.

Q: What data does Cascade pull to optimize Pinterest Ads inside Windsurf?

Cascade runs listads and getcampaignanalytics to pull raw CTR, impression, and conversion data. It then analyzes this performance data directly in your editor to make optimization decisions.

Give Windsurf the keys to your Pinterest Ads campaigns so Cascade can analyze ad performance and toggle budgets in real-time.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect Pinterest Ads MCP to Windsurf

Create your Vinkius account to connect Pinterest Ads to Windsurf — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup Pinterest Ads with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Stop wasting money on underperforming Pins in Windsurf

Using `get_account_analytics` and `get_adgroup_analytics`, Windsurf's Cascade scans your entire dashboard to identify which creative assets are draining your budget. It processes raw conversion data directly inside your IDE without forcing you to click through browser dashboards. Once Cascade spots an ad group falling below your target ROAS, it acts. Instead of wasting money, you pause the campaign instantly to save your budget for proven winners.

Automate campaign management with this Windsurf MCP Server

By calling `list_campaigns` and `list_adgroups`, this MCP server lets Cascade map your entire account structure in a single run. You do not have to write manual scripts or switch tabs to map your active targeting setup. Cascade chains these discovery tools with `get_campaign_analytics` to build a localized performance profile. This shows you exactly which campaigns need immediate optimization based on actual cost-per-click metrics.

Let Cascade scale winning creative variations autonomously

The `list_ads` tool allows Cascade to pull every Pin variation you have running to evaluate individual CTR metrics. Cascade doesn't just look at high-level numbers; it digs into specific creative performance. When Cascade finds a high-performing Pin, it invokes `enable_campaign` to scale the budget on the parent campaign. You get a self-optimizing ad system that runs entirely within your IDE workspace.

Setup guide

Set up Pinterest Ads MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Pinterest Ads MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Pinterest Ads payment history." If connected, Cascade will call the Pinterest Ads tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "pinterest-ads-1-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

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.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Pinterest Ads now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Pinterest Ads MCP in Windsurf

Cascade uses the `list_campaigns` and `pause_campaign` tools to audit and adjust your live campaigns. You set the target CPA, and Cascade runs the necessary steps to pause or enable campaigns based on daily performance metrics.

Yes. Cascade calls `get_adgroup_analytics` to evaluate conversion rates and then uses `pause_campaign` to stop underperforming campaigns. This keeps your ad spend focused on high-ROAS ad groups.

Cascade runs `list_ads` and `get_campaign_analytics` to pull raw CTR, impression, and conversion data. It then analyzes this performance data directly in your editor to make optimization decisions.

No. Vinkius handles the OAuth authentication for this MCP Server at the account level. You only need to add your single endpoint token to your workspace configuration to grant Cascade full access to the tools.

All authentication details and campaign analytics run through a secure V8 Isolate sandbox. Your Pinterest credentials never touch the client directly, keeping your ad metrics and account access secure.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript