# Pinterest Ads MCP and API

53 tools on your own Pinterest Ads account through Get MCP Ads, from $0.005 per call.

## Capabilities

- [Pinterest Ads reporting](/tools/pinterest-ads/reporting.md): 16 tools, from $0.005 per call.
- [Pinterest Ads campaign management](/tools/pinterest-ads/campaign-management.md): 21 tools, from $0.005 per call.
- [Pinterest Ads creatives](/tools/pinterest-ads/creatives.md): 12 tools, from $0.005 per call.
- [Pinterest Ads audiences & targeting](/tools/pinterest-ads/audiences.md): 4 tools, from $0.005 per call.

## All 53 tools

- [Pinterest Ads account entities](/providers/pinterest-ads/get-account-entities.md): `pinterest-ads/get-account-entities`, $0.005 per call. Read Pinterest ad-account entities and configuration. Works on your own Pinterest Ads account, connected through Get MCP Ads. Needs entity.
- [Pinterest Ads billing and orders](/providers/pinterest-ads/get-billing-and-orders.md): `pinterest-ads/get-billing-and-orders`, $0.005 per call. Read billing profiles/invoices, invoice download URLs, order lines, ads-credit discounts, and SSIO account/order status. Works on your own Pinterest Ads account, connected through Get MCP Ads. Needs mode.
- [Pinterest Ads catalog diagnostics](/providers/pinterest-ads/get-catalog-diagnostics.md): `pinterest-ads/get-catalog-diagnostics`, $0.005 per call. Read deep catalog inventory and diagnostics: catalogs, feeds, feed processing results, item issues, product groups, product counts/products, available filter. Works on your own Pinterest Ads account, connected through Get MCP Ads. Needs mode.
- [Pinterest Ads catalog inventory](/providers/pinterest-ads/get-catalog-inventory.md): `pinterest-ads/get-catalog-inventory`, $0.005 per call. List Pinterest catalog inventory surfaces: catalogs, product groups, product group promotions, and optional product samples. Works on your own Pinterest Ads account, connected through Get MCP Ads. Takes ad account id, include product samples, sample product groups and more, all optional.
- [Pinterest Ads conversion setup](/providers/pinterest-ads/get-conversion-setup.md): `pinterest-ads/get-conversion-setup`, $0.005 per call. Inspect Pinterest conversion measurement configuration: conversion tags, oCPM-eligible/page-visit tags, Event Quality Score, advertiser-defined events. Works on your own Pinterest Ads account, connected through Get MCP Ads. Takes ad account id, surfaces, include deleted tags and more, all optional.
- [Pinterest Ads delivery metrics](/providers/pinterest-ads/get-delivery-metrics.md): `pinterest-ads/get-delivery-metrics`, $0.005 per call. Read Pinterest resources/delivery_metrics. Works on your own Pinterest Ads account, connected through Get MCP Ads. Takes report type and workspace id, all optional.
- [Pinterest Ads keyword intelligence](/providers/pinterest-ads/get-keyword-intelligence.md): `pinterest-ads/get-keyword-intelligence`, $0.005 per call. Read assigned targeting keywords, Pinterest country-level keyword metrics, suggested terms, or related terms. Works on your own Pinterest Ads account, connected through Get MCP Ads. Needs mode.
- [Pinterest Ads organic inventory](/providers/pinterest-ads/get-organic-inventory.md): `pinterest-ads/get-organic-inventory`, $0.005 per call. Read organic Pinterest content used alongside ads: Pins, boards, Pins on a board, Pin product tags, or search results. Works on your own Pinterest Ads account, connected through Get MCP Ads. Needs mode.
- [Pinterest Ads pin analytics](/providers/pinterest-ads/get-pin-analytics.md): `pinterest-ads/get-pin-analytics`, $0.005 per call. Read paid Pin analytics, organic multi/single-Pin analytics, user-account analytics, top Pins, or top video Pins. Works on your own Pinterest Ads account, connected through Get MCP Ads. Needs mode, start date, end date and more.
- [Pinterest Ads platform resources](/providers/pinterest-ads/get-platform-resources.md): `pinterest-ads/get-platform-resources`, $0.005 per call. Read Pinterest platform metadata and readiness resources: supported ad-account countries, delivery metric definitions, metrics readiness, lead-form questions. Works on your own Pinterest Ads account, connected through Get MCP Ads. Needs mode.
- [Pinterest Ads trends](/providers/pinterest-ads/get-trends.md): `pinterest-ads/get-trends`, $0.005 per call. Read Pinterest Trends: top growing/monthly/yearly/seasonal keywords by supported region, growing product categories, product-category details, featured topics. Works on your own Pinterest Ads account, connected through Get MCP Ads. Needs mode.
- [Run a Pinterest Ads catalog report](/providers/pinterest-ads/run-catalog-report.md): `pinterest-ads/run-catalog-report`, $0.005 per call. Run Pinterest catalog reporting by PRODUCT_GROUP or PRODUCT_ITEM. Works on your own Pinterest Ads account, connected through Get MCP Ads. Needs start date and end date.
- [Run a Pinterest Ads conversion product report](/providers/pinterest-ads/run-conversion-product-report.md): `pinterest-ads/run-conversion-product-report`, $0.005 per call. Run Pinterest async conversion product reporting by brand, category, brand+category, SKU, or SKU group via reports/brand_category_sku. Works on your own Pinterest Ads account, connected through Get MCP Ads. Needs start date and end date.
- [Run a Pinterest Ads report](/providers/pinterest-ads/run-report.md): `pinterest-ads/run-report`, $0.005 per call. Run a read-only Pinterest Ads report. Works on your own Pinterest Ads account, connected through Get MCP Ads. Needs start date and end date.
- [Run a Pinterest Ads specialized export](/providers/pinterest-ads/run-specialized-export.md): `pinterest-ads/run-specialized-export`, $0.005 per call. Start or inspect non-mutating Pinterest data jobs for Marketing Mix Modeling (MMM), bulk advertiser entity downloads, or catalog diagnostics. Works on your own Pinterest Ads account, connected through Get MCP Ads. Needs export type.
- [Validate a Pinterest Ads report](/providers/pinterest-ads/validate-report.md): `pinterest-ads/validate-report`, $0.005 per call. Validate and preview how a Pinterest report will execute. Works on your own Pinterest Ads account, connected through Get MCP Ads. Needs start date and end date.
- [Batch Pinterest Ads catalog items](/providers/pinterest-ads/batch-catalog-items.md): `pinterest-ads/batch-catalog-items`, free preview, $0.05 per applied change. Submit native CREATE/UPDATE/UPSERT/DELETE catalog item operations. Works on your own Pinterest Ads account, connected through Get MCP Ads. The preview is free; the change costs $0.05 when you confirm it. Needs ad account id and configuration.
- [Create a Pinterest ad](/providers/pinterest-ads/create-ad.md): `pinterest-ads/create-ad`, free preview, $0.05 per applied change. Create a PAUSED ad from an accessible Pin. Works on your own Pinterest Ads account, connected through Get MCP Ads. The preview is free; the change costs $0.05 when you confirm it. Needs ad account id, ad group id, pin id and more.
- [Create a Pinterest ad group](/providers/pinterest-ads/create-adgroup.md): `pinterest-ads/create-adgroup`, free preview, $0.05 per applied change. Create a PAUSED ad group with explicit native bidding, targeting, budget and schedule. Works on your own Pinterest Ads account, connected through Get MCP Ads. The preview is free; the change costs $0.05 when you confirm it. Needs ad account id, campaign id and configuration.
- [Create a Pinterest Ads campaign](/providers/pinterest-ads/create-campaign.md): `pinterest-ads/create-campaign`, free preview, $0.05 per applied change. Works on your own Pinterest Ads account, connected through Get MCP Ads. The preview is free; the change costs $0.05 when you confirm it. Needs ad account id, name and objective.
- [Create a Pinterest Ads catalog](/providers/pinterest-ads/create-catalog.md): `pinterest-ads/create-catalog`, free preview, $0.05 per applied change. Create /catalogs in the selected advertiser context. Works on your own Pinterest Ads account, connected through Get MCP Ads. The preview is free; the change costs $0.05 when you confirm it. Needs ad account id and configuration.
- [Create a Pinterest Ads catalog feed](/providers/pinterest-ads/create-catalog-feed.md): `pinterest-ads/create-catalog-feed`, free preview, $0.05 per applied change. Create /catalogs/feeds in the selected advertiser context. Works on your own Pinterest Ads account, connected through Get MCP Ads. The preview is free; the change costs $0.05 when you confirm it. Needs ad account id and configuration.
- [Create a Pinterest Ads collection ad](/providers/pinterest-ads/create-collection-ad.md): `pinterest-ads/create-collection-ad`, free preview, $0.05 per applied change. Create a PAUSED collection with an explicitly selected image/video hero Pin and an accessible catalog product group. Works on your own Pinterest Ads account, connected through Get MCP Ads. The preview is free; the change costs $0.05 when you confirm it. Needs ad account id, ad group id, product group id and more.
- [Create a Pinterest Ads product group](/providers/pinterest-ads/create-product-group.md): `pinterest-ads/create-product-group`, free preview, $0.05 per applied change. Create /catalogs/product_groups in the selected advertiser context. Works on your own Pinterest Ads account, connected through Get MCP Ads. The preview is free; the change costs $0.05 when you confirm it. Needs ad account id and configuration.
- [Create a Pinterest Ads product group promotion](/providers/pinterest-ads/create-product-group-promotion.md): `pinterest-ads/create-product-group-promotion`, free preview, $0.05 per applied change. Create a PAUSED shopping or collections promotion from a catalog product group. Works on your own Pinterest Ads account, connected through Get MCP Ads. The preview is free; the change costs $0.05 when you confirm it. Needs ad account id, ad group id, product group id and more.
- [Estimate a Pinterest Ads delivery](/providers/pinterest-ads/estimate-delivery.md): `pinterest-ads/estimate-delivery`, $0.005 per call. Run non-mutating Pinterest planning computations: ad-group audience size, bid floors, or campaign delivery estimates. Works on your own Pinterest Ads account, connected through Get MCP Ads. Needs mode and request.
- [Update a Pinterest ad](/providers/pinterest-ads/update-ad.md): `pinterest-ads/update-ad`, free preview, $0.05 per applied change. Update native ad settings. Works on your own Pinterest Ads account, connected through Get MCP Ads. The preview is free; the change costs $0.05 when you confirm it. Needs ad account id, ad id and configuration.
- [Update a Pinterest ad group budget](/providers/pinterest-ads/update-adgroup-budget.md): `pinterest-ads/update-adgroup-budget`, free preview, $0.05 per applied change. Set exactly one daily or lifetime ad group budget in major account currency units. Works on your own Pinterest Ads account, connected through Get MCP Ads. The preview is free; the change costs $0.05 when you confirm it. Needs ad account id and ad group id.
- [Update a Pinterest ad group configuration](/providers/pinterest-ads/update-adgroup-configuration.md): `pinterest-ads/update-adgroup-configuration`, free preview, $0.05 per applied change. Update native ad group settings. Works on your own Pinterest Ads account, connected through Get MCP Ads. The preview is free; the change costs $0.05 when you confirm it. Needs ad account id, ad group id and configuration.
- [Update a Pinterest ad group status](/providers/pinterest-ads/update-adgroup-status.md): `pinterest-ads/update-adgroup-status`, free preview, $0.05 per applied change. Update the status of an existing adgroup. Works on your own Pinterest Ads account, connected through Get MCP Ads. The preview is free; the change costs $0.05 when you confirm it. Needs ad account id, ad group id and status.
- [Update a Pinterest ad status](/providers/pinterest-ads/update-ad-status.md): `pinterest-ads/update-ad-status`, free preview, $0.05 per applied change. Works on your own Pinterest Ads account, connected through Get MCP Ads. The preview is free; the change costs $0.05 when you confirm it. Needs ad account id, ad id and status.
- [Update a Pinterest Ads campaign budget](/providers/pinterest-ads/update-campaign-budget.md): `pinterest-ads/update-campaign-budget`, free preview, $0.05 per applied change. Set exactly one daily or lifetime campaign budget in major account currency units. Works on your own Pinterest Ads account, connected through Get MCP Ads. The preview is free; the change costs $0.05 when you confirm it. Needs ad account id and campaign id.
- [Update a Pinterest Ads campaign configuration](/providers/pinterest-ads/update-campaign-configuration.md): `pinterest-ads/update-campaign-configuration`, free preview, $0.05 per applied change. Update native campaign settings. Works on your own Pinterest Ads account, connected through Get MCP Ads. The preview is free; the change costs $0.05 when you confirm it. Needs ad account id, campaign id and configuration.
- [Update a Pinterest Ads campaign status](/providers/pinterest-ads/update-campaign-status.md): `pinterest-ads/update-campaign-status`, free preview, $0.05 per applied change. Works on your own Pinterest Ads account, connected through Get MCP Ads. The preview is free; the change costs $0.05 when you confirm it. Needs ad account id, campaign id and status.
- [Update a Pinterest Ads catalog feed](/providers/pinterest-ads/update-catalog-feed.md): `pinterest-ads/update-catalog-feed`, free preview, $0.05 per applied change. Update /catalogs/feeds in the selected advertiser context. Works on your own Pinterest Ads account, connected through Get MCP Ads. The preview is free; the change costs $0.05 when you confirm it. Needs ad account id, feed id and configuration.
- [Update a Pinterest Ads product group](/providers/pinterest-ads/update-product-group.md): `pinterest-ads/update-product-group`, free preview, $0.05 per applied change. Update /catalogs/product_groups in the selected advertiser context. Works on your own Pinterest Ads account, connected through Get MCP Ads. The preview is free; the change costs $0.05 when you confirm it. Needs ad account id, product group id and configuration.
- [Update a Pinterest Ads product group promotion](/providers/pinterest-ads/update-product-group-promotion.md): `pinterest-ads/update-product-group-promotion`, free preview, $0.05 per applied change. Works on your own Pinterest Ads account, connected through Get MCP Ads. The preview is free; the change costs $0.05 when you confirm it. Needs ad account id, ad group id, promotion id and more.
- [Create a Pinterest Ads board](/providers/pinterest-ads/create-board.md): `pinterest-ads/create-board`, free preview, $0.05 per applied change. Create /boards in the selected advertiser context. Works on your own Pinterest Ads account, connected through Get MCP Ads. The preview is free; the change costs $0.05 when you confirm it. Needs ad account id and configuration.
- [Create a Pinterest Ads pin](/providers/pinterest-ads/create-pin.md): `pinterest-ads/create-pin`, free preview, $0.05 per applied change. Create /pins in the selected advertiser context. Works on your own Pinterest Ads account, connected through Get MCP Ads. The preview is free; the change costs $0.05 when you confirm it. Needs ad account id and configuration.
- [Pinterest ad creatives](/providers/pinterest-ads/list-ad-creatives.md): `pinterest-ads/list-ad-creatives`, $0.005 per call. 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. Works on your own Pinterest Ads account, connected through Get MCP Ads. Takes ad account id, ad ids, campaign ids and more, all optional.
- [Pinterest Ads business assets](/providers/pinterest-ads/get-business-assets.md): `pinterest-ads/get-business-assets`, $0.005 per call. Read Pinterest Business Access inventory: employers/linked businesses, assets, members, partners, assigned assets, received audiences, and invites. Works on your own Pinterest Ads account, connected through Get MCP Ads. Needs mode.
- [Pinterest Ads creative assets](/providers/pinterest-ads/get-creative-assets.md): `pinterest-ads/get-creative-assets`, $0.005 per call. Fetch Pinterest creative assets and period performance when available. Works on your own Pinterest Ads account, connected through Get MCP Ads. Needs start date and end date.
- [Pinterest Ads lead assets](/providers/pinterest-ads/get-lead-assets.md): `pinterest-ads/get-lead-assets`, $0.005 per call. Read lead-form definitions and lead subscription configuration. Works on your own Pinterest Ads account, connected through Get MCP Ads. Needs mode.
- [Pinterest Ads video upload](/providers/pinterest-ads/get-video-upload.md): `pinterest-ads/get-video-upload`, $0.005 per call. Read processing status for this advertiser-bound uploaded video. Works on your own Pinterest Ads account, connected through Get MCP Ads. Needs ad account id and upload receipt.
- [Prepare a Pinterest Ads video upload](/providers/pinterest-ads/prepare-video-upload.md): `pinterest-ads/prepare-video-upload`, free preview, $0.05 per applied change. Register an upload for a frozen Launcher video and save its opaque receipt before transferring bytes. Works on your own Pinterest Ads account, connected through Get MCP Ads. The preview is free; the change costs $0.05 when you confirm it. Needs ad account id and source url.
- [Register Pinterest Ads media](/providers/pinterest-ads/register-media.md): `pinterest-ads/register-media`, free preview, $0.05 per applied change. Register media upload; returned upload_url/parameters are not confirmation that a video is uploaded or ready. Works on your own Pinterest Ads account, connected through Get MCP Ads. The preview is free; the change costs $0.05 when you confirm it. Needs ad account id and configuration.
- [Update a Pinterest Ads board](/providers/pinterest-ads/update-board.md): `pinterest-ads/update-board`, free preview, $0.05 per applied change. Update /boards in the selected advertiser context. Works on your own Pinterest Ads account, connected through Get MCP Ads. The preview is free; the change costs $0.05 when you confirm it. Needs ad account id, board id and configuration.
- [Update a Pinterest Ads pin](/providers/pinterest-ads/update-pin.md): `pinterest-ads/update-pin`, free preview, $0.05 per applied change. Works on your own Pinterest Ads account, connected through Get MCP Ads. The preview is free; the change costs $0.05 when you confirm it. Needs ad account id, pin id and configuration.
- [Upload a Pinterest Ads video](/providers/pinterest-ads/upload-video.md): `pinterest-ads/upload-video`, free preview, $0.05 per applied change. Stream the frozen video to the native destination saved in uploadReceipt. Works on your own Pinterest Ads account, connected through Get MCP Ads. The preview is free; the change costs $0.05 when you confirm it. Needs ad account id, source url and upload receipt.
- [Pinterest Ads audience insights](/providers/pinterest-ads/get-audience-insights.md): `pinterest-ads/get-audience-insights`, $0.005 per call. Read aggregated Pinterest Audience Insights for the advertiser's total or engaged audience, Pinterest's total audience, or the scope/type endpoint. Works on your own Pinterest Ads account, connected through Get MCP Ads. Takes ad account id, mode, audience insight type and more, all optional.
- [Pinterest Ads audiences](/providers/pinterest-ads/get-audiences.md): `pinterest-ads/get-audiences`, $0.005 per call. Read audience, customer-list, sharing, and Business-received audience inventory without uploading or changing audience membership. Works on your own Pinterest Ads account, connected through Get MCP Ads. Needs mode.
- [Pinterest Ads targeting options](/providers/pinterest-ads/get-targeting-options.md): `pinterest-ads/get-targeting-options`, $0.005 per call. Read Pinterest's official targeting option catalog for app type, gender, locale, age, location/geo, interest, keyword, or audience. Works on your own Pinterest Ads account, connected through Get MCP Ads. Takes ad account id, targeting type, interest id and more, all optional.
- [Run a Pinterest Ads targeting report](/providers/pinterest-ads/run-targeting-report.md): `pinterest-ads/run-targeting-report`, $0.005 per call. Run live targeting analytics for an ad account, campaigns, ad groups, or ads, broken down by age, gender, location, interest, keyword, audience, placement. Works on your own Pinterest Ads account, connected through Get MCP Ads. Needs start date, end date and targeting types.

## Related

- [Pinterest](/tools/pinterest.md): 4 tools.

## Providers

- [Pinterest Ads](/providers/pinterest-ads.md): 56 tools, from $0.005 per call, some tools free.

## Questions

### Do I need my own Pinterest Ads account?

Yes. These tools work on your own Pinterest Ads account, connected once per workspace through Get MCP Ads. Agentik keeps an encrypted token and never sees your password.

### Can my agent change things without my approval?

No. A change is previewed for free and applied only when you confirm it. Reading never changes anything.

### How is it billed?

Per call, at the provider's price with no markup, from $0.005 per call. Your agent sees the price before it runs a tool.

[Advertising](/tools/advertising.md) · [Connection guide](/connect.md) · [Billing](/docs/billing.md)

---

[HTML page](/tools/pinterest-ads) · [Agent index](/llms.txt)
