# @getmcpads/pinterest-ads-mcp-server 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. - **Type:** MCP server - **Trust:** 60/100 (B), scored on the package rubric - **Verification:** community-indexed — nobody has claimed this listing - **Version:** 1.0.2 - **Author:** GetMCPAds - **License:** Apache-2.0 - **npm:** @getmcpads/pinterest-ads-mcp-server - **Source:** https://github.com/getmcpads-com/pinterest-ads-mcp-server - **Compatible clients:** claude-code, cursor, copilot, gemini (basis: transport) ## Trust 60/100 (B), scored on the package rubric - Publisher verified: no - Install scripts: nothing suspicious found - Prompt-injection scan: not run - Obfuscation scan: not run - Evidence age: 23 days ## Security scan - **Status:** clean - **Scanned:** 2026-08-31T13:40:54.831Z - **Version scanned:** 1.0.2 - **CVEs:** none found by OSV at scan time ## Tools 29 declared. Statically extracted from the shipped source — a floor on the surface, not a census. - `pinterest_health_check` — Read-only Pinterest Ads health check. Verifies configured credentials, account access, delivery metrics access, and optional default account readability without - `pinterest_list_ad_accounts` — List Pinterest ad accounts accessible to the configured credentials. - `pinterest_get_delivery_metrics` — Read Pinterest resources/delivery_metrics. Use this to inspect Pinterest's official delivery metric metadata for sync or async reports. - `pinterest_validate_report` — Validate and preview how a Pinterest report will execute. Returns sync/async routing, endpoint, level, columns, attribution settings, and warnings without calli - `pinterest_run_report` — 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_assets` — Fetch Pinterest creative assets and period performance when available. Returns ads, pins, thumbnails/images/videos, campaign/ad group context, catalog signals, - `pinterest_run_catalog_report` — Run Pinterest catalog reporting by PRODUCT_GROUP or PRODUCT_ITEM. Use for Performance+ catalog, catalog product groups, product item image/brand/category/type, - `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_get_account_entities` — Read Pinterest ad-account entities and configuration. Covers account, campaign, ad group, ad, product-group promotion, promotion, label, schedule, targeting tem - `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, devi - `pinterest_get_targeting_options` — Read Pinterest's official targeting option catalog for app type, gender, locale, age, location/geo, interest, keyword, or audience. Can also resolve a specific - `pinterest_get_keyword_intelligence` — Read assigned targeting keywords, Pinterest country-level keyword metrics, suggested terms, or related terms. Country metrics accept up to 2,000 keywords per re - `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 fi - `pinterest_estimate_delivery` — Run non-mutating Pinterest planning computations: ad-group audience size, bid floors, or campaign delivery estimates. The request body follows the selected Pint - `pinterest_get_conversion_setup` — Inspect Pinterest conversion measurement configuration: conversion tags, oCPM-eligible/page-visit tags, Event Quality Score, advertiser-defined events, and conv - `pinterest_get_catalog_diagnostics` — Read deep catalog inventory and diagnostics: catalogs, feeds, feed processing results, item issues, product groups, product counts/products, available filter va - `pinterest_run_specialized_export` — Start or inspect non-mutating Pinterest data jobs for Marketing Mix Modeling (MMM), bulk advertiser entity downloads, or catalog diagnostics. START creates only - `pinterest_get_lead_assets` — Read lead-form definitions and lead subscription configuration. Lead-record export is intentionally excluded because it can contain end-user PII. - `pinterest_get_business_assets` — Read Pinterest Business Access inventory: employers/linked businesses, assets, members, partners, assigned assets, received audiences, and invites. Requires the - `pinterest_get_billing_and_orders` — Read billing profiles/invoices, invoice download URLs, order lines, ads-credit discounts, and SSIO account/order status. Financial data is returned only when th - `pinterest_get_pin_analytics` — 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 selecte - `pinterest_get_organic_inventory` — 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 - `pinterest_get_trends` — Read Pinterest Trends: top growing/monthly/yearly/seasonal keywords by supported region, growing product categories, product-category details, featured topics, - `pinterest_get_platform_resources` — Read Pinterest platform metadata and readiness resources: supported ad-account countries, delivery metric definitions, metrics readiness, lead-form questions, m - `pinterest_create_campaign` — Create a Pinterest campaign. It is always created PAUSED and there is no option to create it active. Previews by default. - `pinterest_update_campaign_budget` — 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 - `pinterest_update_adgroup_budget` — 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. Preview ## Install **Verdict: review** — Installable, but 1 thing to check first: No publisher has proved control of this listing; it is indexed, not vouched for. **Cautions** (coverage gaps and advisories — never blocking) - No publisher has proved control of this listing; it is indexed, not vouched for. **Config** (claude-code): ```json "{\n \"mcpServers\": {\n \"pinterest-ads-mcp-server\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\",\n \"@getmcpads/pinterest-ads-mcp-server\"\n ],\n \"env\": {\n \"PINTEREST_ACCESS_TOKEN\": \"\",\n \"PINTEREST_REFRESH_TOKEN\": \"\",\n \"PINTEREST_APP_SECRET\": \"\"\n }\n }\n }\n}" ``` **Credentials it will ask for** (names only — Forge never holds a value): - `PINTEREST_ACCESS_TOKEN` — Pinterest Access Token (optional) - `PINTEREST_REFRESH_TOKEN` — Pinterest Refresh Token (optional) - `PINTEREST_APP_SECRET` — Pinterest App Secret (optional) Placeholders only. Forge never holds, brokers, or transmits a credential value — replace each in your own config file. Do not send a value back to Forge; no Forge endpoint accepts one. - This entry needs 3 credentials (0 required). The generated config carries placeholders, so it will fail in the editor rather than at runtime if they are left unset. ## Blast radius Moderate blast radius — holds an oauth grant; runs on your machine. - Floor 31, ceiling 31 (tier: moderate) - This is impact, not likelihood. A high radius is not a defect: a filesystem server is supposed to write files. It is never part of the trust score. ## Machine-readable views of this entry - Signed JSON: https://forgeregistry.com/api/v1/packages/%40getmcpads%2Fpinterest-ads-mcp-server - Install plan: https://forgeregistry.com/api/v1/packages/%40getmcpads%2Fpinterest-ads-mcp-server/install-plan - Alternatives: https://forgeregistry.com/api/v1/alternatives/%40getmcpads%2Fpinterest-ads-mcp-server - HTML page: https://forgeregistry.com/registry/%40getmcpads%2Fpinterest-ads-mcp-server - MCP: POST https://forgeregistry.com/api/mcp → `forge_get_package` / `forge_install_plan` ## About this document Generated by Forge (https://forgeregistry.com) — a compact rendering of the same record served, signed, at the JSON URL above. Trust and scan facts are the registry's own measurements; anything Forge did not measure is named as unmeasured rather than omitted.