`microsoft_ads_list_accounts`

List Microsoft Ads Accounts

Microsoft

Description

List Microsoft Advertising accounts accessible to the authenticated user, or look up one

Read-onlyOpen-world

Usage

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "microsoft_ads_list_accounts",
    "arguments": {
      "reason": "Show me all connected Microsoft Ads accounts"
    }
  }
}

hopkin microsoft accounts list

Flag	Type	Required	Description
`--account`	`string`	Optional	Look up a single account by its Microsoft Advertising AccountId. When provided, other filters and pagination are ignored and the tool returns exactly one account. This is the single-account lookup pattern — there is no separate get_account tool.
`--customer-id`	`string`	Optional	Microsoft Advertising CustomerId of the agency/manager account. Required when accessing accounts managed under a customer hierarchy. Equivalent to Google Ads login_customer_id.
`--status`	`array`	Optional	Filter accounts by status. Accepts a JSON array or repeated values.
`--search`	`string`	Optional	Case-insensitive partial match on account name or account_id.
`--limit`	`integer`	Optional	Number of accounts per page (default: 20, max: 100).
`--cursor`	`string`	Optional	Opaque cursor from the previous response's nextCursor. Pass it with otherwise identical parameters to get the next page; a cursor reused with different filters is rejected. Omit for the first page.
`--refresh`	`boolean`	Optional	Force a live fetch from the Microsoft Ads API, bypassing the local cache. Defaults to false (cache-first — the normal, faster path). Set to true whenever the user asks for fresh / latest / real-time / up-to-date data, or explicitly says they do NOT want cached / stale data. If the user does not care about freshness, leave it false.
`--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
`reason`	`string`	Required	Why this tool call is neededminLength: 1, maxLength: 500

Optional parameters (8)

Name	Type	Required	Description
`account_id`	`string`	Optional	Look up a single account by its Microsoft Advertising AccountId. When provided, other filters and pagination are ignored and the tool returns exactly one account. This is the single-account lookup pattern — there is no separate get_account tool.minLength: 1
`customer_id`	`string`	Optional	Microsoft Advertising CustomerId of the agency/manager account. Required when accessing accounts managed under a customer hierarchy. Equivalent to Google Ads login_customer_id.minLength: 1
`status`	`array`	Optional	Filter accounts by status. Accepts a JSON array or repeated values.
`search`	`string`	Optional	Case-insensitive partial match on account name or account_id.minLength: 1
`limit`	`integer`	Optional	Number of accounts per page (default: 20, max: 100).min: 1, max: 100
`cursor`	`string`	Optional	Opaque cursor from the previous response's nextCursor. Pass it with otherwise identical parameters to get the next page; a cursor reused with different filters is rejected. Omit for the first page.minLength: 1
`refresh`	`boolean`	Optional	Force a live fetch from the Microsoft Ads API, bypassing the local cache. Defaults to false (cache-first — the normal, faster path). Set to true whenever the user asks for fresh / latest / real-time / up-to-date data, or explicitly says they do NOT want cached / stale data. If the user does not care about freshness, leave it false.
`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

List all accounts

{
  "reason": "Show me all connected Microsoft Ads accounts"
}

hopkin microsoft accounts list

Look up a single account

{
  "account_id": "1234567",
  "reason": "Get details for account 1234567"
}

hopkin microsoft accounts list --account 1234567

Filter by status

{
  "status": [
    "Active"
  ],
  "reason": "Show only active accounts"
}

hopkin microsoft accounts list --status Active

Search by name

{
  "search": "marketing",
  "reason": "Find accounts with marketing in the name"
}

hopkin microsoft accounts list --search marketing

Force refresh

{
  "refresh": true,
  "reason": "Get the latest account data from the API"
}

hopkin microsoft accounts list --refresh true

Agency: accounts under a customer

{
  "customer_id": "9876543",
  "reason": "List accounts managed under customer 9876543"
}

hopkin microsoft accounts list --customer-id 9876543