Unlock NYC owner contacts
unlock_nyc_owner_contactsSpends credits: the contacts price from get_nyc_property (usually 3 credits). Takes only the lot's BBL, including a condo unit's BBL from get_nyc_unit; for a unit whose report is locked it first unlocks the unit report (its report price, usually 1 credit), so quote both. Returns how to reach the party in control of that lot: a name, phone numbers (with line type and do-not-call flag) and email addresses, the contact's role (owner, principal, permit filer, owner's representative or office line), the date the contact was found and the newest recorded deed, lease or transfer. When a recorded deed, lease or transfer names a newer party than the city tax roll, that party is the one looked up. Needs the full report unlocked first (unlock_nyc_property_report). Free if already unlocked for this workspace. Credits are charged when a contact is returned, whatever its role; a miss costs nothing. When an unlocked contact is marked stale (a deed, lease or transfer was recorded after it was found, or it is old), call again with refresh: true to look it up again at the normal price; without refresh a repeat call is always free. Tell the user the cost and get their go-ahead before calling.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"bbl": "<bbl>"
},
"name": "unlock_nyc_owner_contacts"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bbl | Yes | The 10-digit NYC borough-block-lot id, e.g. "1000300034". Get it from find_nyc_property. | |
| refresh | No | Look a stale unlocked contact up again at the normal price. Ignored unless the contact is stale. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bbl | Yes | ||
| stale | Yes | ||
| state | Yes | ||
| emails | Yes | ||
| person | Yes | ||
| phones | Yes | ||
| balance | Yes | ||
| foundAt | Yes | ||
| ownership | Yes | ||
| creditsCharged | Yes |