ICPs

Ideal Customer Profile scoring and management.

Tools (6)

list_icps

Full name: campaignstack_list_icps

icps:read Read-only Idempotent

List all ICP (Ideal Customer Profile) definitions for a campaign. Returns ICP IDs with criteria summary including target titles, industries, seniorities, and score threshold. Use the returned icpId values with campaignstack_get_icp_scores to view lead match scores, or campaignstack_trigger_icp_scoring to run scoring.

Parameters

Name	Type	Required	Default	Description
campaignId	string	Yes	—	(min length: 1)

---

get_icp_scores

Full name: campaignstack_get_icp_scores

icps:read Read-only Idempotent

Get ICP match scores for leads. Filter by minimum score to find top matches. Returns paginated array of { leadId, leadName, icpMatchScore, matchedFields } sorted by score descending. Use campaignstack_list_icps to find ICP IDs. High-scoring leads can be added to lists via campaignstack_add_leads_to_list.

Parameters

Name	Type	Required	Default	Description
icpId	string	Yes	—	(min length: 1)
minScore	number	No	—	(min: 0, max: 100)
limit	number	No	20	(min: 1, max: 100)
cursor	string	No	—

---

trigger_icp_scoring

Full name: campaignstack_trigger_icp_scoring

icps:write Idempotent

Trigger ICP scoring for specific leads or all leads in the campaign. Scoring runs and persists results — use campaignstack_get_icp_scores to check results afterward. Use campaignstack_list_icps to find ICP IDs first.

Parameters

Name	Type	Required	Default	Description
icpId	string	Yes	—	(min length: 1)
leadIds	string[]	No	—

---

create_icp

Full name: campaignstack_create_icp

icps:write

Create a new ICP (Ideal Customer Profile) for a campaign. Specify target criteria: titles, industries, seniorities, company sizes, and keywords. After creation, use campaignstack_trigger_icp_scoring to score leads against the new ICP. Use campaignstack_list_campaigns to find valid campaignId values.

Parameters

Name	Type	Required	Default	Description
campaignId	string	Yes	—	(min length: 1)
titles	string[]	No	—
industries	string[]	No	—
seniorities	string[]	No	—
companySizes	string[]	No	—
keywords	string[]	No	—

---

update_icp

Full name: campaignstack_update_icp

icps:write Idempotent

Update an existing ICP’s criteria. Only supply the fields you want to change — omitted fields are left unchanged. Updating criteria automatically invalidates cached scores and reschedules scoring variant generation. Use campaignstack_list_icps to find ICP IDs.

Parameters

Name	Type	Required	Default	Description
icpId	string	Yes	—	(min length: 1)
titles	string[]	No	—
industries	string[]	No	—
seniorities	string[]	No	—
companySizes	string[]	No	—
keywords	string[]	No	—

---

delete_icp

Full name: campaignstack_delete_icp

icps:write Destructive Idempotent

Permanently delete an ICP and its associated scoring data. This action is irreversible. Use campaignstack_list_icps to find ICP IDs before deleting.

Parameters

Name	Type	Required	Default	Description
icpId	string	Yes	—	(min length: 1)

---