Pinterest Ads MCP server
{
"mcpServers": {
"getmcpads-pinterest-ads": {
"command": "npx",
"args": [
"-y",
"@getmcpads/pinterest-ads-mcp-server@latest"
],
"env": {
"PINTEREST_ACCESS_TOKEN": "<pinterest_access_token>",
"PINTEREST_REFRESH_TOKEN": "<pinterest_refresh_token>",
"PINTEREST_APP_ID": "<pinterest_app_id>",
"PINTEREST_APP_SECRET": "<pinterest_app_secret>",
"PINTEREST_AD_ACCOUNT_ID": "<pinterest_ad_account_id>"
}
}
}
}{
"mcpServers": {
"getmcpads-pinterest-ads": {
"command": "npx",
"args": [
"-y",
"@getmcpads/pinterest-ads-mcp-server@latest"
],
"env": {
"PINTEREST_ACCESS_TOKEN": "<pinterest_access_token>",
"PINTEREST_REFRESH_TOKEN": "<pinterest_refresh_token>",
"PINTEREST_APP_ID": "<pinterest_app_id>",
"PINTEREST_APP_SECRET": "<pinterest_app_secret>",
"PINTEREST_AD_ACCOUNT_ID": "<pinterest_ad_account_id>"
}
}
}
}{
"mcpServers": {
"getmcpads-pinterest-ads": {
"command": "npx",
"args": [
"-y",
"@getmcpads/pinterest-ads-mcp-server@latest"
],
"env": {
"PINTEREST_ACCESS_TOKEN": "<pinterest_access_token>",
"PINTEREST_REFRESH_TOKEN": "<pinterest_refresh_token>",
"PINTEREST_APP_ID": "<pinterest_app_id>",
"PINTEREST_APP_SECRET": "<pinterest_app_secret>",
"PINTEREST_AD_ACCOUNT_ID": "<pinterest_ad_account_id>"
}
}
}
}{
"servers": {
"getmcpads-pinterest-ads": {
"command": "npx",
"args": [
"-y",
"@getmcpads/pinterest-ads-mcp-server@latest"
],
"env": {
"PINTEREST_ACCESS_TOKEN": "${input:pinterest_access_token}",
"PINTEREST_REFRESH_TOKEN": "${input:pinterest_refresh_token}",
"PINTEREST_APP_ID": "${input:pinterest_app_id}",
"PINTEREST_APP_SECRET": "${input:pinterest_app_secret}",
"PINTEREST_AD_ACCOUNT_ID": "${input:pinterest_ad_account_id}"
}
}
},
"inputs": [
{
"id": "pinterest_access_token",
"type": "promptString",
"description": "Pinterest access token",
"password": true
},
{
"id": "pinterest_refresh_token",
"type": "promptString",
"description": "Pinterest refresh token",
"password": true
},
{
"id": "pinterest_app_id",
"type": "promptString",
"description": "Pinterest app id",
"password": true
},
{
"id": "pinterest_app_secret",
"type": "promptString",
"description": "Pinterest app secret",
"password": true
},
{
"id": "pinterest_ad_account_id",
"type": "promptString",
"description": "Pinterest ad account id",
"password": true
}
]
}{
"mcpServers": {
"getmcpads-pinterest-ads": {
"command": "npx",
"args": [
"-y",
"@getmcpads/pinterest-ads-mcp-server@latest"
],
"env": {
"PINTEREST_ACCESS_TOKEN": "<pinterest_access_token>",
"PINTEREST_REFRESH_TOKEN": "<pinterest_refresh_token>",
"PINTEREST_APP_ID": "<pinterest_app_id>",
"PINTEREST_APP_SECRET": "<pinterest_app_secret>",
"PINTEREST_AD_ACCOUNT_ID": "<pinterest_ad_account_id>"
}
}
}
}file .mcp.json (in your project root)file claude_desktop_config.jsonfile ~/.cursor/mcp.jsonfile .vscode/mcp.jsonfile ~/.codeium/windsurf/mcp_config.jsoninstall npx -y @getmcpads/pinterest-ads-mcp-serverversion 1.0.2
What it does
An MCP server that connects Claude and other AI models to the Pinterest Ads API. It provides 26 read tools for accessing advertising data, campaigns, audiences, and reporting, plus 5 write tools for making changes—all with preview-before-apply safety. Runs locally under your control with no third-party data proxying.
- Pull Pinterest Ads reporting data and analyze campaign performance metrics using raw column names from the API.
- Review campaign status, budgets, audiences, and targeting configuration without leaving your Claude conversation.
- Create or modify campaigns and ad groups with a preview step before the changes are applied to your account.
Tools this server exposes
| Tool | Does |
|---|---|
| pinterest_health_check | Verifies the access token and lists the ad accounts you can reach. |
| pinterest_get_campaigns | Retrieve campaigns from your Pinterest ad account with status and configuration details. |
| pinterest_get_ad_groups | Fetch ad groups and their targeting, bidding, and status information. |
| pinterest_get_audiences | List audiences and audience targeting available in your account. |
| pinterest_get_keywords | Retrieve keywords and keyword targeting data for your ads. |
| pinterest_get_conversions | Access conversion tracking and events data from your campaigns. |
| pinterest_get_catalogs | Fetch product catalogs associated with your ad account. |
| pinterest_get_pin_analytics | Retrieve analytics for Pins, including organic and paid performance. |
| pinterest_get_trends | Access Pinterest trends data relevant to your advertising. |
| pinterest_validate_report | Validate a reporting request before it runs against the Pinterest Ads API. |
| pinterest_create_campaign | Create a new campaign with a preview before applying the change. |
| pinterest_update_campaign_status | Pause or activate a campaign with a preview before applying the change. |
| pinterest_update_campaign_budget | Modify campaign daily or total budget with a preview before applying. |
| pinterest_update_ad_group_status | Pause or activate an ad group with a preview before applying. |
| pinterest_update_ad_group_budget | Modify ad group budget with a preview before applying the change. |
Before you enable it
An MCP server runs with whatever access you give it. Start with a development account rather than production, and check which tools the server exposes before you let an agent call them unattended.