# Pinterest Ads

> Every Pinterest Ads tool the MCP server exposes, with its parameters. 31 tools, 91 metrics and 36 dimensions, on a dedicated endpoint.

[Documentation](https://www.getmcpads.com/docs) / [Sources](https://www.getmcpads.com/docs/sources)

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 requested

| 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 |

> **Note** What the gateway can change here: Pause, resume or archive a campaign or ad group. Change a campaign or ad group budget. Create a campaign, always paused.

## Catalogues

- [Metrics](https://www.getmcpads.com/docs/sources/pinterest-ads/metrics): 91 metrics, with the field name each one maps to.
- [Dimensions](https://www.getmcpads.com/docs/sources/pinterest-ads/dimensions): 36 dimensions, with their constraints.

## Write tools (5)

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_campaign`](https://www.getmcpads.com/docs/sources/pinterest-ads/tools/pinterest_create_campaign) | Create a Pinterest campaign. | Write | On demand |
| [`pinterest_update_adgroup_budget`](https://www.getmcpads.com/docs/sources/pinterest-ads/tools/pinterest_update_adgroup_budget) | Change the daily or lifetime budget of a Pinterest ad group. | Write | On demand |
| [`pinterest_update_adgroup_status`](https://www.getmcpads.com/docs/sources/pinterest-ads/tools/pinterest_update_adgroup_status) | Pause, reactivate or archive a Pinterest ad group. | Write | On demand |
| [`pinterest_update_campaign_budget`](https://www.getmcpads.com/docs/sources/pinterest-ads/tools/pinterest_update_campaign_budget) | Change the daily or lifetime budget of a Pinterest campaign. | Write | On demand |
| [`pinterest_update_campaign_status`](https://www.getmcpads.com/docs/sources/pinterest-ads/tools/pinterest_update_campaign_status) | Pause or reactivate a Pinterest campaign. | Write | On demand |

## Read tools (26)

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_estimate_delivery`](https://www.getmcpads.com/docs/sources/pinterest-ads/tools/pinterest_estimate_delivery) | Run non-mutating Pinterest planning computations: ad-group audience size, bid floors, or campaign delivery estimates. | Read | On demand |
| [`pinterest_get_account_entities`](https://www.getmcpads.com/docs/sources/pinterest-ads/tools/pinterest_get_account_entities) | Read Pinterest ad-account entities and configuration. | Read | Announced |
| [`pinterest_get_audience_insights`](https://www.getmcpads.com/docs/sources/pinterest-ads/tools/pinterest_get_audience_insights) | 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_get_audiences`](https://www.getmcpads.com/docs/sources/pinterest-ads/tools/pinterest_get_audiences) | Read audience, customer-list, sharing, and Business-received audience inventory without uploading or changing audience membership. | Read | On demand |
| [`pinterest_get_billing_and_orders`](https://www.getmcpads.com/docs/sources/pinterest-ads/tools/pinterest_get_billing_and_orders) | Read billing profiles/invoices, invoice download URLs, order lines, ads-credit discounts, and SSIO account/order status. | Read | On demand |
| [`pinterest_get_business_assets`](https://www.getmcpads.com/docs/sources/pinterest-ads/tools/pinterest_get_business_assets) | Read Pinterest Business Access inventory: employers/linked businesses, assets, members, partners, assigned assets, received audiences, and invites. | Read | On demand |
| [`pinterest_get_catalog_diagnostics`](https://www.getmcpads.com/docs/sources/pinterest-ads/tools/pinterest_get_catalog_diagnostics) | 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_get_catalog_inventory`](https://www.getmcpads.com/docs/sources/pinterest-ads/tools/pinterest_get_catalog_inventory) | List Pinterest catalog inventory surfaces: catalogs, product groups, product group promotions, and optional product samples. | Read | On demand |
| [`pinterest_get_conversion_setup`](https://www.getmcpads.com/docs/sources/pinterest-ads/tools/pinterest_get_conversion_setup) | 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_get_creative_assets`](https://www.getmcpads.com/docs/sources/pinterest-ads/tools/pinterest_get_creative_assets) | Fetch Pinterest creative assets and period performance when available. | Read | On demand |
| [`pinterest_get_delivery_metrics`](https://www.getmcpads.com/docs/sources/pinterest-ads/tools/pinterest_get_delivery_metrics) | Read Pinterest resources/delivery_metrics. | Read | Announced |
| [`pinterest_get_keyword_intelligence`](https://www.getmcpads.com/docs/sources/pinterest-ads/tools/pinterest_get_keyword_intelligence) | Read assigned targeting keywords, Pinterest country-level keyword metrics, suggested terms, or related terms. | Read | On demand |
| [`pinterest_get_lead_assets`](https://www.getmcpads.com/docs/sources/pinterest-ads/tools/pinterest_get_lead_assets) | Read lead-form definitions and lead subscription configuration. | Read | On demand |
| [`pinterest_get_organic_inventory`](https://www.getmcpads.com/docs/sources/pinterest-ads/tools/pinterest_get_organic_inventory) | Read organic Pinterest content used alongside ads: Pins, boards, Pins on a board, Pin product tags, or search results. | Read | On demand |
| [`pinterest_get_pin_analytics`](https://www.getmcpads.com/docs/sources/pinterest-ads/tools/pinterest_get_pin_analytics) | Read paid Pin analytics, organic multi/single-Pin analytics, user-account analytics, top Pins, or top video Pins. | Read | On demand |
| [`pinterest_get_platform_resources`](https://www.getmcpads.com/docs/sources/pinterest-ads/tools/pinterest_get_platform_resources) | 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_get_targeting_options`](https://www.getmcpads.com/docs/sources/pinterest-ads/tools/pinterest_get_targeting_options) | Read Pinterest's official targeting option catalog for app type, gender, locale, age, location/geo, interest, keyword, or audience. | Read | On demand |
| [`pinterest_get_trends`](https://www.getmcpads.com/docs/sources/pinterest-ads/tools/pinterest_get_trends) | 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_health_check`](https://www.getmcpads.com/docs/sources/pinterest-ads/tools/pinterest_health_check) | Read-only Pinterest Ads health check. | Read | Announced |
| [`pinterest_list_ad_accounts`](https://www.getmcpads.com/docs/sources/pinterest-ads/tools/pinterest_list_ad_accounts) | List Pinterest ad accounts accessible to the configured credentials. | Read | Announced |
| [`pinterest_run_catalog_report`](https://www.getmcpads.com/docs/sources/pinterest-ads/tools/pinterest_run_catalog_report) | Run Pinterest catalog reporting by PRODUCT_GROUP or PRODUCT_ITEM. | Read | On demand |
| [`pinterest_run_conversion_product_report`](https://www.getmcpads.com/docs/sources/pinterest-ads/tools/pinterest_run_conversion_product_report) | 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_report`](https://www.getmcpads.com/docs/sources/pinterest-ads/tools/pinterest_run_report) | Run a read-only Pinterest Ads report. | Read | Announced |
| [`pinterest_run_specialized_export`](https://www.getmcpads.com/docs/sources/pinterest-ads/tools/pinterest_run_specialized_export) | 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_targeting_report`](https://www.getmcpads.com/docs/sources/pinterest-ads/tools/pinterest_run_targeting_report) | 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_report`](https://www.getmcpads.com/docs/sources/pinterest-ads/tools/pinterest_validate_report) | Validate and preview how a Pinterest report will execute. | Read | On demand |

## MCP resources

Read these with `resources/read` for machine readable metadata about the source.

| Name | URI |
| --- | --- |
| pinterest-manifest | `pinterest://manifest` |
| pinterest-reporting-columns | `pinterest://reporting-columns` |
| pinterest-attribution | `pinterest://attribution` |
| pinterest-creative-assets | `pinterest://creative-assets` |
| pinterest-catalog-reporting | `pinterest://catalog-reporting` |
| pinterest-surface-map | `pinterest://surface-map` |
| pinterest-recipes | `pinterest://recipes` |

---

This page as HTML: https://www.getmcpads.com/docs/sources/pinterest-ads
Every page under /docs is available as Markdown: append `.md`, or send `Accept: text/markdown`.