Pinterest Ads MCP Server

Pinterest Ads MCP Server exposes Pinterest's Ad Transparency Repository as three MCP tools callable by Claude, GPT-4, and any MCP-compatible AI agent. It returns ad creative data, targeting parameters, reach estimates, and advertiser information for EU/BR/TR markets. Connect it to Claude Desktop or any MCP client and query Pinterest ads in natural language.

What tools are available?

Tool	Description
search_ads	Search ads by country, category, gender, age, advertiser name, and date range
get_ad_details	Retrieve full details for a specific ad by pin ID
get_advertiser_ads	Get all ads from a named advertiser in a specific country

Data returned by each tool

Each tool returns structured ad objects with:

Field	Description
id	Pinterest pin ID
advertiserName	Advertiser name
title	Ad creative title
description	Full ad description
imageUrl	Pinterest CDN image URL
domain	Advertiser website domain
url / productUrl	Ad and product landing page URLs
startDate / endDate	Ad flight dates (ISO 8601)
targeting	Ages, genders, countries, regions, interests, keywords
reach	EU reach range, per-country breakdown
country	Country filter applied

How to connect

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "pinterest-ads": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://actors-mcp-server.apify.com/mcp?actors=zadexinho/pinterest-ads-mcp-server&token=YOUR_APIFY_TOKEN"
      ]
    }
  }
}

Replace YOUR_APIFY_TOKEN with your Apify API token.

Direct MCP endpoint

https://zadexinho--pinterest-ads-mcp-server.apify.actor/mcp

Requires Authorization: Bearer YOUR_APIFY_TOKEN header.

How much does it cost?

Each tool call is charged at $0.005. You are charged per call, not per result.

Example	Calls	Cost
Quick query	5	$0.025
Research session	20	$0.10
Automated pipeline	100	$0.50

Example tool calls

Search French beauty ads:

{
  "tool": "search_ads",
  "arguments": {
    "country": "FR",
    "category": "BEAUTY",
    "maxResults": 10
  }
}

Get ads from a specific advertiser:

{
  "tool": "get_advertiser_ads",
  "arguments": {
    "advertiserName": "Sephora",
    "country": "FR",
    "maxResults": 20
  }
}

Get details for a specific pin:

{
  "tool": "get_ad_details",
  "arguments": {
    "pinId": "1120340844803190055",
    "country": "FR"
  }
}

Natural language queries (Claude Desktop)

Once connected, you can ask Claude:

• "Show me beauty ads running in France right now"
• "What ads is Sephora running in Germany?"
• "Find electronics ads targeting women aged 25-34 in Spain"
• "Compare ad creatives from ASOS across France and Germany"
• "What advertisers are running ads in Brazil?"

Supported countries

EU27 + Brazil + Turkey. The United States is not available — Pinterest only publishes Ad Transparency data for markets covered by the Digital Services Act.

Tools reference

search_ads

Search Pinterest's ad library with filters.

Parameter	Type	Required	Description
country	string	Yes	Country code (e.g., FR, DE, BR)
category	string	No	Ad vertical (BEAUTY, ELECTRONICS, FASHION, etc.)
gender	string	No	MALE, FEMALE, or ALL
age	string	No	Age group (18-24, 25-34, 35-44, 45-54, 55+, or ALL)
advertiserName	string	No	Partial advertiser name match
startDate	string	No	Start date YYYY-MM-DD
endDate	string	No	End date YYYY-MM-DD
maxResults	integer	No	Max ads to return (default: 10)

get_ad_details

Retrieve full details for a specific pin ID.

Parameter	Type	Required	Description
pinId	string	Yes	Pinterest pin ID
country	string	Yes	Country context for reach data

get_advertiser_ads

Get all ads from a named advertiser.

Parameter	Type	Required	Description
advertiserName	string	Yes	Advertiser name (partial match)
country	string	Yes	Country to search in
maxResults	integer	No	Max ads to return (default: 20)

FAQ

Which AI clients work with this server? Any MCP-compatible client: Claude Desktop, Claude Code, Cursor, Windsurf, or custom integrations using the MCP protocol.

Can I use this in automated pipelines? Yes. The MCP endpoint accepts standard HTTP requests with Bearer token auth. Use it in n8n, Make, or any HTTP-capable automation tool.

What's the difference between this and the scraper actor? The Pinterest Ads Scraper writes results to a dataset (batch use). This MCP server returns results synchronously to AI agents (interactive use). Both pull from the same data source.

Are results cached? Pinterest serves live data from its Ad Transparency API. Results reflect what is currently active in the ad repository.