`linkedin_ads_list_campaigns`

List LinkedIn Campaigns

Description

List LinkedIn Campaigns for an ad account. Campaigns define targeting, bidding, and budget within a campaign group. Pass include_targeting: true for full normalized targetingCriteria (include/exclude facets with URNs resolved to human names) + audience expansion, audience network preferences, frequency cap, and conversion actions. Pass include_forecast: true to additionally return per-campaign audience size forecasts (requires include_targeting).

Read-onlyIdempotentOpen-world

Usage

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "linkedin_ads_list_campaigns",
    "arguments": {
      "account_id": "123456789",
      "reason": "User wants to see campaigns"
    }
  }
}

hopkin linkedin campaigns list

Flag	Type	Required	Description
`--account`	`string`	Required	Ad account ID (numeric, without URN prefix).
`--status`	`array`	Optional	Filter by status. Defaults to [ACTIVE, PAUSED].
`--campaign-group-id`	`string`	Optional	Filter by campaign group (numeric ID).
`--type`	`array`	Optional	Filter by campaign type.
`--campaign`	`string`	Optional	Fetch a single campaign by numeric ID.
`--campaign-ids`	`array`	Optional	Fetch specific campaigns by numeric IDs (batch filter).
`--limit`	`integer`	Optional
`--cursor`	`string`	Optional
`--refresh`	`boolean`	Optional
`--include-targeting`	`boolean`	Optional	Return full normalized targetingCriteria (include + exclude facets with URNs resolved to human names), plus audience_expansion_enabled, audience_network_enabled, frequency_cap, creative_selection, and conversion_actions. Adds ~6-13 API calls per list regardless of campaign count (batched URN resolution is cached).
`--include-forecast`	`boolean`	Optional	Add audience_forecast (total + breakdown by channel) to each campaign. Requires include_targeting: true. Adds 1 API call per campaign (capped 5 parallel). Per-campaign failures are non-fatal.
`--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": {
    "linkedin-ads": {
      "url": "https://linkedin.mcp.hopkin.ai",
      "transport": "sse"
    }
  }
}

Parameters

Name	Type	Required	Description
`account_id`	`string`	Required	Ad account ID (numeric, without URN prefix).minLength: 1, maxLength: 64
`reason`	`string`	Required	Why this tool call is neededminLength: 1, maxLength: 500

Optional parameters (11)

Name	Type	Required	Description
`status`	`array`	Optional	Filter by status. Defaults to [ACTIVE, PAUSED].
`campaign_group_id`	`string`	Optional	Filter by campaign group (numeric ID).
`type`	`array`	Optional	Filter by campaign type.
`campaign_id`	`string`	Optional	Fetch a single campaign by numeric ID.maxLength: 64
`campaign_ids`	`array`	Optional	Fetch specific campaigns by numeric IDs (batch filter).
`limit`	`integer`	Optional	min: 1, max: 100
`cursor`	`string`	Optional
`refresh`	`boolean`	Optional
`include_targeting`	`boolean`	Optional	Return full normalized targetingCriteria (include + exclude facets with URNs resolved to human names), plus audience_expansion_enabled, audience_network_enabled, frequency_cap, creative_selection, and conversion_actions. Adds ~6-13 API calls per list regardless of campaign count (batched URN resolution is cached).
`include_forecast`	`boolean`	Optional	Add audience_forecast (total + breakdown by channel) to each campaign. Requires include_targeting: true. Adds 1 API call per campaign (capped 5 parallel). Per-campaign failures are non-fatal.
`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 active campaigns

{
  "account_id": "123456789",
  "reason": "User wants to see campaigns"
}

hopkin linkedin campaigns list --account 123456789

By campaign group

{
  "account_id": "123456789",
  "campaign_group_id": "987654",
  "reason": "List campaigns under a specific campaign group"
}

hopkin linkedin campaigns list --account 123456789 --campaign-group-id 987654

By type

{
  "account_id": "123456789",
  "type": [
    "SPONSORED_UPDATES"
  ],
  "reason": "Filter to sponsored content campaigns"
}

hopkin linkedin campaigns list --account 123456789 --type SPONSORED_UPDATES

Full targeting audit

{
  "account_id": "123456789",
  "include_targeting": true,
  "reason": "Audit full targeting config across all campaigns"
}

hopkin linkedin campaigns list --account 123456789 --include-targeting true

Audit with audience forecast

{
  "account_id": "123456789",
  "include_targeting": true,
  "include_forecast": true,
  "reason": "Full audit with audience size forecasts"
}

hopkin linkedin campaigns list --account 123456789 --include-targeting true --include-forecast true