Skip to content
MCP tools
Updates dataProspects (vendor pipeline)MCP tool

prospects_update

Update an existing vendor prospect's information or status.

Update an existing vendor prospect's information or status. Only provided fields are updated - omitted fields remain unchanged. Common uses: status change (identified->researching->outreach->responded->nurturing->converted), update interest level, add notes. Returns the updated prospect record.

Parameters#

ParameterTypeRequiredDescription
prospect_idstringYesUUID of the prospect to update (required). Use prospects_list to find. · Format: UUID
contact_idstringNoUpdated contact ID. Use contacts_list to find. · Format: UUID
vendor_typestringNoUpdated vendor type
titlestringNoUpdated title
sourcestringNoUpdated source
statusenumNoUpdated status · One of: identified, researching, outreach, responded, nurturing, converted, disqualified, lost
interest_levelenumNoUpdated interest level · One of: cold, warm, hot
priorityenumNoUpdated priority · One of: low, medium, high, urgent
estimated_ltvnumberNoUpdated estimated lifetime value · Min: 0
notesstringNoUpdated notes
tagsarray of stringsNoUpdated tags array (replaces existing tags)
care_statusenumNoCare status for tracking. Setting this also updates the audit columns. · One of: no_status, cared, needs_care, didnt_care
care_status_notestringNoNote explaining the care status change.
record_dataobject (free-form)NoPipeline-specific vertical data as a JSON object. Replaces (does not merge with) the existing record_data.

Example prompts#

  • "Mark the Rosa Delgado prospect as responded and bump her to high priority."
  • "Move my Summit Lending prospect to nurturing and note our coffee meeting Tuesday."

Safety#

Updates data. Changes an existing record. The change is visible immediately in the app and can be edited back.