Pinterest Ads MCP API reference
Every Pinterest Ads tool the MCP server exposes, with its parameters. 31 tools, 91 metrics and 36 dimensions, on a dedicated endpoint.
40 rows
Delivery and catalogue reporting, targeting analytics, audience insights, billing.
Connection
- Platform id
pinterest_ads- Tool prefix
pinterest_- Account parameter
adAccountId- Dedicated endpoint
- https:/
/ mcp. getmcpads. com/ pinterest-ads/ mcp - Tools
- 31, 5 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 | Pause, resume and change budgets on Pinterest campaigns. Only reachable on a paid plan. | Yes |
CataloguesLink to this section
Write tools (5)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_ | Create a Pinterest campaign. | Write | On demand |
pinterest_ | Change the daily or lifetime budget of a Pinterest ad group. | Write | On demand |
pinterest_ | Pause, reactivate or archive a Pinterest ad group. | Write | On demand |
pinterest_ | Change the daily or lifetime budget of a Pinterest campaign. | Write | On demand |
pinterest_ | Pause or reactivate a Pinterest campaign. | Write | On demand |
Read tools (26)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-only Pinterest Ads health check. | Read | Announced |
pinterest_ | List Pinterest ad accounts accessible to the configured credentials. | 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:/ |