Pinterest Ads MCP API reference
Every Pinterest Ads tool the MCP server exposes, with its parameters. 56 tools, 91 metrics and 36 dimensions, on a dedicated endpoint.
72 rows
Delivery and catalogue reporting, targeting analytics, audience insights, billing.
To connect another identity without replacing your existing access, open this source in the dashboard and choose Add another account. Select accounts from the combined list and save. See account scoping for selection, plan limits and reconnection.
Connection
- Platform id
pinterest_ads- Tool prefix
pinterest_- Account parameter
adAccountId- Dedicated endpoint
- https:/
/ mcp. getmcpads. com/ pinterest-ads/ mcp - Access
- Available for authorized, selected accounts.
- Tools
- 56, 27 of which write
- Metrics
- 91
- Dimensions
- 36
Scope requestedLink to this section
| Scope | Grants | Allows writes |
|---|---|---|
ads:read | Read Pinterest campaigns, ad groups, ads and analytics. | No |
ads:write | Create and update campaigns, ad groups and ads. Writes require a paid plan and explicit confirmation. | Yes |
pins:read | Read Pins and accessible creative images and videos. | No |
pins:write | Create and update Pins used as ad creatives. | Yes |
boards:read | Read boards that contain creative Pins. | No |
boards:write | Create and update boards for creative Pins. | Yes |
catalogs:read | Read catalogs, feeds, product groups and item processing results. | No |
catalogs:write | Create and update catalogs, feeds, product groups and catalog items. | Yes |
user_ | Identify the Pinterest account granting access. | No |
CataloguesLink to this section
Write tools (27)Link to this section
Absent from the tool list on the Free plan. Each one previews by default and needs a second call with confirm: true.
| Tool | What it does | Kind | Discovery |
|---|---|---|---|
pinterest_ | Submit native CREATE/UPDATE/UPSERT/DELETE catalog item operations. | Write | On demand |
pinterest_ | Create a PAUSED ad from an accessible Pin. | Write | On demand |
pinterest_ | Create a PAUSED ad group with explicit native bidding, targeting, budget and schedule. | Write | On demand |
pinterest_ | Create /boards in the selected advertiser context. | Write | On demand |
pinterest_ | Create a PAUSED campaign. | Write | On demand |
pinterest_ | Create /catalogs in the selected advertiser context. | Write | On demand |
pinterest_ | Create /catalogs/feeds in the selected advertiser context. | Write | On demand |
pinterest_ | Create a PAUSED collection with an explicitly selected image/video hero Pin and an accessible catalog product group. | Write | On demand |
pinterest_ | Create /pins in the selected advertiser context. | Write | On demand |
pinterest_ | Create /catalogs/product_groups in the selected advertiser context. | Write | On demand |
pinterest_ | Create a PAUSED shopping or collections promotion from a catalog product group. | Write | On demand |
pinterest_ | Register an upload for a frozen Launcher video and save its opaque receipt before transferring bytes. | Write | On demand |
pinterest_ | Register media upload; returned upload_url/parameters are not confirmation that a video is uploaded or ready. | Write | On demand |
pinterest_ | Update native ad settings. | Write | On demand |
pinterest_ | Update the status of an existing ad. | Write | On demand |
pinterest_ | Set exactly one daily or lifetime ad group budget in major account currency units. | Write | On demand |
pinterest_ | Update native ad group settings. | Write | On demand |
pinterest_ | Update the status of an existing adgroup. | Write | On demand |
pinterest_ | Update /boards in the selected advertiser context. | Write | On demand |
pinterest_ | Set exactly one daily or lifetime campaign budget in major account currency units. | Write | On demand |
pinterest_ | Update native campaign settings. | Write | On demand |
pinterest_ | Update the status of an existing campaign. | Write | On demand |
pinterest_ | Update /catalogs/feeds in the selected advertiser context. | Write | On demand |
pinterest_ | Update a Pin. | Write | On demand |
pinterest_ | Update /catalogs/product_groups in the selected advertiser context. | Write | On demand |
pinterest_ | Update a catalog product group promotion. | Write | On demand |
pinterest_ | Stream the frozen video to the native destination saved in uploadReceipt. | Write | On demand |
Read tools (29)Link to this section
Tools marked Announced appear in your client's tool list. The rest are reachable through search_tools and run_tool, which run the same checks.
| Tool | What it does | Kind | Discovery |
|---|---|---|---|
pinterest_ | Run non-mutating Pinterest planning computations: ad-group audience size, bid floors, or campaign delivery estimates. | Read | On demand |
pinterest_ | Read Pinterest ad-account entities and configuration. | Read | Announced |
pinterest_ | Read aggregated Pinterest Audience Insights for the advertiser's total or engaged audience, Pinterest's total audience, or the scope/type endpoint. | Read | On demand |
pinterest_ | Read audience, customer-list, sharing, and Business-received audience inventory without uploading or changing audience membership. | Read | On demand |
pinterest_ | Read billing profiles/invoices, invoice download URLs, order lines, ads-credit discounts, and SSIO account/order status. | Read | On demand |
pinterest_ | Read Pinterest Business Access inventory: employers/linked businesses, assets, members, partners, assigned assets, received audiences, and invites. | Read | On demand |
pinterest_ | 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. | Read | On demand |
pinterest_ | List Pinterest catalog inventory surfaces: catalogs, product groups, product group promotions, and optional product samples. | Read | On demand |
pinterest_ | Inspect Pinterest conversion measurement configuration: conversion tags, oCPM-eligible/page-visit tags, Event Quality Score, advertiser-defined events, and conversion-deletion request status. | Read | On demand |
pinterest_ | Fetch Pinterest creative assets and period performance when available. | Read | On demand |
pinterest_ | Read Pinterest resources/delivery_metrics. | Read | Announced |
pinterest_ | Read assigned targeting keywords, Pinterest country-level keyword metrics, suggested terms, or related terms. | Read | On demand |
pinterest_ | Read lead-form definitions and lead subscription configuration. | Read | On demand |
pinterest_ | Read organic Pinterest content used alongside ads: Pins, boards, Pins on a board, Pin product tags, or search results. | Read | On demand |
pinterest_ | Read paid Pin analytics, organic multi/single-Pin analytics, user-account analytics, top Pins, or top video Pins. | Read | On demand |
pinterest_ | 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 | On demand |
pinterest_ | Read Pinterest's official targeting option catalog for app type, gender, locale, age, location/geo, interest, keyword, or audience. | Read | On demand |
pinterest_ | Read Pinterest Trends: top growing/monthly/yearly/seasonal keywords by supported region, growing product categories, product-category details, featured topics, or editorial articles. | Read | On demand |
pinterest_ | Read processing status for this advertiser-bound uploaded video. | Read | On demand |
pinterest_ | Read the official Pinterest v5 native request schema and Sandbox limitations before composing a write. | Read | On demand |
pinterest_ | Read-only Pinterest Ads health check. | Read | Announced |
pinterest_ | List Pinterest ad accounts accessible to the configured credentials. | Read | Announced |
pinterest_ | 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. | Read | Announced |
pinterest_ | Run Pinterest catalog reporting by PRODUCT_GROUP or PRODUCT_ITEM. | Read | On demand |
pinterest_ | Run Pinterest async conversion product reporting by brand, category, brand+category, SKU, or SKU group via reports/brand_category_sku. | Read | On demand |
pinterest_ | Run a read-only Pinterest Ads report. | Read | Announced |
pinterest_ | Start or inspect non-mutating Pinterest data jobs for Marketing Mix Modeling (MMM), bulk advertiser entity downloads, or catalog diagnostics. | Read | On demand |
pinterest_ | 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. | Read | On demand |
pinterest_ | Validate and preview how a Pinterest report will execute. | Read | On demand |
MCP resourcesLink to this section
Read these with resources/read for machine readable metadata about the source.
| Name | URI |
|---|---|
| pinterest-manifest | pinterest:/ |
| pinterest-reporting-columns | pinterest:/ |
| pinterest-attribution | pinterest:/ |
| pinterest-creative-assets | pinterest:/ |
| pinterest-catalog-reporting | pinterest:/ |
| pinterest-surface-map | pinterest:/ |
| pinterest-recipes | pinterest:/ |