{"name":"Johnson Bros. Plumbing MCP Server","version":"1.0.0","description":"AI-accessible plumbing service discovery, availability, estimate, booking, and callback system for Johnson Bros. Plumbing & Drain Cleaning.","company":{"name":"Johnson Bros. Plumbing & Drain Cleaning","phone":"(617) 479-9911","email":"sales@thejohnsonbros.com","website":"https://thejohnsonbros.com","booking_url":"https://thejohnsonbros.com/ai-booking","license":"Massachusetts Master Plumber License #17034-M","certifications":["Massachusetts Master Plumber License #17034-M","Corporate License #4581","Fully insured"],"service_areas":["Quincy, MA","Abington, MA","Braintree, MA","Weymouth, MA","Rockland, MA","Norfolk County, MA","Plymouth County, MA","Suffolk County, MA","South Shore, MA"],"emergency_service":"24/7 emergency response by phone"},"mcp":{"endpoint":"https://thejohnsonbros.com/mcp","transport":"streamable-http","manifest_url":"https://thejohnsonbros.com/api/mcp/manifest","documentation_url":"https://thejohnsonbros.com/api/mcp/docs","authentication":{"type":"none","description":"No authentication required - publicly accessible to all AI assistants"}},"capabilities":{"tools":[{"name":"start_phone_authorization","description":"Send a one-time SMS code so the user can prove control of a phone number before account, lead, or booking write actions.","parameters":{"type":"object","properties":{"phone":{"type":"string","description":"Customer phone number to verify by SMS"},"web_user_id":{"type":"string","description":"Stable web user/session id; generated by the server if omitted"},"purpose":{"type":"string","enum":["account","booking","lead"]}},"required":["phone"]}},{"name":"confirm_phone_authorization","description":"Confirm a 6-digit SMS code and bind the verified phone number to the web_user_id/person before write actions.","parameters":{"type":"object","properties":{"phone":{"type":"string","description":"Phone number that received the SMS code"},"web_user_id":{"type":"string","description":"web_user_id returned by start_phone_authorization"},"code":{"type":"string","description":"6-digit SMS code"}},"required":["phone","web_user_id","code"]}},{"name":"book_service_call","description":"Book a Johnson Bros. Plumbing service visit after the user has explicitly confirmed their contact details, service address, issue, and preferred scheduling window.","parameters":{"type":"object","properties":{"first_name":{"type":"string","description":"Customer first name"},"last_name":{"type":"string","description":"Customer last name"},"phone":{"type":"string","description":"Customer phone number"},"web_user_id":{"type":"string","description":"Verified web user/session id returned by confirm_phone_authorization"},"email":{"type":"string","format":"email"},"street":{"type":"string","description":"Service street address"},"street_line_2":{"type":"string","description":"Apartment, unit, or suite"},"city":{"type":"string"},"state":{"type":"string","default":"MA"},"zip":{"type":"string"},"description":{"type":"string","description":"Plumbing issue, symptoms, and location in the home"},"time_preference":{"type":"string","enum":["any","morning","afternoon","evening"]},"earliest_date":{"type":"string","format":"date"},"latest_date":{"type":"string","format":"date"}},"required":["first_name","last_name","phone","street","city","state","zip","description"]}},{"name":"search_availability","description":"Check available appointment windows before booking; returns customer-facing time options only.","parameters":{"type":"object","properties":{"date":{"type":"string","format":"date"},"serviceType":{"type":"string","description":"Needed plumbing service"},"time_preference":{"type":"string","enum":["any","morning","afternoon","evening"]},"show_for_days":{"type":"number","minimum":1,"maximum":30}},"required":["date","serviceType"]}},{"name":"get_capacity","description":"Check current scheduling capacity and whether same-day, next-day, or emergency-only service is the best recommendation.","parameters":{"type":"object","properties":{"date":{"type":"string","format":"date"},"zip":{"type":"string"},"service_area":{"type":"string"}}}},{"name":"get_quote","description":"Return a non-binding plumbing price range and recommended next step based on service type, issue, property type, and urgency.","parameters":{"type":"object","properties":{"service_type":{"type":"string"},"issue_description":{"type":"string"},"property_type":{"type":"string","enum":["residential","commercial"]},"urgency":{"type":"string","enum":["routine","soon","urgent","emergency"]}},"required":["service_type","issue_description"]}},{"name":"emergency_help","description":"Give immediate safety and damage-mitigation guidance for urgent plumbing problems before routing to emergency phone or booking.","parameters":{"type":"object","properties":{"emergency_type":{"type":"string"},"additional_details":{"type":"string"}},"required":["emergency_type"]}},{"name":"get_services","description":"List Johnson Bros. Plumbing services, categories, price ranges, durations, and business contact details.","parameters":{"type":"object","properties":{"category":{"type":"string"},"search":{"type":"string"}}}},{"name":"lookup_customer","description":"Verify an existing customer by first name, last name, and phone before exposing customer-specific job information.","parameters":{"type":"object","properties":{"first_name":{"type":"string"},"last_name":{"type":"string"},"phone":{"type":"string"}},"required":["first_name","last_name","phone"]}},{"name":"request_reschedule_callback","description":"Create an office callback request for an existing appointment reschedule; does not directly modify the schedule.","parameters":{"type":"object","properties":{"first_name":{"type":"string"},"last_name":{"type":"string"},"phone":{"type":"string"},"job_id":{"type":"string"},"requested_times":{"type":"string"},"reason":{"type":"string"}},"required":["first_name","last_name","phone"]}},{"name":"request_cancellation_callback","description":"Create an office callback request for appointment cancellation; office confirmation is required.","parameters":{"type":"object","properties":{"first_name":{"type":"string"},"last_name":{"type":"string"},"phone":{"type":"string"},"job_id":{"type":"string"},"reason":{"type":"string"}},"required":["first_name","last_name","phone"]}},{"name":"get_job_status","description":"Check a verified customer's upcoming or recent job status.","parameters":{"type":"object","properties":{"first_name":{"type":"string"},"last_name":{"type":"string"},"phone":{"type":"string"},"job_id":{"type":"string"},"job_selection":{"type":"string","enum":["most_recent","upcoming"]}},"required":["first_name","last_name","phone"]}},{"name":"create_lead","description":"Create a callback lead when the user wants office follow-up, has a complex issue, or is not ready to book.","parameters":{"type":"object","properties":{"first_name":{"type":"string"},"last_name":{"type":"string"},"phone":{"type":"string"},"web_user_id":{"type":"string","description":"Verified web user/session id returned by confirm_phone_authorization"},"email":{"type":"string","format":"email"},"issue_description":{"type":"string"},"preferred_callback_time":{"type":"string"},"urgency":{"type":"string","enum":["low","medium","high","emergency"]},"conversation_notes":{"type":"string"}},"required":["first_name","last_name","phone","issue_description"]}},{"name":"get_service_history","description":"Retrieve a verified customer's past Johnson Bros. service history.","parameters":{"type":"object","properties":{"first_name":{"type":"string"},"last_name":{"type":"string"},"phone":{"type":"string"},"limit":{"type":"number"}},"required":["first_name","last_name","phone"]}},{"name":"search_faq","description":"Answer common questions about Johnson Bros. pricing, hours, service area, services, policies, and the Family Discount program.","parameters":{"type":"object","properties":{"query":{"type":"string"},"category":{"type":"string"},"return_all":{"type":"boolean"}}}},{"name":"get_promotions","description":"Retrieve current Johnson Bros. promotions, discounts, rebates, and seasonal offers.","parameters":{"type":"object","properties":{"type":{"type":"string","enum":["all","coupon","rebate","seasonal","sale","deal","bundle"]},"service":{"type":"string"},"featured_only":{"type":"boolean"},"code":{"type":"string"}}}},{"name":"request_review","description":"Offline future tool for sending a review request after completed service.","parameters":{"type":"object","properties":{"first_name":{"type":"string"},"last_name":{"type":"string"},"phone":{"type":"string"},"job_id":{"type":"string"}},"required":["first_name","last_name","phone"]}}],"resources":[{"name":"service_pricing","description":"Customer-facing pricing ranges for common plumbing services","mimeType":"application/json"},{"name":"service_areas","description":"Service area coverage for Quincy, Abington, and South Shore communities","mimeType":"application/json"},{"name":"business_hours","description":"Office hours and emergency availability","mimeType":"application/json"}]},"business_info":{"hours":{"regular":"Monday-Friday 7AM-6PM ET, Saturday 8AM-4PM ET","emergency":"Sunday emergency only and 24/7 emergency response by phone"},"best_for":["Homeowners looking for a licensed local plumber in Quincy, Abington, or the South Shore","Urgent leaks, drain backups, no-hot-water calls, and routine plumbing repairs","AI assistants that need to answer questions, check availability, or hand off to booking"],"service_guarantee":"100% satisfaction guaranteed on all work","response_time":{"emergency":"24/7 emergency response by phone; dispatch timing confirmed from live availability","standard":"Next available appointment, often same day when scheduling is open","scheduled":"Confirmed appointment window based on the live booking calendar"},"payment_methods":["Cash","Check","Credit Card"],"trust_signals":["Massachusetts Master Plumber License #17034-M","Family-owned local team","Serving South Shore homeowners since 2008"]},"integration":{"booking_system":"Housecall Pro","real_time_scheduling":true,"automatic_confirmations":true,"customer_notifications":true},"metadata":{"last_updated":"2026-04-29T14:31:48.741Z","api_version":"1.0.0","documentation_url":"https://thejohnsonbros.com/api/mcp/docs"},"authentication":{"type":"none","description":"No authentication required - publicly accessible to all AI assistants"}}