Pinterest Ads
Read Pinterest ad reports, Trends and catalogs and stage previewed changes by chat
- 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-serverAdd 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

Google Ads + Meta Ads + SEO/GEO MCP
MCP serverHosted 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

Calven
MCP serverProduct marketing context from Calven delivered into Claude, ChatGPT and other AI tools
Not checked yet- Remote
- Free trial
- 3 GitHub stars
- Marketing and SEO

MCP
MCP serverMCP server for planning, scheduling and measuring social and ad campaigns with approvals
- Remote
- Freemium
- Marketing and SEO

Red Center Studio free tools
MCP serverFree website checks for AI readiness, DNS dependencies, domain health and Bubble errors
- 5 tools
- Remote
- Free
- Marketing and SEO

ASOScan
MCP serverASO data for your own iOS and Android apps: rankings, keywords, reviews, scores
- Remote
- Free trial
- Marketing and SEO

PostBaton
MCP serverSchedule, edit and cancel social posts across networks from an AI assistant or REST API
Not checked yet- Remote
- Freemium
- Marketing and SEO