linkedin_ads_list_campaigns

List LinkedIn Campaigns

Linkedin

Description

List LinkedIn Campaigns for an ad account. Campaigns define targeting, bidding, and budget within a campaign group.

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
FlagTypeRequiredDescription
--accountstringRequiredAd account ID (numeric, without URN prefix).
--statusarrayOptionalFilter by status. Defaults to [ACTIVE, PAUSED].
--campaign-group-idstringOptionalFilter by campaign group (numeric ID).
--typearrayOptionalFilter by campaign type.
--campaignstringOptionalFetch a single campaign by numeric ID.
--campaign-idsarrayOptionalFetch specific campaigns by numeric IDs (batch filter).
--limitintegerOptional
--cursorstringOptional
--refreshbooleanOptional
{
  "mcpServers": {
    "linkedin-ads": {
      "url": "https://mcp.hopkin.ai/linkedin-ads/mcp",
      "transport": "sse"
    }
  }
}
  • List active campaigns
  • By campaign group
  • By type

Parameters

NameTypeRequiredDescription
account_id string Required Ad account ID (numeric, without URN prefix).minLength: 1
reason string Required Why this tool call is neededminLength: 1, maxLength: 500
Optional parameters (8)
NameTypeRequiredDescription
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.
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

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