IrreversibleLeadsMCP tool
leads_convert
Convert a lead to a client when they become an active buyer or seller.
Convert a lead to a client when they become an active buyer or seller. Use at the moment a representation agreement is signed or the lead commits to working with you. Returns the new client record linked to the original lead.
Warning
This is IRREVERSIBLE — once a lead is marked converted, the source/timeline data freezes for analytics.
Parameters#
| Parameter | Type | Required | Description |
|---|---|---|---|
lead_id | string | Yes | UUID of the lead to convert · Format: UUID |
client_type | enum | No | Type of client they are becoming · One of: buyer, seller, both |
Example prompts#
- "The Garcias signed a buyer agreement, so convert their lead to a buyer client."
- "Convert Tom Nguyen to a seller client, but confirm with me first since it is irreversible."
Safety#
Irreversible. This action cannot be undone. Claude should always confirm with you before running it.
Previous name#
This tool was previously published as convert_lead_to_client. Call it by its current name — legacy names are kept here for reference and old links redirect, but they are not callable.