`microsoft_ads_get_account_summary`

Get Microsoft Ads Account Summary

Microsoft

Description

THE tool for an account-level PERFORMANCE SUMMARY — one rolled-up total for a whole Microsoft

Read-onlyOpen-world

Usage

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "microsoft_ads_get_account_summary",
    "arguments": {}
  }
}

hopkin microsoft account-summary get

Flag	Type	Required	Description
`--account`	`string`	Required	Microsoft Advertising AccountId to report on.
`--customer-id`	`string`	Optional	Microsoft Advertising CustomerId (agency/manager). Required when accessing accounts managed under a customer hierarchy.
`--date-range`	`object`	Optional	Custom date range. Mutually exclusive with date_preset. If neither is provided, defaults to the last 30 days.
`--date-preset`	`string`	Optional	Predefined date range. Mutually exclusive with date_range. If neither is provided, defaults to the last 30 days.
`--include-all-conversions`	`boolean`	Optional	When true, includes an additional all_conversions block (all_conversions, all_revenue, all_cost_per_conversion, all_roas, view_through_conversions). This captures ALL conversion goals including those not marked "Include in Conversions" (e.g., view-through, non-bidding goals). Note: conversions is the bidding-set count only; all_conversions.all_conversions is every conversion goal — typically much larger for accounts with non-bidding goals.
`--breakdown-by-goal`	`boolean`	Optional	When true (default), runs a parallel GoalsAndFunnelsReport and returns goal_breakdown keyed by account_id. Each entry is an array of per-goal rows with all_conversions, all_revenue, view_through_conversions, and assists. Pass false to skip the parallel report when latency matters more than goal context. goal_breakdown_granularity will be "account" for this tool.
`--connection-id`	`string`	Optional	Optional ID of a specific connection to use for this call. Omit to use the actor's default connection for this network. Call <platform>_list_connections to discover available connection IDs.

{
  "mcpServers": {
    "microsoft-ads": {
      "url": "https://microsoft.mcp.hopkin.ai",
      "transport": "sse"
    }
  }
}

Parameters

Name	Type	Required	Description
`account_id`	`string`	Required	Microsoft Advertising AccountId to report on.minLength: 1
`reason`	`string`	Required	Why this tool call is neededminLength: 1, maxLength: 500

Optional parameters (6)

Name	Type	Required	Description
`customer_id`	`string`	Optional	Microsoft Advertising CustomerId (agency/manager). Required when accessing accounts managed under a customer hierarchy.minLength: 1
`date_range`	`object`	Optional	Custom date range. Mutually exclusive with date_preset. If neither is provided, defaults to the last 30 days.
`date_preset`	`string`	Optional	Predefined date range. Mutually exclusive with date_range. If neither is provided, defaults to the last 30 days. `Today` `Yesterday` `LastSevenDays` `ThisWeek` `LastWeek` `LastFourWeeks` `ThisMonth` `LastMonth` `LastThreeMonths` `LastSixMonths` `ThisYear` `LastYear`
`include_all_conversions`	`boolean`	Optional	When true, includes an additional all_conversions block (all_conversions, all_revenue, all_cost_per_conversion, all_roas, view_through_conversions). This captures ALL conversion goals including those not marked "Include in Conversions" (e.g., view-through, non-bidding goals). Note: conversions is the bidding-set count only; all_conversions.all_conversions is every conversion goal — typically much larger for accounts with non-bidding goals.
`breakdown_by_goal`	`boolean`	Optional	When true (default), runs a parallel GoalsAndFunnelsReport and returns goal_breakdown keyed by account_id. Each entry is an array of per-goal rows with all_conversions, all_revenue, view_through_conversions, and assists. Pass false to skip the parallel report when latency matters more than goal context. goal_breakdown_granularity will be "account" for this tool.
`connection_id`	`string`	Optional	Optional ID of a specific connection to use for this call. Omit to use the actor's default connection for this network. Call <platform>_list_connections to discover available connection IDs.

Description

Usage

Parameters

Related Tools