pinterest_run_report

Run a read-only Pinterest Ads report. One of 56 Pinterest Ads tools on the Get MCP Ads MCP gateway.

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.

Source: Pinterest Ads
Kind: Read
Discovery: Announced in the tool list
Account parameter: adAccountId
Endpoint: https://mcp.getmcpads.com/pinterest-ads/mcp

ParametersLink to this section

Name	Type	Required	Notes
`adAccountId`	string	Optional	Owning advertising account ID. Use the exact ID returned by account discovery; do not substitute a campaign or business ID.
`level`	string	Optional	Entity or aggregation level for the requested report. One of: `AD_ACCOUNT`, `CAMPAIGN`, `AD_GROUP`, `AD`, `PRODUCT_GROUP`. Default: `"CAMPAIGN"`.
`startDate`	string	Required	First date of the reporting period, in YYYY-MM-DD format.
`endDate`	string	Required	Last date of the reporting period, in YYYY-MM-DD format, on or after startDate.
`granularity`	string	Optional	Time bucket used to aggregate reporting rows. One of: `TOTAL`, `DAY`, `WEEK`, `MONTH`, `HOUR`. Default: `"DAY"`.
`columns`	array	Optional	Native Pinterest reporting column names. Discover supported columns before selecting metrics. Default: `["SPEND_IN_DOLLAR","IMPRESSION_1","CLICKTHROUGH_1","OUTBOUND_CLICK_1","REPIN_1","TOTAL_CHECKOUT","TOTAL_CHECKOUT_VALUE_IN_MICRO_DOLLAR","CHECKOUT_ROAS"]`.
`executionMode`	string	Optional	Choose the supported synchronous, asynchronous or automatic report execution strategy. One of: `auto`, `sync`, `async`. Default: `"auto"`.
`waitForReport`	boolean	Optional	False starts or polls an async report once and returns a resumable reportToken instead of waiting. Use the same query and token on the next call. Default: `true`.
`reportToken`	string	Optional	Resume a previously returned async reporting token for this ad account; never starts a second job.
`entityIds`	array	Optional	Exact IDs of the entities to include in the selected reporting level.
`targetingTypes`	array	Optional	Native targeting categories used to break down delivery.
`filters`	object	Optional	Filters combined according to this tool's query schema. Use provider field names and the declared operators.
`limit`	integer	Optional	Maximum number of returned items or rows. The declared bounds and default apply; use pagination for additional results. Default: `500`.
`clickWindowDays`	integer	Optional	Click-through attribution window, in days. Default: `30`.
`engagementWindowDays`	integer	Optional	Engagement-through attribution window, in days. Default: `30`.
`viewWindowDays`	integer	Optional	View-through attribution window, in days. Default: `1`.
`conversionReportTime`	string	Optional	Whether conversions are assigned to the ad action date or the conversion date. One of: `TIME_OF_AD_ACTION`, `TIME_OF_CONVERSION`. Default: `"TIME_OF_AD_ACTION"`.
`attributionTypes`	array	Optional	Provider attribution categories included in the report.
`reportingTimezone`	string	Optional	Provider reporting timezone selector. Keep it consistent when comparing periods. One of: `PINTEREST_TIME_ZONE`, `AD_ACCOUNT_TIME_ZONE`. Default: `"PINTEREST_TIME_ZONE"`.

Calling itLink to this section

jsonDirectly, since it is announced

{
  "name": "pinterest_run_report",
  "arguments": {
    "startDate": "<string>",
    "endDate": "<string>"
  }
}