# Pinterest Ads

> Pinterest Ads is a freemium MCP server for marketing and seo. Read Pinterest ad reports, Trends and catalogs and stage previewed changes by chat. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $39 a month
- **Platforms:** Web, API, CLI
- **Website:** https://www.getmcpads.com/tools/pinterest-ads
- **Repository:** https://github.com/get-mcp-ads/pinterest-ads-mcp-server
- **MCP Registry name:** com.getmcpads/pinterest-ads
- **Categories:** marketing and SEO
- **Listing updated:** 2026-11-14

## About

This server is about Pinterest Ads, not organic Pins: campaigns, ad groups, ads, catalogs and Pinterest Trends, read through the ads API. Pins that a launch creates are ad-only and are never posted to your profile.

Beyond reporting (91 metrics and 36 dimensions, split by age, gender and device, including checkout value), it looks up what people are searching for on Pinterest by country and suggests keywords for targeting. Catalog tools show which product groups sell and which items have feed errors, and a check reports whether your Pinterest tag is set up to optimise.

Changes are limited to pausing, resuming and budgets in the first pass, each with a separate preview and apply step, and the OAuth consent lists ads, pins, boards, catalogs and account scopes. The npm server (29 read, 30 write tools) uses `PINTEREST_AD_ACCOUNT_IDS` as a recommended allowlist and can refresh tokens with an app ID and secret.

## Features

- **Pinterest Trends:** Shows current searches by country and keyword ideas.
- **Catalog health:** Finds product groups that sell and items with feed errors.
- **Tag readiness:** Checks whether the Pinterest tag is set up for optimisation.
- **Segmented reports:** 91 metrics and 36 dimensions, by age, gender and device.
- **Ad-only Pins:** Pins from a launch are never published to a profile.
- **Previewed budgets:** Pause, resume and budget changes need a separate apply step.

## Good for

- Report checkout value by campaign for a holiday push
- See which home-decor terms are trending
- Find catalog items with feed errors
- Pause underperforming ad groups after a preview
- Compare creatives day by day

## Install

### Claude Code (Terminal)

```sh
claude mcp add pinterest-ads --env PINTEREST_ACCESS_TOKEN='<PINTEREST_ACCESS_TOKEN>' --env PINTEREST_REFRESH_TOKEN='<PINTEREST_REFRESH_TOKEN>' --env PINTEREST_APP_SECRET='<PINTEREST_APP_SECRET>' -- npx -y @getmcpads/pinterest-ads-mcp-server
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "pinterest-ads": {
      "command": "npx",
      "args": [
        "-y",
        "@getmcpads/pinterest-ads-mcp-server"
      ],
      "env": {
        "PINTEREST_ACCESS_TOKEN": "<PINTEREST_ACCESS_TOKEN>",
        "PINTEREST_REFRESH_TOKEN": "<PINTEREST_REFRESH_TOKEN>",
        "PINTEREST_APP_SECRET": "<PINTEREST_APP_SECRET>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "pinterest-ads": {
      "command": "npx",
      "args": [
        "-y",
        "@getmcpads/pinterest-ads-mcp-server"
      ],
      "env": {
        "PINTEREST_ACCESS_TOKEN": "<PINTEREST_ACCESS_TOKEN>",
        "PINTEREST_REFRESH_TOKEN": "<PINTEREST_REFRESH_TOKEN>",
        "PINTEREST_APP_SECRET": "<PINTEREST_APP_SECRET>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "pinterest-ads": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@getmcpads/pinterest-ads-mcp-server"
      ],
      "env": {
        "PINTEREST_ACCESS_TOKEN": "<PINTEREST_ACCESS_TOKEN>",
        "PINTEREST_REFRESH_TOKEN": "<PINTEREST_REFRESH_TOKEN>",
        "PINTEREST_APP_SECRET": "<PINTEREST_APP_SECRET>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "pinterest-ads": {
      "command": "npx",
      "args": [
        "-y",
        "@getmcpads/pinterest-ads-mcp-server"
      ],
      "env": {
        "PINTEREST_ACCESS_TOKEN": "<PINTEREST_ACCESS_TOKEN>",
        "PINTEREST_REFRESH_TOKEN": "<PINTEREST_REFRESH_TOKEN>",
        "PINTEREST_APP_SECRET": "<PINTEREST_APP_SECRET>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "pinterest-ads": {
      "command": "npx",
      "args": [
        "-y",
        "@getmcpads/pinterest-ads-mcp-server"
      ],
      "env": {
        "PINTEREST_ACCESS_TOKEN": "<PINTEREST_ACCESS_TOKEN>",
        "PINTEREST_REFRESH_TOKEN": "<PINTEREST_REFRESH_TOKEN>",
        "PINTEREST_APP_SECRET": "<PINTEREST_APP_SECRET>"
      }
    }
  }
}
```

## Tools

- `pinterest_run_report`: Runs a campaign report such as spend, clicks and checkout value for a period.

## FAQ

### Does it post to my Pinterest profile?

No, the ad-only Pins from launches are never posted to your profile.

### What does it read besides ads?

Catalogs and Pinterest Trends.

### Is an account allowlist needed?

`PINTEREST_AD_ACCOUNT_IDS` is recommended; other accounts are refused when it is set.

### Is there a free option?

The hosted product has a free tier for one ad account.

### Is Pinterest Ads free?

Pinterest Ads has a free plan, with paid plans for more usage or features. Paid plans start at $39 a month.

### How do I add Pinterest Ads to Claude Code?

Run this command in your terminal: claude mcp add pinterest-ads --env PINTEREST_ACCESS_TOKEN='<PINTEREST_ACCESS_TOKEN>' --env PINTEREST_REFRESH_TOKEN='<PINTEREST_REFRESH_TOKEN>' --env PINTEREST_APP_SECRET='<PINTEREST_APP_SECRET>' -- npx -y @getmcpads/pinterest-ads-mcp-server

### What are the best alternatives to Pinterest Ads?

The closest alternatives to Pinterest Ads are Google Ads + Meta Ads + SEO/GEO MCP, Calven, MCP, Red Center Studio free tools and ASOScan.

## Alternatives

- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [MCP](https://ai-powered.com/mcp/mcp-mwhffe53): MCP is a freemium MCP server for marketing and seo.
- [Red Center Studio free tools](https://ai-powered.com/mcp/red-center-studio-free-tools): Red Center Studio free tools is a free MCP server for marketing and seo.
- [ASOScan](https://ai-powered.com/mcp/asoscan): ASOScan is an MCP server for marketing and seo.
- [PostBaton](https://ai-powered.com/mcp/postbaton): PostBaton is a freemium MCP server for marketing and seo.
- [Fifty Asks](https://ai-powered.com/mcp/fifty-asks): Fifty Asks is a free MCP server for maps and travel.
- [Daniels AI Design Studio](https://ai-powered.com/mcp/daniels-ai-design-studio): Daniels AI Design Studio is an MCP server for design and media.

---
Source: https://ai-powered.com/mcp/pinterest-ads
