Connectors
Pinterest Ads MCP connector
The Pinterest Ads connector lets AI agents report on and manage Pinterest ad accounts through InsightfulPipe's hosted MCP server at https://pinterest-ads.insightfulmcp.com/. It covers account, campaign, ad group and ad analytics, async reports, targeting and audience insights, trending keywords, audiences, customer lists and conversion tags.
Pinterest Ads MCP server reference
- Endpoint
https://pinterest-ads.insightfulmcp.com/- Server name
pinterest-ads-mcp- Actions
- 44 (28 read, 16 write). Workspace owners, admins and operators choose which actions each connected account exposes, and destructive actions are off by default.
Add it from a terminal, then click Authorize access in the browser window that opens:
claude mcp add --transport http pinterest-ads-mcp https://pinterest-ads.insightfulmcp.com/
gemini mcp add --transport http pinterest-ads-mcp https://pinterest-ads.insightfulmcp.com/
codex mcp add pinterest-ads-mcp --url https://pinterest-ads.insightfulmcp.com/What agents can do
- Analytics: account, campaign, ad group and ad analytics, including saves and save rate, outbound clicks, checkout ROAS and video completions.
- Reports: create async reports, including product item and product group levels, then fetch them.
- Targeting insights: results by keyword, interest, age bucket and gender, audience insights and trending keywords.
- Management: create and update campaigns, ad groups, ads and keywords.
- Audiences and measurement: create and update audiences and customer lists, upload customer list files, and create conversion tags.
- Catalogs: list catalogs and catalog feeds.
Before you connect
- A Pinterest login with access to the ad account.
Connect Pinterest Ads
- In the InsightfulPipe app, open Connectors, choose Pinterest Ads and click Connect.
- Choose Read Only or Read + Write.
- Sign in with Pinterest and approve access.
- Select the ad accounts to connect.
- Add the MCP server to Claude, ChatGPT or another client, then click Authorize access.
Permissions and safety
- Management actions need Read + Write.
- Writes are create and update only. No delete actions are exposed, and campaign, ad group and ad status changes stay PAUSED for safety.
Limits
- Activate campaigns, ad groups and ads in Pinterest Ads Manager.
- Report results are async, so the agent may need to fetch a report again when it's ready.
Example prompts
- "Using Pinterest Ads, show spend, saves and outbound clicks by campaign for the last 30 days."
- "Which interests and age buckets drove the most conversions last month?"
- "What are the trending keywords in home decor in the US?"
- "Create a paused ad group for the spring collection with a $30 daily budget."
Troubleshooting
- No ad accounts are returned: check that your Pinterest login has access to an ad account, then reconnect.
- "This account is connected read-only, so this action cannot be enabled for it." Reconnect with Read + Write.