Connectors
Updated

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

  1. In the InsightfulPipe app, open Connectors, choose Pinterest Ads and click Connect.
  2. Choose Read Only or Read + Write.
  3. Sign in with Pinterest and approve access.
  4. Select the ad accounts to connect.
  5. 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.

Need help?

If you need help connecting a source or setting up an AI workflow, the team can help you get from first sync to production faster.