Skip to main content

EMERGENCY CALLS AROUND THE CLOCK

TAP TO CALL NOW

Johnson Bros. Plumbing & Drain Cleaning

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
  • Discovery: /.well-known/mcp.json · /llms.txt · /api/mcp/manifest
  • Authentication: none required for public information, pricing, quote, service-area, or availability tools. Booking confirmation requires the SMS code sent to the customer; callback and booking requests require explicit user consent. Customer records require a separate verified customer session. Internal tools are hidden from this public endpoint.
  • Contract: API version 1.0.0, facts updated 2026-08-21. Every tool has a complete text fallback when a host cannot render MCP Apps UI.
  • Compatible clients: add the endpoint as a remote, streamable-HTTP MCP connector. ChatGPT and Claude directory availability depends on their separate review and workspace settings; the endpoint itself does not imply directory approval.

Public tools

business_info

Business identity, credentials, hours, payment methods, service area, and booking process.

check_service_area

Checks a Massachusetts ZIP code or town; it does not prove appointment availability.

get_services_pricing

Service catalog, typical duration, current service fee, and non-binding price ranges.

get_quote

Issue-specific, non-binding estimate with an on-site final-pricing disclaimer.

get_availability

Live customer-facing arrival windows and capacity only; it creates no appointment.

request_callback

Creates a consented office callback request; it is not an appointment or emergency dispatch.

request_booking

Creates a pending request and sends a six-digit SMS code; it does not schedule the visit.

confirm_booking

Verifies the SMS code and safely schedules once; callback_pending is not an appointment.

emergency_help

Bounded immediate guidance and telephone handoff; MCP is not monitored emergency dispatch.

search

Finds public Johnson Bros. pages about services, coverage, and policies; returns ids and URLs only.

fetch

Reads the full text of a document id returned by search; public business information only.

These are the complete public version-one tools. Customer-account and internal CRM capabilities are intentionally absent from public tools/list.

Status, support, and changes

  • Production MCP endpoint: published; clients should perform their own connection health check.
  • Public tool contract: version 1.0.0, last updated 2026-08-21.
  • Core workflows support structured data, concise text fallback, and optional MCP Apps cards.
  • Breaking public schema changes require a versioned contract; retired helper tools are not advertised.

See MCP support, privacy, and terms.

Booking flow

  1. get_availability — fetch open arrival windows (optionally check_service_area first).
  2. 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).
  3. confirm_booking with booking_id + the code the customer read back. Only status: confirmed with booked: true means the live appointment exists. callback_pending means the office still needs to schedule it.

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