`meta_ads_list_adsets`

List Meta Ad Sets

Description

List ad sets for a Meta ad account with campaign filtering, status, name search, single/multi-adset lookup by ID, and pagination. Entities may include _stored_preferences, optionally recent activities, and optionally automated rules (set include_rules=true to see which rules affect each ad set).

Read-onlyIdempotentOpen-world

Usage

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "meta_ads_list_adsets",
    "arguments": {
      "account_id": "123456789",
      "reason": "List ad sets"
    }
  }
}

hopkin meta adsets list

Flag	Type	Required	Description
`--account`	`string`	Required	The ad account ID (with or without act_ prefix)
`--adset`	`string`	Optional	Get a specific ad set by ID. When provided, returns only that ad set and ignores other filters/pagination.
`--adset-ids`	`array`	Optional	Get multiple ad sets by ID. Mutually exclusive with adset_id. When provided, ignores other filters/pagination.
`--campaign`	`string`	Optional	Filter by campaign ID
`--search`	`string`	Optional	Search ad sets by name (case-insensitive partial match)
`--status`	`array`	Optional	Filter by configured ad-set status (user-set): ACTIVE, PAUSED, DELETED, ARCHIVED
`--effective-status`	`array`	Optional	Filter by Meta-computed serving status: ACTIVE, PAUSED, DELETED, ARCHIVED, IN_PROCESS, WITH_ISSUES, CAMPAIGN_PAUSED
`--limit`	`integer`	Optional	Number of ad sets per page (default: 20, max: 100)
`--cursor`	`string`	Optional	Pagination cursor from previous response
`--refresh`	`boolean`	Optional	Force fresh data from Meta API instead of using cache. Defaults to false (cache-first). Only set to true when you need real-time data.
`--include-activities`	`boolean`	Optional	Include recent activity log (last 7 days of changes) for each entity
`--include-rules`	`boolean`	Optional	Include automated rules (from adrules_library) that affect each entity

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

Parameters

Name	Type	Required	Description
`account_id`	`string`	Required	The ad account ID (with or without act_ prefix)minLength: 1
`reason`	`string`	Required	Why this tool call is neededminLength: 1, maxLength: 500

Optional parameters (11)

Name	Type	Required	Description
`adset_id`	`string`	Optional	Get a specific ad set by ID. When provided, returns only that ad set and ignores other filters/pagination.minLength: 1
`adset_ids`	`array`	Optional	Get multiple ad sets by ID. Mutually exclusive with adset_id. When provided, ignores other filters/pagination.
`campaign_id`	`string`	Optional	Filter by campaign IDminLength: 1
`search`	`string`	Optional	Search ad sets by name (case-insensitive partial match)minLength: 1
`status`	`array`	Optional	Filter by configured ad-set status (user-set): ACTIVE, PAUSED, DELETED, ARCHIVED
`effective_status`	`array`	Optional	Filter by Meta-computed serving status: ACTIVE, PAUSED, DELETED, ARCHIVED, IN_PROCESS, WITH_ISSUES, CAMPAIGN_PAUSED
`limit`	`integer`	Optional	Number of ad sets per page (default: 20, max: 100)min: 1, max: 100
`cursor`	`string`	Optional	Pagination cursor from previous responseminLength: 1
`refresh`	`boolean`	Optional	Force fresh data from Meta API instead of using cache. Defaults to false (cache-first). Only set to true when you need real-time data.
`include_activities`	`boolean`	Optional	Include recent activity log (last 7 days of changes) for each entity
`include_rules`	`boolean`	Optional	Include automated rules (from adrules_library) that affect each entity

Examples

List all

{
  "account_id": "123456789",
  "reason": "List ad sets"
}

hopkin meta adsets list --account 123456789

Filter by campaign

{
  "account_id": "123456789",
  "campaign_id": "23842453456789",
  "reason": "List ad sets in campaign"
}

hopkin meta adsets list --account 123456789 --campaign 23842453456789

Filter by status

{
  "account_id": "123456789",
  "status": [
    "ACTIVE",
    "PAUSED"
  ],
  "reason": "List active/paused ad sets"
}

hopkin meta adsets list --account 123456789 --status ACTIVE,PAUSED

Filter by serving status

{
  "account_id": "123456789",
  "effective_status": [
    "CAMPAIGN_PAUSED",
    "WITH_ISSUES"
  ],
  "reason": "Find ad sets paused by parent or with issues"
}

hopkin meta adsets list --account 123456789 --effective-status CAMPAIGN_PAUSED,WITH_ISSUES

Get by ID

{
  "account_id": "123456789",
  "adset_id": "23842453456789",
  "reason": "Get specific ad set"
}

hopkin meta adsets list --account 123456789 --adset 23842453456789

Get multiple by IDs

{
  "account_id": "123456789",
  "adset_ids": [
    "23842453456789",
    "23842453456790"
  ],
  "reason": "Get specific ad sets"
}

hopkin meta adsets list --account 123456789 --adset-ids 23842453456789,23842453456790

Search by name

{
  "account_id": "123456789",
  "search": "Retargeting",
  "reason": "Find retargeting ad sets"
}

hopkin meta adsets list --account 123456789 --search Retargeting