pinterest-ads-mcp-server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| LOG_LEVEL | No | Log level: debug, info, warn, error. | info |
| PINTEREST_APP_ID | No | Pinterest App ID, required when using the refresh token. | |
| PINTEREST_APP_SECRET | No | Pinterest App secret, required when using the refresh token. | |
| PINTEREST_ACCESS_TOKEN | No | Access token with ads:read scope (and ads:write if writes are enabled). | |
| PINTEREST_AD_ACCOUNT_ID | No | Optional default ad account ID, saves passing it on every call. | |
| PINTEREST_ENABLE_WRITES | No | Set to '1' to register the 5 write tools (disabled by default). | |
| PINTEREST_REFRESH_TOKEN | No | Refresh token. Together with PINTEREST_APP_ID and PINTEREST_APP_SECRET, lets the server renew the access token. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| resources | {
"subscribe": false,
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| pinterest_health_checkA | Read-only Pinterest Ads health check. Verifies configured credentials, account access, delivery metrics access, and optional default account readability without exposing OAuth tokens. |
| pinterest_list_ad_accountsA | List Pinterest ad accounts accessible to the configured credentials. |
| pinterest_get_delivery_metricsA | Read Pinterest resources/delivery_metrics. Use this to inspect Pinterest's official delivery metric metadata for sync or async reports. |
| pinterest_validate_reportA | Validate and preview how a Pinterest report will execute. Returns sync/async routing, endpoint, level, columns, attribution settings, and warnings without calling performance endpoints. |
| pinterest_run_reportB | Run a read-only Pinterest Ads report. Auto-routes old/wide or explicit async requests through Pinterest async reports. Uses raw Pinterest reporting column names. |
| pinterest_get_creative_assetsC | Fetch Pinterest creative assets and period performance when available. Returns ads, pins, thumbnails/images/videos, campaign/ad group context, catalog signals, and asset classifications. |
| pinterest_run_catalog_reportC | Run Pinterest catalog reporting by PRODUCT_GROUP or PRODUCT_ITEM. Use for Performance+ catalog, catalog product groups, product item image/brand/category/type, and Shopping-like reports. |
| pinterest_get_catalog_inventoryB | List Pinterest catalog inventory surfaces: catalogs, product groups, product group promotions, and optional product samples. |
| pinterest_run_conversion_product_reportC | Run Pinterest async conversion product reporting by brand, category, brand+category, SKU, or SKU group via reports/brand_category_sku. |
| pinterest_get_account_entitiesB | Read Pinterest ad-account entities and configuration. Covers account, campaign, ad group, ad, product-group promotion, promotion, label, schedule, targeting template, and order-line inventory. Returns one API page and its bookmark for predictable live queries. |
| pinterest_run_targeting_reportA | 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. For data older than the sync window, use pinterest_run_report with targetingTypes and executionMode=async. |
| pinterest_get_targeting_optionsA | Read Pinterest's official targeting option catalog for app type, gender, locale, age, location/geo, interest, keyword, or audience. Can also resolve a specific interest ID. |
| pinterest_get_keyword_intelligenceB | Read assigned targeting keywords, Pinterest country-level keyword metrics, suggested terms, or related terms. Country metrics accept up to 2,000 keywords per request. |
| pinterest_get_audiencesA | Read audience, customer-list, sharing, and Business-received audience inventory without uploading or changing audience membership. |
| pinterest_get_audience_insightsA | Read aggregated Pinterest Audience Insights for the advertiser's total or engaged audience, Pinterest's total audience, or the scope/type endpoint. Pinterest fixes the audience-insights observation window; it is not a custom date-range report. |
| pinterest_estimate_deliveryA | Run non-mutating Pinterest planning computations: ad-group audience size, bid floors, or campaign delivery estimates. The request body follows the selected Pinterest v5 schema and no campaign/ad group is created or changed. |
| pinterest_get_conversion_setupA | Inspect Pinterest conversion measurement configuration: conversion tags, oCPM-eligible/page-visit tags, Event Quality Score, advertiser-defined events, and conversion-deletion request status. This never sends or deletes conversion events. |
| pinterest_get_catalog_diagnosticsB | 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. ITEMS is a read-only POST lookup. |
| pinterest_run_specialized_exportB | Start or inspect non-mutating Pinterest data jobs for Marketing Mix Modeling (MMM), bulk advertiser entity downloads, or catalog diagnostics. START creates only a report/export artifact; it never updates delivery entities. |
| pinterest_get_lead_assetsA | Read lead-form definitions and lead subscription configuration. Lead-record export is intentionally excluded because it can contain end-user PII. |
| pinterest_get_business_assetsC | Read Pinterest Business Access inventory: employers/linked businesses, assets, members, partners, assigned assets, received audiences, and invites. Requires the corresponding business-management permissions. |
| pinterest_get_billing_and_ordersB | Read billing profiles/invoices, invoice download URLs, order lines, ads-credit discounts, and SSIO account/order status. Financial data is returned only when the token has account access. |
| pinterest_get_pin_analyticsB | Read paid Pin analytics, organic multi/single-Pin analytics, user-account analytics, top Pins, or top video Pins. Pass raw metric names supported by the selected Pinterest endpoint. |
| pinterest_get_organic_inventoryA | Read organic Pinterest content used alongside ads: Pins, boards, Pins on a board, Pin product tags, or search results. This is inventory metadata, not proof of paid delivery. |
| pinterest_get_trendsB | Read Pinterest Trends: top growing/monthly/yearly/seasonal keywords by supported region, growing product categories, product-category details, featured topics, or editorial articles. |
| pinterest_get_platform_resourcesA | 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. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| pinterest-manifest | |
| pinterest-reporting-columns | |
| pinterest-attribution | |
| pinterest-creative-assets | |
| pinterest-catalog-reporting | |
| pinterest-surface-map | |
| pinterest-recipes |
TDQS
Scored across 26 tools
Several tool pairs overlap at the edges—catalog_inventory vs catalog_diagnostics, delivery_metrics vs platform_resources, and multiple run_* report tools—cover closely related Pinterest API areas. The descriptions are detailed and do disambiguate, but an agent must read carefully to avoid selecting the wrong endpoint.
All tools use the consistent pinterest_ prefix and follow snake_case verb_resource naming like get_*, list_*, run_*, validate_*, and estimate_*. The small get/list variation is conventional rather than inconsistent.
At 26 tools, the server sits just over the 16–25 'heavy' band, so the count is high. The breadth of Pinterest Ads read-only surfaces gives each tool a reason to exist, but consolidation around report/export runners would make the set easier to navigate.
The set covers the major read-only Pinterest Ads domains: accounts, reporting, catalogs, targeting, audiences, creative, business, billing, organic, trends, and platform readiness. Since the tools are explicitly non-mutating, missing write operations are by design rather than a gap.