Request a home service
request_home_serviceSubmit a home-service request (a lead, not a booking).
Cleaning, pest control, HVAC, handyman, and other are collecting: the request is passed along when a buyer covers the service, and there is no live buyer yet, so do not promise a callback. Requires name, phone, ZIP, and the person's explicit consent.
For plumbing, the result includes call_to_connect and call_instruction: give the person the number and have them dial it. Never place the call yourself. get_plumbing_call_number does the same without any personal details.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| city | No | ||
| notes | No | What the person needs, in their words. | |
| state | No | 2-letter US state code. | |
| dry_run | No | Validate only; nothing is saved or passed along. | |
| bedrooms | No | ||
| zip_code | Yes | US 5-digit ZIP for the job site. | |
| bathrooms | No | ||
| frequency | No | one_time | |
| home_type | No | ||
| square_feet | No | ||
| address_line | No | ||
| service_type | Yes | Type of local service requested. For plumbing, prefer get_plumbing_call_number. | |
| source_agent | No | Your agent or product name. | mcp |
| customer_name | Yes | Customer's full name. | |
| customer_email | No | ||
| customer_phone | Yes | US phone number for follow-up contact about this request. | |
| flexible_dates | No | ||
| preferred_date | No | Preferred date as YYYY-MM-DD, if any. | |
| consent_to_contact | Yes | Must be true for non-plumbing services: the person agreed to a call or text about this request. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |