`meta_ads_get_activities`

Get Meta Ads Activities

Description

Retrieve activity/change history for a Meta ad account or specific entity. Cached with 1-hour TTL; use refresh=true for fresh data. Meta's API only returns the last 7 days per call, but cached data accumulates for historical lookups.

Read-onlyIdempotentOpen-world

Usage

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "meta_ads_get_activities",
    "arguments": {
      "account_id": "123456789",
      "reason": "View recent account changes"
    }
  }
}

hopkin meta activities get

Flag	Type	Required	Description
`--account`	`string`	Required	The ad account ID (with or without act_ prefix)
`--entity-id`	`string`	Optional	Filter activities to a specific entity (campaign, ad set, or ad ID). If omitted, returns account-level activities.
`--entity-type`	`string`	Optional	Type of entity: ACCOUNT, CAMPAIGN, AD_SET, AD. Used with entity_id for filtering.
`--start-date`	`string`	Optional	Start date for activity range (ISO 8601, e.g. 2024-01-01)
`--end-date`	`string`	Optional	End date for activity range (ISO 8601, e.g. 2024-01-31)
`--limit`	`integer`	Optional	Number of activities per page (default: 20, max: 100)
`--cursor`	`string`	Optional	Pagination cursor from previous response
`--refresh`	`boolean`	Optional	Force fresh activity data from Meta API instead of using cache. Defaults to false (cache-first). Only set to true when you need real-time data.

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

Account activities
Campaign history
Date range

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 (7)

Name	Type	Required	Description
`entity_id`	`string`	Optional	Filter activities to a specific entity (campaign, ad set, or ad ID). If omitted, returns account-level activities.minLength: 1
`entity_type`	`string`	Optional	Type of entity: ACCOUNT, CAMPAIGN, AD_SET, AD. Used with entity_id for filtering. `ACCOUNT` `CAMPAIGN` `AD_SET` `AD`
`start_date`	`string`	Optional	Start date for activity range (ISO 8601, e.g. 2024-01-01)
`end_date`	`string`	Optional	End date for activity range (ISO 8601, e.g. 2024-01-31)
`limit`	`integer`	Optional	Number of activities per page (default: 20, max: 100)min: 1, max: 100
`cursor`	`string`	Optional	Pagination cursor from previous responseminLength: 1
`refresh`	`boolean`	Optional	Force fresh activity data from Meta API instead of using cache. Defaults to false (cache-first). Only set to true when you need real-time data.

Examples

Account activities

{
  "account_id": "123456789",
  "reason": "View recent account changes"
}

hopkin meta activities get --account 123456789

Campaign history

{
  "account_id": "123456789",
  "entity_id": "23842453456789",
  "entity_type": "CAMPAIGN",
  "reason": "View campaign change history"
}

hopkin meta activities get --account 123456789 --entity-id 23842453456789 --entity-type CAMPAIGN

Date range

{
  "account_id": "123456789",
  "start_date": "2024-01-01",
  "end_date": "2024-01-31",
  "reason": "January activity"
}

hopkin meta activities get --account 123456789 --start-date 2024-01-01 --end-date 2024-01-31