`meta_ads_list_ad_accounts`

List Meta Ad Accounts

Description

List Meta ad accounts with search, status filtering, single/multi-account lookup by ID, and pagination. Cached by default; pass refresh=true for latest data. Entities may include _stored_preferences and optionally recent activities.

Read-onlyOpen-world

Usage

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "meta_ads_list_ad_accounts",
    "arguments": {
      "reason": "List all ad accounts"
    }
  }
}

hopkin meta ad-accounts list

Flag	Type	Required	Description
`--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.
`--cursor`	`string`	Optional	Pagination cursor from previous response
`--search`	`string`	Optional	Search ad accounts by name (case-insensitive partial match)
`--account`	`string`	Optional	Filter by exact account ID (without act_ prefix)
`--account-ids`	`array`	Optional	Get multiple accounts by ID. Mutually exclusive with account_id. When provided, ignores other filters/pagination.
`--status`	`integer`	Optional	Account status code (1=Active, 2=Disabled, etc.)
`--limit`	`integer`	Optional	Number of accounts per page (default: 20, max: 100)
`--include-activities`	`boolean`	Optional	Include recent activity log (last 7 days of changes) for each entity

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

List all
Search by name
Filter by status
Get by ID
Get multiple by IDs
Force refresh

Parameters

Name	Type	Required	Description
`reason`	`string`	Required	Why this tool call is neededminLength: 1, maxLength: 500

Optional parameters (8)

Name	Type	Required	Description
`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.
`cursor`	`string`	Optional	Pagination cursor from previous responseminLength: 1
`search`	`string`	Optional	Search ad accounts by name (case-insensitive partial match)minLength: 1
`account_id`	`string`	Optional	Filter by exact account ID (without act_ prefix)minLength: 1
`account_ids`	`array`	Optional	Get multiple accounts by ID. Mutually exclusive with account_id. When provided, ignores other filters/pagination.
`status`	`integer`	Optional	Account status code (1=Active, 2=Disabled, etc.)
`limit`	`integer`	Optional	Number of accounts per page (default: 20, max: 100)min: 1, max: 100
`include_activities`	`boolean`	Optional	Include recent activity log (last 7 days of changes) for each entity

Examples

List all

{
  "reason": "List all ad accounts"
}

hopkin meta ad-accounts list

Search by name

{
  "search": "marketing",
  "reason": "Find marketing accounts"
}

hopkin meta ad-accounts list --search marketing

Filter by status

{
  "status": 1,
  "reason": "List active accounts"
}

hopkin meta ad-accounts list --status 1

Get by ID

{
  "account_id": "123456789",
  "reason": "Get specific account"
}

hopkin meta ad-accounts list --account 123456789

Get multiple by IDs

{
  "account_ids": [
    "123456789",
    "987654321"
  ],
  "reason": "Get specific accounts"
}

hopkin meta ad-accounts list --account-ids 123456789,987654321

Force refresh

{
  "refresh": true,
  "reason": "Get fresh data from Meta API"
}

hopkin meta ad-accounts list --refresh true