MCP server

Pinterest AdsMCP Server

Delivery and catalogue reporting, targeting analytics, audience insights, billing.

https://mcp.getmcpads.com/pinterest-ads/mcp

Start free

This endpoint serves Pinterest Ads on its own. One shared URL reaches every platform you connect.

31
Tools: 5
That write: 91
Metrics: 36
Dimensions

What you can ask it.

Real questions, with the tools each one resolves to. Every tool named below is in the catalogue on this page.

3 questions

Spend, CPA and ROAS by campaign across all four platforms, last 7 days against the 7 before.

One request, four APIs. Each platform's insights tool plans its own query, then the assistant lines the rows up in a single table.

meta_get_insightsgoogle_ads_get_insightstiktok_get_insightspinterest_run_report

Break Pinterest performance down by product group and by SKU.

Routes the catalogue report through Pinterest's async reporting when the window is too wide for the sync endpoint, then returns the rows.

pinterest_run_catalog_reportpinterest_run_conversion_product_report

Put the whole Pinterest account on hold until Monday.

Lists the active campaigns, then pauses them one by one after the preview. Archived campaigns are left alone.

pinterest_get_account_entitiespinterest_update_campaign_status

Every question, across every platform

The work it does every week.

Audits, weekly reports and the rest of the recurring jobs that call a Pinterest Ads tool. Each one is written against the shipped gateway, so following it works.

Every Pinterest Ads tool, as the gateway ships it.

Each description is the one the tool reports to your assistant during discovery, which is what it reads before deciding to call it.

5 write

What it can change: Pause, resume or archive a campaign or ad group. Change a campaign or ad group budget. Create a campaign, always paused. Every write previews first.

31 tools

pinterest_health_check
Read-only Pinterest Ads health check. Verifies configured credentials, account access, delivery metrics access, and optional default account readability without exposing.
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.
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.
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_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, device, or other.
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 values, and.
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 topics, or editorial.
pinterest_get_platform_resources
Read Pinterest platform metadata and readiness resources: supported ad-account countries, delivery metric definitions, metrics readiness, lead-form questions, media upload.
pinterest_update_campaign_statuswrite
Pause, reactivate or archive a Pinterest campaign.
pinterest_update_campaign_budgetwrite
Change a Pinterest campaign's daily or lifetime spend cap.
pinterest_create_campaignwrite
Create a Pinterest campaign. Always created PAUSED, with no option to create it active.
pinterest_update_adgroup_budgetwrite
Change the daily or lifetime budget of a Pinterest ad group.
pinterest_update_adgroup_statuswrite
Pause, reactivate or archive a Pinterest ad group.

What you can measure, and how you can cut it.

The full catalogues live in the reference, where every entry carries the API field it maps to and the constraints that come with it. Here is their shape.

Metrics

7 families

All 91 metrics

Dimensions

3 families

Id19
Targeting14
Time3

All 36 dimensions

Everything else about it.

The reference, the catalogues, and how to put Pinterest Ads in front of your assistant.

The other five servers