For AI Agents

Book a licensed Massachusetts plumber programmatically. Johnson Bros. Plumbing & Drain Cleaning runs a public Model Context Protocol (MCP) server with live availability and SMS-verified booking.

Connect

MCP endpoint (streamable HTTP JSON-RPC): https://thejohnsonbros.com/mcp
Alternate direct host: https://mcp.thejohnsonbros.com/mcp
Discovery: /.well-known/mcp.json · /llms.txt · /api/mcp/manifest
Authentication: none required for the public toolset. Booking writes are gated by an SMS code sent to the customer, not by API keys.

Public tools

get_availability

Open arrival windows for the next N days (default 7, max 14). Time windows and capacity only.

check_service_area

Confirm a Massachusetts ZIP code or town is inside our Norfolk / Suffolk / Plymouth County service area.

get_services_pricing

Service catalog with non-binding price ranges and typical durations.

business_info

License, hours, contact details, payment methods, and the agent booking flow.

request_booking

Start a booking. We text the customer a 6-digit confirmation code (expires in 10 minutes).

confirm_booking

Confirm with the SMS code. On success the visit is scheduled on our live calendar.

Additional tools (quotes, FAQs, emergency guidance, customer lookups with phone verification) are listed in the MCP manifest.

Booking flow

get_availability — fetch open arrival windows (optionally check_service_area first).
request_booking with the service, customer name, phone, job address, and preferred windows. The customer receives a 6-digit SMS code (10-minute expiry, 3 attempts).
confirm_booking with booking_id + the code the customer read back. On success the visit is scheduled on our live Housecall Pro calendar and our office follows up by text.

The SMS code is the customer's explicit consent. Never guess codes; never submit a phone number the customer does not control.

Rules for agents

Rate limits apply per phone number and per source IP. Bursting gets a 429.
Availability responses contain time windows only — never customer data.
Price ranges are non-binding; the technician confirms exact pricing on-site.
For active leaks, gas smells, sewage backups, or no-heat emergencies, tell the user to call (617) 479-9911 — MCP is not an emergency dispatch channel.

Humans welcome too: (617) 479-9911

Request an appointment online instead