Open-source MCP server for the Pinterest Ads API. 26 read tools and 5 write tools that preview before they apply, covering reporting, audiences, targeting, catalogs, Pins and trends. Self-hosted, bring your own token.
Inferred from the transports this listing declares (stdio). A client not listed here hasn’t been ruled out — it just isn’t something Forge can confirm.
PINTEREST_ACCESS_TOKENAPI keyoptionalPinterest access token with the ads:read scope.
PINTEREST_REFRESH_TOKENOAuth appoptionalRefresh token, so the server can renew the access token.
PINTEREST_APP_SECRETAPI keyoptionalApp secret, needed for refresh.
Declared by the author in the official MCP registry. Forge does not store, broker, or ever see these values — the config below is scaffolded with placeholders you fill in locally.
Verification confirms publisher identity (repo ownership), not code safety. The security scan covers known CVEs and suspicious install scripts.
Read out of the source npm actually ships, at scan time. The package was never executed. Tools registered dynamically at runtime, or hidden inside bundled or minified code, can be missed — so this is a floor on the tool surface, not a complete census of it.
pinterest_health_checkRead-only Pinterest Ads health check. Verifies configured credentials, account access, delivery metrics access, and optional default account readability without exposing OAuth tokens.Read-only Pinterest Ads health check. Verifies configured credentials, account access, delivery metrics access, and optional default account readability without exposing OAuth tokens.
No input schema was published for this tool.
pinterest_list_ad_accountsList Pinterest ad accounts accessible to the configured credentials.List Pinterest ad accounts accessible to the configured credentials.
No input schema was published for this tool.
pinterest_get_delivery_metricsRead Pinterest resources/delivery_metrics. Use this to inspect Pinterest's official delivery metric metadata for sync or async reports.Read Pinterest resources/delivery_metrics. Use this to inspect Pinterest's official delivery metric metadata for sync or async reports.
No input schema was published for this tool.
pinterest_validate_reportValidate and preview how a Pinterest report will execute. Returns sync/async routing, endpoint, level, columns, attribution settings, and warnings without calling performance endpoints.Validate and preview how a Pinterest report will execute. Returns sync/async routing, endpoint, level, columns, attribution settings, and warnings without calling performance endpoints.
No input schema was published for this tool.
pinterest_run_reportRun a read-only Pinterest Ads report. Auto-routes old/wide or explicit async requests through Pinterest async reports. Uses raw Pinterest reporting column names.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.
No input schema was published for this tool.
pinterest_get_creative_assetsFetch Pinterest creative assets and period performance when available. Returns ads, pins, thumbnails/images/videos, campaign/ad group context, catalog signals, and asset classifications.Fetch Pinterest creative assets and period performance when available. Returns ads, pins, thumbnails/images/videos, campaign/ad group context, catalog signals, and asset classifications.
No input schema was published for this tool.
pinterest_run_catalog_reportRun 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.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.
No input schema was published for this tool.
pinterest_get_catalog_inventoryList Pinterest catalog inventory surfaces: catalogs, product groups, product group promotions, and optional product samples.List Pinterest catalog inventory surfaces: catalogs, product groups, product group promotions, and optional product samples.
No input schema was published for this tool.
pinterest_run_conversion_product_reportRun Pinterest async conversion product reporting by brand, category, brand+category, SKU, or SKU group via reports/brand_category_sku.Run Pinterest async conversion product reporting by brand, category, brand+category, SKU, or SKU group via reports/brand_category_sku.
No input schema was published for this tool.
pinterest_get_account_entitiesRead 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.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.
No input schema was published for this tool.
pinterest_run_targeting_reportRun 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…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…
No input schema was published for this tool.
pinterest_get_targeting_optionsRead 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.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.
No input schema was published for this tool.
pinterest_get_keyword_intelligenceRead assigned targeting keywords, Pinterest country-level keyword metrics, suggested terms, or related terms. Country metrics accept up to 2,000 keywords per request.Read assigned targeting keywords, Pinterest country-level keyword metrics, suggested terms, or related terms. Country metrics accept up to 2,000 keywords per request.
No input schema was published for this tool.
pinterest_get_audiencesRead audience, customer-list, sharing, and Business-received audience inventory without uploading or changing audience membership.Read audience, customer-list, sharing, and Business-received audience inventory without uploading or changing audience membership.
No input schema was published for this tool.
pinterest_get_audience_insightsRead 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.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.
No input schema was published for this tool.
pinterest_estimate_deliveryRun 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.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.
No input schema was published for this tool.
pinterest_get_conversion_setupInspect 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.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.
No input schema was published for this tool.
pinterest_get_catalog_diagnosticsRead 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.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.
No input schema was published for this tool.
pinterest_run_specialized_exportStart 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.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.
No input schema was published for this tool.
pinterest_get_lead_assetsRead lead-form definitions and lead subscription configuration. Lead-record export is intentionally excluded because it can contain end-user PII.Read lead-form definitions and lead subscription configuration. Lead-record export is intentionally excluded because it can contain end-user PII.
No input schema was published for this tool.
pinterest_get_business_assetsRead Pinterest Business Access inventory: employers/linked businesses, assets, members, partners, assigned assets, received audiences, and invites. Requires the corresponding business-management permissions.Read Pinterest Business Access inventory: employers/linked businesses, assets, members, partners, assigned assets, received audiences, and invites. Requires the corresponding business-management permissions.
No input schema was published for this tool.
pinterest_get_billing_and_ordersRead 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.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.
No input schema was published for this tool.
pinterest_get_pin_analyticsRead 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.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.
No input schema was published for this tool.
pinterest_get_organic_inventoryRead 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.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.
No input schema was published for this tool.
pinterest_get_trendsRead Pinterest Trends: top growing/monthly/yearly/seasonal keywords by supported region, growing product categories, product-category details, featured topics, or editorial articles.Read Pinterest Trends: top growing/monthly/yearly/seasonal keywords by supported region, growing product categories, product-category details, featured topics, or editorial articles.
No input schema was published for this tool.
pinterest_get_platform_resourcesRead 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 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.
No input schema was published for this tool.
pinterest_create_campaignCreate a Pinterest campaign. It is always created PAUSED and there is no option to create it active. Previews by default.Create a Pinterest campaign. It is always created PAUSED and there is no option to create it active. Previews by default.
No input schema was published for this tool.
pinterest_update_campaign_budgetChange the daily or lifetime budget of a Pinterest campaign. Amount in the account currency (12.50 for 12.50 EUR). Pinterest expects micro units, the conversion is done here. Previews by default.Change the daily or lifetime budget of a Pinterest campaign. Amount in the account currency (12.50 for 12.50 EUR). Pinterest expects micro units, the conversion is done here. Previews by default.
No input schema was published for this tool.
pinterest_update_adgroup_budgetChange the daily or lifetime budget of a Pinterest ad group. Amount in the account currency. Pinterest expects micro units, the conversion is done here. Previews by default.Change the daily or lifetime budget of a Pinterest ad group. Amount in the account currency. Pinterest expects micro units, the conversion is done here. Previews by default.
No input schema was published for this tool.
29 of 29 tools published a description.
Tool names and descriptions are written by the publisher and shown verbatim as inert text. They are the strings an MCP client passes to a model, so Forge scans them for prompt-injection patterns — any finding appears with the security scan above. “Privileged” is a keyword match on the tool name, not an audit of what the tool does: a benign-sounding name can still do anything.
Open-source MCP server for the Pinterest Ads API. 26 read tools and 5 write tools that preview before they apply, covering reporting, audiences, targeting, catalogs, Pins and trends. Self-hosted, bring your own token.
Linked names open Forge’s index of every entry observed exposing that tool. Browse all indexed tools.
The crawl stopped at the depth-4 limit. Anything below that level was never resolved.
The crawl stopped at the 60-package limit. The rest of the tree was never resolved.
36 more resolved packages are not drawn here (display cap: 24). Every dependency carrying an advisory is drawn regardless of the cap. Full inventory (CycloneDX SBOM)
54 declared dependencies never landed in the tree. They are missing from Forge's resolution, not from the package.
+42 more not listed. The counts by reason above cover all of them.
Not followed: peerDependencies. This tree covers runtime dependencies only, so anything those pull in was never resolved.