`microsoft_ads_list_customers`

List Microsoft Ads Customers

Microsoft

Description

List all Microsoft Advertising customers (manager/agency accounts) accessible to the authenticated user.

Read-onlyIdempotentOpen-world

Usage

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "microsoft_ads_list_customers",
    "arguments": {
      "reason": "Show me all accessible Microsoft Advertising customers"
    }
  }
}

hopkin microsoft customers list

Flag	Type	Required	Description
`--search`	`string`	Optional	Case-insensitive partial match on customer name or customer_id.
`--status`	`string`	Optional	Filter customers by status.
`--limit`	`integer`	Optional	Number of customers 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.
`--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 (5)

Name	Type	Required	Description
`search`	`string`	Optional	Case-insensitive partial match on customer name or customer_id.minLength: 1
`status`	`string`	Optional	Filter customers by status. `Active` `Inactive`
`limit`	`integer`	Optional	Number of customers 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
`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 customers

{
  "reason": "Show me all accessible Microsoft Advertising customers"
}

hopkin microsoft customers list

Filter active customers

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

hopkin microsoft customers list --status Active

Search by name

{
  "search": "Contoso",
  "reason": "Find the Contoso customer account"
}

hopkin microsoft customers list --search Contoso

Paginate

{
  "limit": 10,
  "cursor": "eyJvZmZzZXQiOjEwfQ",
  "reason": "Get next page of customers"
}

hopkin microsoft customers list --limit 10 --cursor eyJvZmZzZXQiOjEwfQ