Campaigns

Campaigns group related opportunities together. A default "General" campaign always exists and is used when no campaign is specified for a new opportunity.

Campaign Statuses

• active
• paused
• completed

create_campaign

Create a new campaign to group related opportunities.

Parameters

Parameter	Type	Required	Description
name	string	Yes	Campaign name
description	string	No	Description
status	string	No	active, paused, or completed (default: active)
start_date	string	No	Start date (YYYY-MM-DD)
end_date	string	No	End date (YYYY-MM-DD)

Example

{
  "name": "create_campaign",
  "arguments": {
    "name": "Product Launch Q2 2026",
    "description": "PR push for the v3 launch",
    "start_date": "2026-04-01",
    "end_date": "2026-06-30"
  }
}

get_campaign

Get a campaign by ID with its opportunities.

Parameters

Parameter	Type	Required	Description
id	string (UUID)	Yes	Campaign ID

Example

{
  "name": "get_campaign",
  "arguments": {
    "id": "550e8400-e29b-41d4-a716-446655440000"
  }
}

list_campaigns

List campaigns with optional filters.

Parameters

Parameter	Type	Required	Description
status	string	No	Filter by status: active, paused, completed
include_archived	boolean	No	Include archived campaigns (default: false)
limit	number	No	Max results (default: 50)
offset	number	No	Offset for pagination (default: 0)

Example

{
  "name": "list_campaigns",
  "arguments": {
    "status": "active"
  }
}

update_campaign

Update campaign fields.

Parameters

Parameter	Type	Required	Description
id	string (UUID)	Yes	Campaign ID
name	string	No	Campaign name
description	string	No	Description
status	string	No	active, paused, or completed
start_date	string	No	Start date (YYYY-MM-DD)
end_date	string	No	End date (YYYY-MM-DD)

Example

{
  "name": "update_campaign",
  "arguments": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "status": "completed"
  }
}

archive_campaign

Soft-delete a campaign.

Parameters

Parameter	Type	Required	Description
id	string (UUID)	Yes	Campaign ID

Example

{
  "name": "archive_campaign",
  "arguments": {
    "id": "550e8400-e29b-41d4-a716-446655440000"
  }
}

restore_campaign

Restore an archived campaign.

Parameters

Parameter	Type	Required	Description
id	string (UUID)	Yes	Campaign ID

Example

{
  "name": "restore_campaign",
  "arguments": {
    "id": "550e8400-e29b-41d4-a716-446655440000"
  }
}

campaign_summary

Get an overview of a campaign including opportunity counts by stage and total coverage.

Parameters

Parameter	Type	Required	Description
id	string (UUID)	Yes	Campaign ID

Example

{
  "name": "campaign_summary",
  "arguments": {
    "id": "550e8400-e29b-41d4-a716-446655440000"
  }
}

Response Shape

{
  "campaign": { "id": "...", "name": "...", "status": "active", "..." : "..." },
  "opportunity_count": 12,
  "stage_breakdown": {
    "researching": 2,
    "pitched": 5,
    "in_progress": 3,
    "published": 2
  },
  "coverage_count": 4
}