Pinterest Ads MCP server
Connect the dots in your Pinterest campaigns.
Explore reporting, audiences, catalogs and native campaign operations from your MCP client.
Power your agent
คำสั่งของผู้เผยแพร่เอง ไม่ใช่เอนด์พอยต์ของ PlugMCP
Host a copy with our keys and logs.
npx -y @getmcpads/[email protected]Claude Code ไม่มีลิงก์ติดตั้งสำหรับคำสั่งแบบโลคัล ให้คัดลอกคำสั่งด้านล่างแล้วรันในเทอร์มินัล
PINTEREST_ACCESS_TOKEN=<secret> PINTEREST_REFRESH_TOKEN=<secret> PINTEREST_APP_ID=<value> PINTEREST_APP_SECRET=<secret> PINTEREST_AD_ACCOUNT_IDS=<value> PINTEREST_AD_ACCOUNT_ID=<value> PINTEREST_ENABLE_WRITES=<value> PINTEREST_ENVIRONMENT=<value> LOG_LEVEL=<value> claude mcp add com.getmcpads-pinterest-ads -- npx -y @getmcpads/pinterest-ads-mcp-server@2.1.2รันในเทอร์มินัล
{ "mcpServers": { "com.getmcpads-pinterest-ads": { "command": "npx", "args": [ "-y", "@getmcpads/[email protected]" ], "env": { "PINTEREST_ACCESS_TOKEN": "<secret>", "PINTEREST_REFRESH_TOKEN": "<secret>", "PINTEREST_APP_ID": "<value>", "PINTEREST_APP_SECRET": "<secret>", "PINTEREST_AD_ACCOUNT_IDS": "<value>", "PINTEREST_AD_ACCOUNT_ID": "<value>", "PINTEREST_ENABLE_WRITES": "<value>", "PINTEREST_ENVIRONMENT": "<value>", "LOG_LEVEL": "<value>" } } }}claude_desktop_config.json
URL แบบรีโมตหรือคำสั่งบนเครื่องของคุณ? การติดตั้งสองแบบต่างกันอย่างไร
รันบน PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
เปิดThe film shows hosted getmcpads with sample data. Its MCP Apps, from creative galleries and alerts to Google Sheets exports and bulk launches, belong to the hosted product. This repository provides the standalone native API tools.
28 read tools · 25 write tools, disabled by default.
Run locally with your own platform credentials and a client that supports stdio MCP, such as Claude Desktop, Claude Code or Cursor. Your requests go directly to the platform. For managed connections, including supported ChatGPT setups, use the hosted option.
v2.0.1: Native tools and security update · September 20, 2026
Requires Node.js 22.12 or newer. CI covers Node 22 and 24. Version 2.0.1 drops Node 18 and 20 support. Read the current tool schemas before reusing saved arguments. Writes remain optional and require explicit confirmation. Hosted creative integrations and MCP Apps UI are outside this release.
This is a GitHub source release. npm and MCP Registry versions are published separately. The commands below select this exact version; unpinned npx examples later in this document select the version currently available on npm.
git clone --branch v2.0.1 --depth 1 https://github.com/get-mcp-ads/pinterest-ads-mcp-server.git
cd pinterest-ads-mcp-server
npm ci
npm run build
Configure your MCP client to run node with the absolute path to dist/cli.js and the platform credentials documented below.
Prefer a managed connection? Use Pinterest Ads with hosted getmcpads. Connect your account, select the data your assistant may access and use the hosted MCP connection. See the site for current features and plans.
Pinterest names its reporting columns in its own way, and this server accepts those names directly rather than inventing friendly aliases on top. A column that exists in the API works here; one that does not fails immediately rather than being silently translated into something else.
pinterest://reporting-columns lists what is available, and pinterest_validate_report
checks a request before it runs.
Two protections, and they work differently.
Lead records are never exposed. pinterest_get_lead_assets returns lead form and
subscription configuration, but never the lead export itself, because those rows carry
personal information submitted by end users. This is an exclusion, not a redaction: the data
does not leave Pinterest through this server at all.
Business member identifiers are redacted by default. Member IDs, email addresses and
usernames are replaced before they reach the model when you read members, asset members or
invites. includePersonalIdentifiers: true returns the raw values and defaults to false.
These are your colleagues' addresses, so the default is the safe one.
You need a Pinterest access token with the ads:read scope.
ads:read, and ads:write only if you plan to enable writes.You can run with just PINTEREST_ACCESS_TOKEN, but it expires. Supplying
PINTEREST_REFRESH_TOKEN, PINTEREST_APP_ID and PINTEREST_APP_SECRET together lets the
server renew the token itself, which is what you want for daily use.
Run pinterest_health_check as your first call. It verifies the token and lists the ad
accounts you can reach, without printing the token.
~/Library/Application Support/Claude/claude_desktop_config.json (macOS)
or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"pinterest-ads": {
"command": "npx",
"args": ["-y", "@getmcpads/pinterest-ads-mcp-server"],
"env": {
"PINTEREST_ACCESS_TOKEN": "your-token-here"
}
}
}
}
Restart Claude Desktop. Ask it: "list my Pinterest ad accounts".
claude mcp add pinterest-ads --env PINTEREST_ACCESS_TOKEN=your-token -- npx -y @getmcpads/pinterest-ads-mcp-server
.cursor/mcp.json in your project, same shape as the Claude Desktop config above.
git clone https://github.com/get-mcp-ads/pinterest-ads-mcp-server.git
cd pinterest-ads-mcp-server
npm install && npm run build
cp .env.example .env # then fill in your credentials
npm start
Either the access token, or the refresh trio. The server refuses to start with neither.
npm run doctor
Write tools are disabled by default. Enable them with PINTEREST_ENABLE_WRITES=1, and
grant ads:write on top of ads:read.
When enabled, every write tool returns a preview and changes nothing:
// pinterest_update_adgroup_budget { adAccountId: "549…", adGroupId: "268…", dailyBudget: 50 }
{
"applied": false,
"action": "pinterest_update_adgroup_budget",
"change": { "adAccount": "549…", "adGroup": "268…",
"field": "budget_in_micro_currency", "amount": 50,
"inMicroCurrency": 50000000 },
"message": "Preview only, nothing was changed. Repeat the same call with confirm: true to apply this change to the live account."
}
Only a second call carrying confirm: true touches the live account.
This is deliberate. An assistant composes these calls, and it can pick the wrong ad account, the wrong campaign, or the wrong order of magnitude on a budget. A mandatory preview makes the mistake visible before it costs money, and gives a human the stopping point the protocol does not guarantee on its own.
Two further guardrails:
pinterest_create_campaign always creates the campaign PAUSED. There is no option to
create it active.12500000. The preview shows both, so a
factor-of-a-million mistake is visible before it applies. A daily and a lifetime budget
sent together are refused rather than silently resolved.Every tool is listed below. See server-card.json for complete parameter and output schemas.
Disabled by default. Calls preview unless explicitly confirmed. Check the configuration and exact schema before use.
api.pinterest.com. A test fails the build if a
second host appears in the source.redirect: "error", so a redirect
cannot forward your token to another host. A test fails the build if any fetch omits this.Full policy, including how personal data is handled: SECURITY.md.
Try hosted Pinterest Ads if you want to use this source without operating a local server. getmcpads also connects advertising, Search Console and GA4 through one MCP URL. Source availability and plan limits are listed on the site; connecting an account is still required.
See the current hosted tool catalogue and pricing before choosing a paid plan. This Apache 2.0 adapter remains independently useful with your own credentials.
Issues and pull requests are welcome. See CONTRIBUTING.md. Please read SECURITY.md before reporting anything security-related.
Apache License 2.0. See also NOTICE.
Pinterest is a trademark of Pinterest, Inc. This project is not affiliated with, endorsed by, or sponsored by Pinterest, Inc. It is an independent client of a public API.
Every tool declares read/write annotations, parameter descriptions and a structured output schema. Successful calls expose the payload as structuredContent.result; errors retain isError: true. The generated server card contains definitions only.
Run npm run bundle -- /path/to/output to build a .mcpb desktop bundle from the current catalog. Credentials are entered locally during installation. Write tools remain disabled unless explicitly enabled.
Maintained by Emmanuel at getmcpads. Questions: [email protected].
Pinterest Ads MCP server: 29 read tools, 30 opt-in preview-first writes.
{ "mcpServers": { "com.getmcpads-pinterest-ads": { "command": "npx", "args": [ "-y", "@getmcpads/[email protected]" ], "env": { "PINTEREST_ACCESS_TOKEN": "<secret>", "PINTEREST_REFRESH_TOKEN": "<secret>", "PINTEREST_APP_ID": "<value>", "PINTEREST_APP_SECRET": "<secret>", "PINTEREST_AD_ACCOUNT_IDS": "<value>", "PINTEREST_AD_ACCOUNT_ID": "<value>", "PINTEREST_ENABLE_WRITES": "<value>", "PINTEREST_ENVIRONMENT": "<value>", "LOG_LEVEL": "<value>" } } }}เครื่องมือ
ยังไม่มีรายการเครื่องมือ เซิร์ฟเวอร์แบบรีโมตจะได้รายการหลังการตรวจสอบสถานะครั้งแรก
FAQ
คัดลอกคอนฟิก stdio สำหรับ Cursor, Claude Desktop, Claude Code หรือ VS Code ได้ในหน้านี้ คอนฟิกนี้ใช้การติดตั้งของผู้เผยแพร่ ไม่ใช่พร็อกซีของ PlugMCP
ผู้เผยแพร่ระบุตัวแปรสภาพแวดล้อมเหล่านี้: PINTEREST_ACCESS_TOKEN, PINTEREST_REFRESH_TOKEN, PINTEREST_APP_ID, PINTEREST_APP_SECRET, PINTEREST_AD_ACCOUNT_IDS, PINTEREST_AD_ACCOUNT_ID, PINTEREST_ENABLE_WRITES, PINTEREST_ENVIRONMENT, LOG_LEVEL
Pinterest Ads ทำงานแบบโลคัลผ่าน stdio
ตรวจสอบล่าสุดเมื่อ 2026-11-15 Pinterest Ads MCP server: 29 read tools, 30 opt-in preview-first writes.