Skip to content
Get MCP AdsGet MCP Ads, home

rtb_house_get_insights

Read RTB House daily or grouped performance. One of 7 RTB House tools on the Get MCP Ads MCP gateway.

Read RTB House daily or grouped performance. Conversion metrics require an explicit countConvention. Returns available metrics, labelled ratio calculations, unavailableMetrics and partial coverage, with attribution, currency and UTC offset. Never sum ratios or reach across rows. RTB House validates dimension combinations.

Source
RTB House
Kind
Read
Discovery
Reachable through search_tools and run_tool
Account parameter
advertiserId
Endpoint
https://mcp.getmcpads.com/rtb-house/mcp

ParametersLink to this section

NameTypeRequiredNotes
advertiserIdstringRequiredRTB House advertiser hash. Use list_accounts for the selected accounts.
dayFromstringRequiredFirst report date, inclusive, YYYY-MM-DD.
dayTostringRequiredLast report date, inclusive, YYYY-MM-DD; at most 366 days after the start including both endpoints.
groupByarrayOptionalNative dimensions to group by; RTB House validates compatible combinations. Default: ["day"].
metricsarrayOptionalRequested metrics. Unavailable advertiser metrics are reported explicitly. eCPC, eCPM and eCPA may be calculated from available native measurements, with formulas included. Default: ["campaignCost","impsCount","clicksCount"].
countConventionstringOptionalExplicit attribution convention, required when requesting conversion metrics. One of: ATTRIBUTED, POST_VIEW, ALL_POST_CLICK, ALL_CONVERSIONS.
utcOffsetHoursintegerOptionalFixed UTC offset for the whole report, not a timezone with daylight saving. Non-zero offsets restrict available dimensions. Default: 0.
campaignIdsarrayOptionalCampaign hashes to filter, sent as subcampaigns.
limitintegerOptionalMaximum rows returned to the assistant; truncation is reported explicitly. Default: 1000.

Calling itLink to this section

jsonThrough run_tool, since it is not announced
{
  "name": "run_tool",
  "arguments": {
    "name": "rtb_house_get_insights",
    "args": {
      "advertiserId": "<string>",
      "dayFrom": "<string>",
      "dayTo": "<string>"
    }
  }
}
Esc

Type to search