Log inSubmit server
Pinterest Ads logo

Pinterest Ads

Read Pinterest Ads data and preview or apply selected campaign changes through MCP.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Pinterest Ads

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "pinterest-ads": {
      "command": "npx",
      "args": [
        "-y",
        "@getmcpads/pinterest-ads-mcp-server"
      ],
      "env": {
        "PINTEREST_ACCESS_TOKEN": "YOUR_VALUE_HERE",
        "PINTEREST_REFRESH_TOKEN": "YOUR_VALUE_HERE",
        "PINTEREST_APP_ID": "YOUR_VALUE_HERE",
        "PINTEREST_APP_SECRET": "YOUR_VALUE_HERE",
        "PINTEREST_AD_ACCOUNT_ID": "YOUR_VALUE_HERE",
        "PINTEREST_ENABLE_WRITES": "YOUR_VALUE_HERE",
        "LOG_LEVEL": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

The Pinterest Ads MCP server connects an MCP client to Pinterest advertising accounts for reporting, analytics, catalogs, audiences, targeting, and campaign operations. Read tools query Pinterest data directly, while write operations are disabled by default and use a preview-then-confirm flow. Use it when an agent needs to inspect Pinterest Ads performance or manage a limited set of campaign actions from a compatible MCP client.

Use cases

  • Run Pinterest campaign and targeting reports
  • Inspect catalogs, products, and feed diagnostics
  • Review audiences, keywords, and delivery estimates
  • Analyze paid Pins, organic content, and trends
  • Preview campaign creation or status changes

Key features

  • Pinterest Ads reporting and delivery metrics
  • Catalog inventory and diagnostics
  • Audience, targeting, and keyword analysis
  • Creative, Pin, organic, and trend analytics
  • Conversion and billing configuration reads
  • Preview-first campaign writes

Tools53

What Pinterest Ads lets your agent do. Expand a tool for its parameters.

Self-reported~1.6k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 3d ago

Recent health check succeeded.

5/6 checks healthy over the last 41d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 3h ago via OSV.dev · @getmcpads/pinterest-ads-mcp-server (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

npm downloads648Package downloads in the last 30 days.
Last commit1mo agoMost recent push to the default branch.
Tools exposed53Callable tools this server registers over MCP.

How Pinterest Ads works

What Pinterest Ads MCP server does

The Pinterest Ads MCP server exposes Pinterest advertising data and selected campaign operations through MCP. Its read capabilities cover ad accounts, delivery metrics, reports, creative assets, catalog inventory, conversion-product reporting, targeting analytics, keywords, audiences, audience insights, delivery estimates, conversion setup, catalog diagnostics, business assets, billing, Pin analytics, organic content, trends, and platform metadata.

The available write tools create a campaign in a paused state and update an existing campaign's status. The repository description also identifies preview-first behavior for write operations. The broader project documentation says writes are optional and disabled unless explicitly enabled.

How it works

An MCP client launches the server locally, and the server uses Pinterest platform credentials to make requests. Calls go directly to the platform when running the standalone release. pinterest_health_check can verify the token and show reachable ad accounts without exposing the token.

Reporting requests use Pinterest's native column names. pinterest_validate_report can check and preview a report before pinterest_run_report executes it. Other read tools provide specialized access to targeting options, catalog data, conversion configuration, creative media, trends, and account resources.

Write calls require an explicit confirmation step according to the repository documentation. A first call returns a preview without changing the live account; a repeated call with confirm: true applies the change. This makes the Pinterest Ads MCP server suitable for workflows that need review before mutation.

Setup and configuration

The repository release requires Node.js 22.12 or newer. From source, clone the release, run npm ci, and build the project. Configure the MCP client to run node with the absolute path to dist/cli.js; the README also provides an npx configuration for published packages.

Authentication requires either PINTEREST_ACCESS_TOKEN or the refresh configuration consisting of PINTEREST_REFRESH_TOKEN, PINTEREST_APP_ID, and PINTEREST_APP_SECRET. The access token needs the ads:read scope. Add ads:write if write tools will be enabled. PINTEREST_AD_ACCOUNT_ID can provide a default account, while PINTEREST_ENABLE_WRITES=1 registers write tools. LOG_LEVEL controls logging verbosity.

The README includes setup examples for Claude Desktop, Claude Code, and Cursor. Run npm run doctor to check the local setup.

Tools and capabilities

Notable read tools include:

  • pinterest_list_ad_accounts for accounts available to the configured credentials.
  • pinterest_run_report and pinterest_run_targeting_report for advertising and targeting analytics.
  • pinterest_get_catalog_inventory and pinterest_get_catalog_diagnostics for catalog and product data.
  • pinterest_get_audiences and pinterest_get_audience_insights for audience inventory and aggregated insights.
  • pinterest_get_conversion_setup for tags, event quality, and conversion configuration.
  • pinterest_get_pin_analytics, pinterest_get_organic_inventory, and pinterest_get_trends for paid and organic Pinterest data.
  • pinterest_create_campaign and pinterest_update_campaign_status for the listed campaign mutations.

Limitations and notes

Lead records are not returned. Lead-form and subscription configuration is available, but lead exports are excluded. Business member identifiers are redacted by default; personal identifiers can be requested with includePersonalIdentifiers: true.

The standalone repository does not include the hosted product's creative galleries or MCP Apps interface. Write access requires both explicit server configuration and Pinterest write permission. Review current tool schemas before reusing saved arguments after upgrades.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Pinterest Ads

Pinterest Ads is an MCP server that connects an MCP client to Pinterest advertising accounts. Its main tools read reports, audiences, catalogs, targeting, creatives, conversion settings, Pin analytics, and trends, while selected campaign operations can create paused campaigns or update campaign status with preview-first writes.

Install it by cloning the repository release, running `npm ci` and `npm run build`, then configuring your MCP client to launch the built `dist/cli.js`.

It requires either `PINTEREST_ACCESS_TOKEN` or the refresh-token trio of `PINTEREST_REFRESH_TOKEN`, `PINTEREST_APP_ID`, and `PINTEREST_APP_SECRET`. The access token needs `ads:read`; add `ads:write` when enabling write operations.

No. Write tools are disabled by default and require `PINTEREST_ENABLE_WRITES=1` plus Pinterest `ads:write` permission. The documented write flow previews the change first, and a later call with `confirm: true` applies it.

Yes. The README provides a Cursor configuration using `.cursor/mcp.json`. You must supply the Pinterest access credentials and configure Cursor to launch the local MCP server.

Related MCP servers

All in Marketing All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewPinterest Ads AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/pinterest-ads?style=directory)](https://allmcps.com/mcp/pinterest-ads)
HTML Embed
<a href="https://allmcps.com/mcp/pinterest-ads"><img src="https://allmcps.com/api/badge/pinterest-ads?style=directory" alt="Pinterest Ads on AllMCPs" /></a>