Prospects

List, view, and update prospect status.

`list_prospects`

List prospects in a campaign, sorted by score (highest first).

Each prospect includes their score, title, company, when they were added to the campaign, and when they were scored. Use offset to paginate through large result sets. Always returns a non-empty string. An empty result means the tool did not execute — do not infer or fabricate prospect names, scores, or IDs. Args: campaign_id: The campaign to list prospects for. min_score: Minimum score filter (0-100). max_score: Maximum score filter (0-100). status: Filter by status: "new", "contacted", "hidden", or "exported". limit: Number of results to return (default 20, max 100). offset: Number of results to skip for pagination (default 0).

Name	Type	Required	Description
campaign_id	string	yes
min_score		no	Default: null
max_score		no	Default: null
status		no	Default: null
limit	integer	no	Default: 20
offset	integer	no	Default: 0

`get_prospect`

Get full prospect detail including score reasoning, contact info, and outreach guidance.

Returns enriched contact data (email, phone) if available — contact enrichment is async, so data appears after the enrichment task completes. Always returns a non-empty string. An empty result means the tool did not execute — do not fabricate prospect details or contact information. Args: campaign_id: The campaign the prospect belongs to. profile_id: The prospect's profile ID.

Name	Type	Required	Description
campaign_id	string	yes
profile_id	string	yes

`update_prospect_status`

Mark a prospect as contacted, hidden, or reset to new.

Always returns a non-empty confirmation string. An empty result means the tool did not execute — the prospect status was not updated. Args: campaign_id: The campaign the prospect belongs to. profile_id: The prospect's profile ID. status: New status — "new", "contacted", "hidden", or "exported".

Name	Type	Required
campaign_id	string	yes
profile_id	string	yes
status	"new" \| "contacted" \| "hidden" \| "exported"	yes