How to Use the Pinterest Ads MCP in Claude Code

Q: How do I configure this Pinterest Ads MCP Server in Claude Code?

Run claude mcp add --transport http pinterest-ads -- URL in your terminal. This command adds the server to your local configuration and makes all campaign tools available to the CLI.

Q: Can I pipe the output of Pinterest Ads tools in Claude Code to other CLI tools?

Yes. Claude Code runs listcampaigns or listads and displays the raw JSON output, which you can easily pipe to jq, awk, or local text files for further processing.

Q: How does Claude Code handle automated campaign optimization for Pinterest Ads?

You can instruct Claude Code to check your spend using getcampaignanalytics. If the cost-per-acquisition is too high, the CLI agent calls pausecampaign to stop the campaign instantly.

Run terminal-based Pinterest Ads audits and automate campaign controls directly from your shell using Claude Code.

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 Claude Code

Create your Vinkius account to connect Pinterest Ads to Claude Code — 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 Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Run headless Pinterest Ads audits from your terminal

Using `get_account_analytics`, Claude Code pulls high-level performance data directly into your terminal session. Piping this raw metrics output into standard shell utilities like grep or jq makes analysis incredibly fast. By combining this with `list_campaigns`, you can quickly filter your active campaigns by spend or conversions. This terminal workflow replaces the slow Pinterest Ads Manager web interface entirely.

Build lightweight cron jobs using this Pinterest Ads MCP Server

The `get_campaign_analytics` tool allows Claude Code to run automated performance checks via shell scripts or cron jobs using our MCP framework. Running these queries evaluates your campaign metrics against target CPA values in seconds. If a campaign underperforms, the agent calls `pause_campaign` to stop the spend automatically. This headless automation keeps your ad budget safe without requiring manual oversight.

Manage ad groups and creative assets via terminal commands

Running `list_adgroups` and `get_adgroup_analytics` inside Claude Code gives you a real-time view of your targeting performance. Isolating underperforming target groups is fast when you don't have to load heavy web pages. If you need to refresh your creative mix, `list_ads` lets you inspect individual Pins. You can then use `enable_campaign` to scale up the campaigns that feature your best-performing visual assets.

Setup guide

Set up Pinterest Ads MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see pinterest-ads-1-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest Pinterest Ads transactions." It will automatically discover and invoke the available Pinterest Ads tools.

Terminal

claude mcp add --transport http pinterest-ads-1-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
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

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "pinterest-ads-1-mcp": {
      "type": "url",
      "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 Claude Code

Run `claude mcp add --transport http pinterest-ads -- [URL]` in your terminal. This command adds the server to your local configuration and makes all campaign tools available to the CLI.

Yes. Claude Code runs `list_campaigns` or `list_ads` and displays the raw JSON output, which you can easily pipe to jq, awk, or local text files for further processing.

You can instruct Claude Code to check your spend using `get_campaign_analytics`. If the cost-per-acquisition is too high, the CLI agent calls `pause_campaign` to stop the campaign instantly.

It supports stdio, http, and sse transport protocols. You can configure the connection in your global config file to guarantee reliable headless execution.

Your Pinterest credentials and ad performance data are isolated inside Vinkius's zero-trust V8 sandbox. The CLI only receives the sanitized tool outputs, keeping your marketing accounts completely 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