Find enrolled home-service and trade businesses by trade and ZIP, and send a booking request.
Score is being calculated.
List the windows a Book It business accepts booking requests for, by date in the business's time zone, after its minimum notice and without its days off, for up to 14 days at a time. Each window has a window_id for request_booking. A window is when the business says it can take work, not a confirmed slot.
| Name | Required | Description | Default |
|---|---|---|---|
| days | No | How many days to show, 1 to 14. Defaults to 7. | |
| from_date | No | First date to show, YYYY-MM-DD, in the business's time zone. Defaults to today there. | |
| business_id | Yes | The business_id exactly as find_provider returned it, such as "juniper-ridge-roofing". |
Find home-service and trade businesses enrolled in Book It that serve a US ZIP code for a trade, such as HVAC, plumbing, roofing or lawn care. Returns each business's name, phone, website, the services that match the stated need, and its next open request window. Only businesses that enrolled and list that ZIP in their own service area appear; the result states the ordering rule, which is a fair daily rotation and never paid placement. An empty list means no enrolled business covers that trade and ZIP yet.
| Name | Required | Description | Default |
|---|---|---|---|
| zip | Yes | The 5-digit US ZIP code where the work is. | |
| need | No | What the person needs in a few words, such as "furnace blowing cold air". Used to surface matching services. | |
| trade | Yes | The trade or a common name for it: "hvac", "furnace repair", "plumber", "roofer", "lawn care", "tree service". |
Get one Book It business's services with any price range the business entered, its service-area ZIPs, its weekly hours for requests, its next open window, and the consent text a person agrees to before a booking request is sent.
| Name | Required | Description | Default |
|---|---|---|---|
| business_id | Yes | The business_id exactly as find_provider returned it, such as "juniper-ridge-roofing". |
Return the price range a Book It business entered for one of its services, labelled as the business's own range and not a quote. When the business entered no range, says so. Book It never estimates, averages or invents a price.
| Name | Required | Description | Default |
|---|---|---|---|
| service | No | Instead of service_id, the service name as the business lists it, such as "Furnace repair". | |
| service_id | No | The service_id from get_services or find_provider. | |
| business_id | Yes | The business_id exactly as find_provider returned it, such as "juniper-ridge-roofing". |
Send a Book It business a booking request on a person's behalf. Collects only the person's name, phone, ZIP, what they need and a preferred time. The business receives it by email and in its inbox and confirms a time with the person directly; the request is never a confirmed appointment. Requires consent_confirmed true, which means the person read and agreed to the business's booking_consent_text (from get_services or check_availability). US and Canadian phone numbers only. A repeat request from the same phone to the same business within 24 hours returns the first request instead of sending another.
| Name | Required | Description | Default |
|---|---|---|---|
| need | Yes | What the person needs, in their words, such as "Furnace runs but blows cold air." | |
| service_id | No | Optional service_id from get_services. | |
| business_id | Yes | The business_id exactly as find_provider returned it, such as "juniper-ridge-roofing". | |
| customer_zip | Yes | The 5-digit ZIP where the work is. It must be in the business's service area. | |
| customer_name | Yes | The person's name, at least a first name. | |
| customer_phone | Yes | A US or Canadian phone number the business can call or text, such as (406) 555-0123. | |
| consent_confirmed | Yes | True only after the person read the business's booking_consent_text and agreed to it. | |
| preferred_time_note | No | A short preferred time in words, such as "any weekday morning", when no window fits. | |
| preferred_window_id | No | A window_id from check_availability, such as "2026-10-15@08:00-12:00". |
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
check_availabilityfind_providerget_servicesquote_rangerequest_bookingFind local service businesses and send requests the owner confirms. Sandbox by default.
Find participating local service providers and book live appointment times.
Book a local business by saying what you need; matching businesses bid and you confirm one.
Find, get quotes from and book local service businesses on their own Square or Google calendar.
Add one secure layer between your agents and this server.