Explore reporting, audiences, catalogs and native campaign operations from your MCP client.
Pinterest Ads is an MCP project maintained in the get-mcp-ads/pinterest-ads-mcp-server repository. The maintainer describes its purpose as “Explore reporting, audiences, catalogs and native campaign operations from your MCP client”. Read the project documentation for the complete scope.
The documented npm package is @getmcpads/pinterest-ads-mcp-server. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.
The example declares PINTEREST_ACCESS_TOKEN. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.
Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-09.
Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.
| Tool | What it does |
|---|---|
| pinterest_health_check | Read-only Pinterest Ads health check. |
| pinterest_list_ad_accounts | List Pinterest ad accounts accessible to the configured credentials. |
| pinterest_get_delivery_metrics | Read Pinterest resources/delivery_metrics. |
| pinterest_validate_report | Validate and preview how a Pinterest report will execute. |
| pinterest_run_report | Run a read-only Pinterest Ads report. |
| pinterest_get_creative_assets | Fetch Pinterest creative assets and period performance when available. |
| pinterest_run_catalog_report | Run Pinterest catalog reporting by PRODUCT_GROUP or PRODUCT_ITEM. |
| pinterest_get_catalog_inventory | List Pinterest catalog inventory surfaces: catalogs, product groups, product group promotions, and optional product samples. |
| 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. |
| pinterest_list_ad_creatives | 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… |
| pinterest_get_write_schema | Read the official Pinterest v5 native request schema and Sandbox limitations before composing a write. |
| pinterest_get_account_entities | Read Pinterest ad-account entities and configuration. |
| 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… |
| pinterest_get_targeting_options | Read Pinterest's official targeting option catalog for app type, gender, locale, age, location/geo, interest, keyword, or audience. |
| pinterest_get_keyword_intelligence | Read assigned targeting keywords, Pinterest country-level keyword metrics, suggested terms, or related terms. |
| pinterest_get_audiences | Read audience, customer-list, sharing, and Business-received audience inventory without uploading or changing audience membership. |
| 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. |
| pinterest_estimate_delivery | Run non-mutating Pinterest planning computations: ad-group audience size, bid floors, or campaign delivery estimates. |
| pinterest_get_conversion_setup | Inspect Pinterest conversion measurement configuration: conversion tags, oCPM-eligible/page-visit tags, Event Quality Score, advertiser-defined events, and… |
| pinterest_get_catalog_diagnostics | Read deep catalog inventory and diagnostics: catalogs, feeds, feed processing results, item issues, product groups, product counts/products, available filter… |
| pinterest_run_specialized_export | Start or inspect non-mutating Pinterest data jobs for Marketing Mix Modeling (MMM), bulk advertiser entity downloads, or catalog diagnostics. |
| pinterest_get_lead_assets | Read lead-form definitions and lead subscription configuration. |
| pinterest_get_business_assets | Read Pinterest Business Access inventory: employers/linked businesses, assets, members, partners, assigned assets, received audiences, and invites. |
| pinterest_get_billing_and_orders | Read billing profiles/invoices, invoice download URLs, order lines, ads-credit discounts, and SSIO account/order status. |
| pinterest_get_pin_analytics | Read paid Pin analytics, organic multi/single-Pin analytics, user-account analytics, top Pins, or top video Pins. |
| pinterest_get_organic_inventory | Read organic Pinterest content used alongside ads: Pins, boards, Pins on a board, Pin product tags, or search results. |
| pinterest_get_trends | Read Pinterest Trends: top growing/monthly/yearly/seasonal keywords by supported region, growing product categories, product-category details, featured… |
| pinterest_get_platform_resources | Read Pinterest platform metadata and readiness resources: supported ad-account countries, delivery metric definitions, metrics readiness, lead-form questions… |
| pinterest_create_campaign | Create a PAUSED campaign. |
| pinterest_update_campaign_status | Update the status of an existing campaign. |
| pinterest_update_adgroup_status | Update the status of an existing adgroup. |
| pinterest_update_ad_status | Update the status of an existing ad. |
| pinterest_update_campaign_budget | Set exactly one daily or lifetime campaign budget in major account currency units. |
| pinterest_update_adgroup_budget | Set exactly one daily or lifetime ad group budget in major account currency units. |
| pinterest_update_campaign_configuration | Update native campaign settings. |
| pinterest_update_adgroup_configuration | Update native ad group settings. |
| pinterest_update_ad | Update native ad settings. |
| pinterest_create_adgroup | Create a PAUSED ad group with explicit native bidding, targeting, budget and schedule. |
| pinterest_create_ad | Create a PAUSED ad from an accessible Pin. |
| pinterest_create_product_group_promotion | Create a PAUSED shopping or collections promotion from a catalog product group. |
| pinterest_update_product_group_promotion | Update a catalog product group promotion. |
| pinterest_create_collection_ad | Create a PAUSED collection with an explicitly selected image/video hero Pin and an accessible catalog product group. |
| pinterest_create_board | Create /boards in the selected advertiser context. |
| pinterest_update_board | Update /boards in the selected advertiser context. |
| pinterest_create_pin | Create /pins in the selected advertiser context. |
| pinterest_update_pin | Update a Pin. |
| pinterest_register_media | Register media upload; returned upload_url/parameters are not confirmation that a video is uploaded or ready. |
| pinterest_create_catalog | Create /catalogs in the selected advertiser context. |
| pinterest_create_catalog_feed | Create /catalogs/feeds in the selected advertiser context. |
| pinterest_update_catalog_feed | Update /catalogs/feeds in the selected advertiser context. |
| pinterest_create_product_group | Create /catalogs/product_groups in the selected advertiser context. |
| pinterest_update_product_group | Update /catalogs/product_groups in the selected advertiser context. |
| pinterest_batch_catalog_items | Submit native CREATE/UPDATE/UPSERT/DELETE catalog item operations. |
| URI | Contents |
{
"mcpServers": {
"pinterest-ads": {
"command": "npx",
"args": [
"-y",
"@getmcpads/pinterest-ads-mcp-server"
],
"env": {
"PINTEREST_ACCESS_TOKEN": "YOUR_PINTEREST_ACCESS_TOKEN"
}
}
}
}From the project documentation. Replace placeholders and example paths before connecting.
| Variable | Description | Required |
|---|---|---|
| PINTEREST_ACCESS_TOKEN | Declared in the maintainer’s client configuration. | Check documentation |
Search built for AI, not humans — semantic web search that returns model-ready content, plus code context.
Put 6,000+ pre-built scrapers at your assistant's fingertips through one MCP endpoint.
Fetches and analyzes content from Reddit, providing access to hot threads and post details.
Enables interaction with X (formerly Twitter) for retrieving tweets, creating new posts, and replying to existing ones.
Automates LinkedIn interactions and extracts data through browser automation, respecting terms of service and rate limits.
Automates SEO tasks and provides AI-powered optimization by integrating with the Google Ads Keyword Planner API.