Skip to content
MCP server

Pinterest Ads

Read Pinterest ad reports, Trends and catalogs and stage previewed changes by chat

Runs locallyStatus and history
Install
Pricing
Freemium
Platforms
Web, API, CLI
Runs
Locally
Version
2.1.2
Listing updated
3 days ago

About Pinterest Ads

Pinterest Ads is a freemium MCP server for marketing and seo. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a 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

Add to claude_desktop_config.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>"
      }
    }
  }
}

Add to ~/.cursor/mcp.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>"
      }
    }
  }
}

Add to .vscode/mcp.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>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.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>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "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>"
      }
    }
  }
}

Configuration

  • PINTEREST_ACCESS_TOKENPinterest access token with the ads:read scope.
  • PINTEREST_REFRESH_TOKENRefresh token, so the server can renew the access token.
  • PINTEREST_APP_IDApp ID, needed for refresh.
  • PINTEREST_APP_SECRETApp secret, needed for refresh.
  • PINTEREST_AD_ACCOUNT_IDSRecommended. Comma-separated ad account IDs this server may use; other accounts are refused. Required from 3.0.0.
  • PINTEREST_AD_ACCOUNT_IDDefault ad account ID. It must be one of PINTEREST_AD_ACCOUNT_IDS when both are set.
  • PINTEREST_ENABLE_WRITESSet to true to expose 30 write tools. Default calls preview; confirm:true applies changes.
  • PINTEREST_ENVIRONMENTAPI environment: production (default) or sandbox. Use credentials issued for that environment.
  • LOG_LEVELLog level written to stderr: debug, info (default), warn or error.

Tools this server provides (1)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Freemium, from $39 a month

Hosted: Free (1 ad account, 200 requests/month), Pro $39/mo, Team $99/mo; open-source npm server is Apache 2.0

Prices change. Check getmcpads.com before you buy.

Pinterest Ads 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 to Pinterest Ads

  1. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  2. Calven

    MCP server

    Product marketing context from Calven delivered into Claude, ChatGPT and other AI tools

    Not checked yet
    • Remote
    • Free trial
    • 3 GitHub stars
    • Marketing and SEO
  3. MCP

    MCP server

    MCP server for planning, scheduling and measuring social and ad campaigns with approvals

    • Remote
    • Freemium
    • Marketing and SEO
  4. Free website checks for AI readiness, DNS dependencies, domain health and Bubble errors

    • 5 tools
    • Remote
    • Free
    • Marketing and SEO
  5. ASOScan

    MCP server

    ASO data for your own iOS and Android apps: rankings, keywords, reviews, scores

    • Remote
    • Free trial
    • Marketing and SEO
  6. PostBaton

    MCP server

    Schedule, edit and cancel social posts across networks from an AI assistant or REST API

    Not checked yet
    • Remote
    • Freemium
    • Marketing and SEO