Pinterest Ads MCP Server

Submit native CREATE/UPDATE/UPSERT/DELETE catalog item operations. Poll the returned batch ID before reporting completion. Preview by default. No automatic mutation retry. Native API eligibility and scopes still apply.

Create a PAUSED ad from an accessible Pin. Native specification supports Pinterest creative formats subject to eligibility. Preview by default. No automatic mutation retry. Native API eligibility and scopes still apply.

Create a PAUSED ad group with explicit native bidding, targeting, budget and schedule. Performance+ requires explicit performancePlusUnderPausedCampaign consent: its group is ACTIVE while the parent campaign must remain PAUSED. Preview by default. No automatic mutation retry. Native API eligibility and scopes still apply.

Create /boards in the selected advertiser context. Preview by default. No automatic mutation retry. Native API eligibility and scopes still apply.

Create a PAUSED campaign. Monetary convenience fields use the account currency. Campaign Budget Optimization defaults to true; non-CBO eligibility is account-specific. Preview by default. No automatic mutation retry. Native API eligibility and scopes still apply.

Create /catalogs in the selected advertiser context. Preview by default. No automatic mutation retry. Native API eligibility and scopes still apply.

Create /catalogs/feeds in the selected advertiser context. Preview by default. No automatic mutation retry. Native API eligibility and scopes still apply.

Create a PAUSED collection with an explicitly selected image/video hero Pin and an accessible catalog product group. Does not create catalog-only/DPA ads. Standard account eligibility is required; unavailable in Sandbox. Preview by default. No automatic mutation retry. Native API eligibility and scopes still apply.

Create /pins in the selected advertiser context. Preview by default. No automatic mutation retry. Native API eligibility and scopes still apply.

Create /catalogs/product_groups in the selected advertiser context. Preview by default. No automatic mutation retry. Native API eligibility and scopes still apply.

Create a PAUSED shopping or collections promotion from a catalog product group. Unavailable in Sandbox. Preview by default. No automatic mutation retry. Native API eligibility and scopes still apply.

Run non-mutating Pinterest planning computations: ad-group audience size, bid floors, or campaign delivery estimates. The request body follows the selected Pinterest v5 schema and no campaign/ad group is created or changed.

Read Pinterest ad-account entities and configuration. Covers account, campaign, ad group, ad, product-group promotion, promotion, label, schedule, targeting template, and order-line inventory. Returns one API page and its bookmark for predictable live queries.

Read aggregated Pinterest Audience Insights for the advertiser's total or engaged audience, Pinterest's total audience, or the scope/type endpoint. Pinterest fixes the audience-insights observation window; it is not a custom date-range report.

Read audience, customer-list, sharing, and Business-received audience inventory without uploading or changing audience membership.

Read billing profiles/invoices, invoice download URLs, order lines, ads-credit discounts, and SSIO account/order status. Financial data is returned only when the token has account access.

Read Pinterest Business Access inventory: employers/linked businesses, assets, members, partners, assigned assets, received audiences, and invites. Requires the corresponding business-management permissions.

Read deep catalog inventory and diagnostics: catalogs, feeds, feed processing results, item issues, product groups, product counts/products, available filter values, and catalog item lookups. ITEMS is a read-only POST lookup.

List Pinterest catalog inventory surfaces: catalogs, product groups, product group promotions, and optional product samples.

Inspect Pinterest conversion measurement configuration: conversion tags, oCPM-eligible/page-visit tags, Event Quality Score, advertiser-defined events, and conversion-deletion request status. This never sends or deletes conversion events.

Fetch Pinterest creative assets and period performance when available. Returns ads, pins, thumbnails/images/videos, campaign/ad group context, catalog signals, and asset classifications.

Read Pinterest resources/delivery_metrics. Use this to inspect Pinterest's official delivery metric metadata for sync or async reports.

Read assigned targeting keywords, Pinterest country-level keyword metrics, suggested terms, or related terms. Country metrics accept up to 2,000 keywords per request.

Read lead-form definitions and lead subscription configuration. Lead-record export is intentionally excluded because it can contain end-user PII.

Read organic Pinterest content used alongside ads: Pins, boards, Pins on a board, Pin product tags, or search results. This is inventory metadata, not proof of paid delivery.

Read paid Pin analytics, organic multi/single-Pin analytics, user-account analytics, top Pins, or top video Pins. Pass raw metric names supported by the selected Pinterest endpoint.

Read Pinterest platform metadata and readiness resources: supported ad-account countries, delivery metric definitions, metrics readiness, lead-form questions, media upload metadata, commerce integration metadata, or the authenticated user account.

Read Pinterest's official targeting option catalog for app type, gender, locale, age, location/geo, interest, keyword, or audience. Can also resolve a specific interest ID.

Read Pinterest Trends: top growing/monthly/yearly/seasonal keywords by supported region, growing product categories, product-category details, featured topics, or editorial articles.

Read processing status for this advertiser-bound uploaded video. Only ready:true permits video Pin creation; registration or HTTP 204 is insufficient.

Read the official Pinterest v5 native request schema and Sandbox limitations before composing a write.

Read-only Pinterest Ads health check. Verifies configured credentials, account access, delivery metrics access, and optional default account readability without exposing OAuth tokens.

List Pinterest ad accounts accessible to the configured credentials.

List the ad account's ad creatives across every status (the API silently omits ARCHIVED ads unless asked) with their pin media resolved: public i.pinimg.com image URLs up to 1200px, video cover, and video_url when the app is allowed to read it. Catalog-driven formats are excluded by default.

Register an upload for a frozen Launcher video and save its opaque receipt before transferring bytes. Does not create a Pin or ad. Preview, confirm, upload, then check processing.

Register media upload; returned upload_url/parameters are not confirmation that a video is uploaded or ready. Preview by default. No automatic mutation retry. Native API eligibility and scopes still apply.

Run Pinterest catalog reporting by PRODUCT_GROUP or PRODUCT_ITEM. PRODUCT_ITEM history is limited to 92 days before today (UTC), with requests chunked into 31-day windows; older item performance cannot be retrieved by retrying. Use PRODUCT_GROUP for older catalog delivery totals, not individual SKU performance.

Run Pinterest async conversion product reporting by brand, category, brand+category, SKU, or SKU group via reports/brand_category_sku. This is a restricted Pinterest feature: Standard API access alone does not guarantee availability for the client. It is separate from PRODUCT_ITEM spend reporting.

Run a read-only Pinterest Ads report. Auto-routes old/wide or explicit async requests through Pinterest async reports. Uses raw Pinterest reporting column names.

Start or inspect non-mutating Pinterest data jobs for Marketing Mix Modeling (MMM), bulk advertiser entity downloads, or catalog diagnostics. START creates only a report/export artifact; it never updates delivery entities.

Run live targeting analytics for an ad account, campaigns, ad groups, or ads, broken down by age, gender, location, interest, keyword, audience, placement, device, or other Pinterest targeting types. For data older than the sync window, use pinterest_run_report with targetingTypes and executionMode=async.

Update native ad settings. Read the existing entity first; nested specifications may replace existing values. Preview by default. No automatic mutation retry. Native API eligibility and scopes still apply.

Update the status of an existing ad. Preview by default. No automatic mutation retry. Native API eligibility and scopes still apply.

Set exactly one daily or lifetime ad group budget in major account currency units. Preview by default. No automatic mutation retry. Native API eligibility and scopes still apply.

Update native ad group settings. Read the existing entity first; nested specifications may replace existing values. Preview by default. No automatic mutation retry. Native API eligibility and scopes still apply.

Update the status of an existing adgroup. Preview by default. No automatic mutation retry. Native API eligibility and scopes still apply.

Update /boards in the selected advertiser context. Preview by default. No automatic mutation retry. Native API eligibility and scopes still apply.

Set exactly one daily or lifetime campaign budget in major account currency units. Preview by default. No automatic mutation retry. Native API eligibility and scopes still apply.

Update native campaign settings. Read the existing entity first; nested specifications may replace existing values. Preview by default. No automatic mutation retry. Native API eligibility and scopes still apply.

Update the status of an existing campaign. Preview by default. No automatic mutation retry. Native API eligibility and scopes still apply.

Update /catalogs/feeds in the selected advertiser context. Preview by default. No automatic mutation retry. Native API eligibility and scopes still apply.

Update a Pin. Requires Pinterest restricted pin_edit entitlement in addition to pins:write; Standard alone is insufficient. Preview by default. No automatic mutation retry. Native API eligibility and scopes still apply.

Update /catalogs/product_groups in the selected advertiser context. Preview by default. No automatic mutation retry. Native API eligibility and scopes still apply.

Update a catalog product group promotion. Unavailable in Sandbox. Preview by default. No automatic mutation retry. Native API eligibility and scopes still apply.

Stream the frozen video to the native destination saved in uploadReceipt. No bearer credential is sent to storage. Does not register another media or activate advertising. Follow with pinterest_get_video_upload.

Validate and preview how a Pinterest report will execute. Returns sync/async routing, endpoint, level, columns, attribution settings, and warnings without calling performance endpoints.