`microsoft_ads_get_activities`

Get Microsoft Ads Change History

Microsoft

Description

Read-onlyIdempotentOpen-world

Usage

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "microsoft_ads_get_activities",
    "arguments": {
      "account_id": "123456789",
      "reason": "What changed in the account this week"
    }
  }
}

hopkin microsoft activities get

Flag	Type	Required	Description
`--account`	`string`	Required	Microsoft Advertising Account ID (numeric string).
`--customer-id`	`string`	Optional	Customer (manager) ID. Optional: only used to check access to an agency-managed account.
`--start-date`	`string`	Optional	Start of the window, YYYY-MM-DD (UTC). Defaults to 7 days before end_date.
`--end-date`	`string`	Optional	End of the window, YYYY-MM-DD (UTC), inclusive. Defaults to today.
`--item-types`	`array`	Optional	Only these kinds of change. Keyword includes negative keyword lists and product groups; Extension includes sitelinks, callouts and other ad extensions.
`--entity-ids`	`array`	Optional	Only changes to these entity IDs (campaign, ad group, ad, keyword…).
`--limit`	`integer`	Optional	Changes per page (1-200, default 50).
`--cursor`	`string`	Optional	nextCursor from the previous response. Pass it with otherwise identical parameters for the next page.
`--refresh`	`boolean`	Optional	Re-read the account from Microsoft before answering. Normally not needed: it is re-read when the last read is over an hour old.
`--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 Account ID (numeric string).minLength: 1, maxLength: 20, pattern: ^\d+$
`reason`	`string`	Required	Why this tool call is neededminLength: 1, maxLength: 500

Optional parameters (9)

Name	Type	Required	Description
`customer_id`	`string`	Optional	Customer (manager) ID. Optional: only used to check access to an agency-managed account.minLength: 1, maxLength: 20, pattern: ^\d+$
`start_date`	`string`	Optional	Start of the window, YYYY-MM-DD (UTC). Defaults to 7 days before end_date.pattern: ^\d{4}-\d{2}-\d{2}$
`end_date`	`string`	Optional	End of the window, YYYY-MM-DD (UTC), inclusive. Defaults to today.pattern: ^\d{4}-\d{2}-\d{2}$
`item_types`	`array`	Optional	Only these kinds of change. Keyword includes negative keyword lists and product groups; Extension includes sitelinks, callouts and other ad extensions.
`entity_ids`	`array`	Optional	Only changes to these entity IDs (campaign, ad group, ad, keyword…).
`limit`	`integer`	Optional	Changes per page (1-200, default 50).min: 1, max: 200
`cursor`	`string`	Optional	nextCursor from the previous response. Pass it with otherwise identical parameters for the next page.
`refresh`	`boolean`	Optional	Re-read the account from Microsoft before answering. Normally not needed: it is re-read when the last read is over an hour old.
`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.

Examples

Recent changes

{
  "account_id": "123456789",
  "reason": "What changed in the account this week"
}

hopkin microsoft activities get --account 123456789

Budget audit, last 30 days

{
  "account_id": "123456789",
  "start_date": "2026-09-01",
  "end_date": "2026-09-30",
  "item_types": [
    "Campaign"
  ],
  "reason": "Did anyone change budgets before the dip?"
}

hopkin microsoft activities get --account 123456789 --start-date 2026-09-01 --end-date 2026-09-30 --item-types Campaign

One campaign

{
  "account_id": "123456789",
  "entity_ids": [
    "487745984"
  ],
  "reason": "Who paused this campaign?"
}

hopkin microsoft activities get --account 123456789 --entity-ids 487745984