Endpoints: 28,729MCP servers: 18,413Payout addresses: 2,071Paid calls: 1,534Letters: 13Defects: 1,322counted 4 min ago
teppi

Server definition

Hash
sha256:3b501616117d6db700d96b0226ec0f8293fe16cf211088db0585130c92e22985
What it is
What a remote MCP server returned when asked what it offers: 16 tools

The blob, as servednamed by its sha256

{ "instructions": "For every AI booking channel (web chat, SMS, voice and MCP), first ask: \"Have you used us before?\" Skip repeating it only if the customer already answered. Immediate gas/CO or other life-safety guidance always comes first.\nBe friendly, knowledgeable and concise. Acknowledge the issue already described, ask one question at a time, and answer the customer's questions before continuing intake. Do not repeat supplied details or an open form's questions. Offer a useful next step without repeatedly pressuring them to book. Information-only questions about services, coverage or pricing do not require contact details or a lead.\nIf returning, next ask for the phone number on their account and permission to send a verification code. Use customer_lookup (or the website's secure returning-customer card). Show no saved information or history before the code is verified. After verification, confirm their saved service address and relevant service history, then ask about the new issue.\nIf new, next show the new_customer_info form on web chat; on SMS/voice collect the same fields conversationally: full name, full service address including ZIP, email, phone, and where they found us. Use submit_customer_info with confirmed:true only after they submit/approve these details. Do not invent missing email or referral source. If the service or symptoms are already known, include the approved details as issue_description in submit_customer_info so an outside-area office lead retains them. Do not re-ask answered questions or delay contact-only intake to invent an issue. Only say the issue description was saved when issue_description_saved is true; in-area booking notes are saved later by request_booking.\nThe server checks the actual service ZIP against the database allowlist for Norfolk, Suffolk and Plymouth counties in Massachusetts. During new-customer intake that coverage check is silent: never say you are checking whether they are in the service area; just continue. When someone asks whether we serve a town (\"do you service Quincy?\"), answer directly with check_service_area using the town alone; do not demand a ZIP first. Ask for the ZIP only if the result is partially_covered or unknown_town. If outside coverage or coverage cannot be verified, say: \"It looks like you may be outside our immediate service area. Call the office directly to see if we can set up an appointment.\" Give the office number from business_info. Route approved new-customer information through submit_customer_info; for a Massachusetts address its outside-area lead already requests an office callback (office_callback_requested:true). For anyone else found outside the area, offer an office callback and, once they agree, use request_out_of_area_callback with their name, phone, address and issue: in Massachusetts the office will call them back soon, and they are also welcome to call the office themselves. Outside Massachusetts, politely explain that we only serve Massachusetts. Do not create another lead if intake already saved one. Never offer/book an appointment for that request. Only a persisted lead result allows saying the lead was submitted.\nFor an eligible request, establish the issue and ask one or two useful follow-up questions only for missing technician notes, such as the affected fixture and when the problem started. Keep reported symptoms separate from a diagnosis and include the approved details in the booking issue_description. Obtain live availability, confirm the selected window and details, then request_booking with customer_type new/returning and the new customer's email and heard_about_us. Ask for the booking SMS code and call confirm_booking. Keep lookup verification and booking codes separate. Only status:confirmed with booked:true means an appointment exists. Callback/lead status means office review only.\nFor several separate repair issues, appointment cancellations or changes, or no suitable live window, direct the customer to the office at (617) 479-9911. Offer a callback only with approval; do not create separate jobs or claim a cancellation or reschedule succeeded. Emergency phone response is available around the clock; routine availability must come from get_availability.\nUse business_info for the current service fee and policy: diagnosis and an estimate, fee waived if the repair is approved, fee due if declined. Tool-returned price ranges are non-binding, never a guaranteed repair price. Do not provide DIY repair instructions or recommend chemical drain cleaners; immediate safety guidance still comes first.\nIf reviews come up after completed service, invite honest feedback regardless of sentiment. Do not ask for a review of a visit that has only been booked. End with the actual tool-confirmed outcome and the next step, not a claim that a pending request is complete.\nUse open_customer_portal for inline booking or service-history forms. For private history, use customer_lookup to send and verify the customer's SMS code and read only the verified history returned. search_service_history requires private proof attached by the customer card or browser bridge; a shared MCP session alone does not authorize history access. Never request, expose or invent a portal token or history_access_token. Start with business_info for Johnson Bros. business facts and the MCP workflow. The agent_context field contains the complete business briefing; fetch about:agent-briefing is an alternate reading format. You do not need to browse the website: use search and then fetch for full service, FAQ, and article text inside MCP. Returned URLs are citations, not required browsing steps. Use check_service_area for exact coverage; it answers a town name on its own, so answer \"do you serve <town>?\" directly. For a caller outside the automatic-booking area who agrees to a call from the office, use request_out_of_area_callback (Massachusetts addresses only; it never books). get_services_pricing or get_quote for non-binding pricing, and get_availability for live appointment windows. Business information is not live availability. Execute the appropriate tool before claiming you checked records, sent a code, requested a callback, or booked a visit. Only status:confirmed and booked:true proves a booking. Public knowledge tools never provide private customer history; use only authorized identity-verified customer tools when available. If information is absent, say it is unknown and offer an office follow-up; do not invent it.", "tools": [ { "description": "Start here for a self-contained Johnson Bros. business briefing: locations, services, hours, service area, dispatch fee, pricing and booking policies, credentials, payment methods, and how to get further information through MCP without browsing the website. Not live availability or private customer records.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": {}, "type": "object" }, "name": "business_info", "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "agent_context": { "additionalProperties": false, "properties": { "availability": { "additionalProperties": false, "properties": { "creates_appointment": { "type": "boolean" }, "kind": { "type": "string" }, "tool": { "type": "string" } }, "required": [ "tool", "kind", "creates_appointment" ], "type": "object" }, "customer_records": { "type": "string" }, "instructions": { "type": "string" }, "knowledge": { "additionalProperties": false, "properties": { "instructions": { "type": "string" }, "missing_information": { "type": "string" }, "read_tool": { "type": "string" }, "search_tool": { "type": "string" } }, "required": [ "search_tool", "read_tool", "instructions", "missing_information" ], "type": "object" }, "locations": { "items": { "additionalProperties": false, "properties": { "city": { "type": "string" }, "name": { "type": "string" }, "state": { "type": "string" }, "street": { "type": "string" }, "zip": { "type": "string" } }, "required": [ "name", "street", "city", "state", "zip" ], "type": "object" }, "type": "array" }, "pricing": { "additionalProperties": false, "properties": { "currency": { "type": "string" }, "dispatch_fee": { "type": "number" }, "estimates": { "type": "string" }, "policy": { "type": "string" } }, "required": [ "currency", "dispatch_fee", "policy", "estimates" ], "type": "object" }, "scheduling": { "additionalProperties": false, "properties": { "after_hours": { "type": "string" }, "emergency": { "type": "string" }, "regular": { "type": "string" }, "routine": { "type": "string" } }, "required": [ "regular", "after_hours", "routine", "emergency" ], "type": "object" }, "service_area": { "additionalProperties": false, "properties": { "exact_coverage_tool": { "type": "string" }, "summary": { "type": "string" }, "towns": { "items": { "type": "string" }, "type": "array" } }, "required": [ "summary", "towns", "exact_coverage_tool" ], "type": "object" }, "services": { "items": { "additionalProperties": false, "properties": { "name": { "type": "string" }, "summary": { "type": "string" } }, "required": [ "name", "summary" ], "type": "object" }, "type": "array" }, "timezone": { "type": "string" }, "writes": { "additionalProperties": false, "properties": { "confirm_booking": { "additionalProperties": false, "properties": { "requires_sms_code": { "type": "boolean" }, "success_requires": { "additionalProperties": false, "properties": { "booked": { "type": "boolean" }, "status": { "type": "string" } }, "required": [ "status", "booked" ], "type": "object" } }, "required": [ "requires_sms_code", "success_requires" ], "type": "object" }, "request_booking": { "additionalProperties": false, "properties": { "creates_appointment": { "type": "boolean" }, "requires_explicit_user_consent": { "type": "boolean" }, "sends_sms_code": { "type": "boolean" } }, "required": [ "requires_explicit_user_consent", "sends_sms_code", "creates_appointment" ], "type": "object" }, "request_callback": { "additionalProperties": false, "properties": { "creates_appointment": { "type": "boolean" }, "requires_explicit_user_consent": { "type": "boolean" } }, "required": [ "requires_explicit_user_consent", "creates_appointment" ], "type": "object" } }, "required": [ "request_callback", "request_booking", "confirm_booking" ], "type": "object" } }, "required": [ "instructions", "timezone", "locations", "services", "service_area", "pricing", "scheduling", "knowledge", "availability", "writes", "customer_records" ], "type": "object" }, "booking": { "additionalProperties": false, "properties": { "how_agents_book": { "type": "string" }, "online_booking": { "type": "string" }, "phone_booking": { "type": "string" } }, "required": [ "how_agents_book", "phone_booking", "online_booking" ], "type": "object" }, "business": { "additionalProperties": false, "properties": { "certifications": { "items": { "type": "string" }, "type": "array" }, "email": { "type": "string" }, "emergency": { "type": "string" }, "legal_name": { "type": "string" }, "license": { "type": "string" }, "name": { "type": "string" }, "payment_methods": { "items": { "type": "string" }, "type": "array" }, "phone": { "type": "string" }, "service_area": { "type": "string" }, "services_not_offered": { "items": { "type": "string" }, "type": "array" }, "website": { "type": "string" } }, "required": [ "name", "legal_name", "phone", "email", "website", "license", "certifications", "payment_methods", "emergency", "service_area", "services_not_offered" ], "type": "object" }, "facts_updated": { "type": "string" }, "hours": { "additionalProperties": false, "properties": { "office": { "items": { "additionalProperties": false, "properties": { "closes": { "type": "string" }, "days": { "type": "string" }, "note": { "type": "string" }, "opens": { "type": "string" } }, "required": [ "days", "opens", "closes" ], "type": "object" }, "type": "array" }, "sunday": { "type": "string" } }, "required": [ "office", "sunday" ], "type": "object" }, "review_sandbox": { "type": "boolean" }, "success": { "type": "boolean" } }, "required": [ "success", "business", "hours", "booking" ], "type": "object" } }, { "description": "Check a service ZIP, or a Massachusetts town, city or neighborhood name on its own, against the coverage database for Norfolk, Suffolk and Plymouth counties. Answer \"do you serve <town>?\" directly with town (no ZIP needed): covered = yes; partially_covered = yes for the listed covered_zips, confirm the customer's ZIP only then; outside_service_area = not in the automatic-booking area (offer request_out_of_area_callback and the office number); unknown_town = ask for the ZIP. During new-customer intake run this check silently; never announce that you are checking the service area. Unavailable coverage is unknown, not outside-area. This never proves that a particular appointment is available.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "state": { "maxLength": 2, "minLength": 2, "type": "string" }, "town": { "maxLength": 60, "minLength": 2, "type": "string" }, "zip": { "maxLength": 10, "minLength": 3, "type": "string" } }, "type": "object" }, "name": "check_service_area", "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "counties": { "items": { "type": "string" }, "type": "array" }, "covered_zips": { "description": "Town lookups only: the town ZIPs inside the automatic-booking area.", "items": { "type": "string" }, "type": "array" }, "error": { "type": "string" }, "error_code": { "type": "string" }, "in_service_area": { "type": "boolean" }, "matched_by": { "anyOf": [ { "enum": [ "zip", "town" ], "type": "string" }, { "type": "null" } ] }, "message": { "type": "string" }, "missing_fields": { "items": { "type": "string" }, "type": "array" }, "next_step": { "type": "string" }, "outside_zips": { "description": "Town lookups only: the town ZIPs outside the automatic-booking area.", "items": { "type": "string" }, "type": "array" }, "resolved_town": { "description": "Town lookups only: the Massachusetts place the name was matched to.", "type": "string" }, "review_sandbox": { "type": "boolean" }, "status": { "enum": [ "covered", "partially_covered", "outside_service_area", "unknown_town", "needs_more_information", "unavailable" ], "type": "string" }, "success": { "type": "boolean" }, "town": { "type": "string" }, "zip": { "type": "string" } }, "required": [ "success" ], "type": "object" } }, { "description": "Use this after the customer supplies the six-digit SMS code from request_booking. It can create customer and job records or an office-review lead, notify the office, and send transactional customer or referral-status texts. Only status:confirmed with booked:true means the visit is scheduled. status:callback_pending with booked:false means the office must follow up and must never be described as an appointment. Replaying the same valid confirmation is safe and returns the stored result.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "booking_id": { "format": "uuid", "type": "string" }, "code": { "pattern": "^\\d{6}$", "type": "string" } }, "required": [ "booking_id", "code" ], "type": "object" }, "name": "confirm_booking", "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "attempts_remaining": { "type": "integer" }, "booked": { "type": "boolean" }, "business_phone": { "type": "string" }, "business_phone_href": { "type": "string" }, "confirmation_number": { "type": "string" }, "customer_name": { "type": "string" }, "error_code": { "type": "string" }, "formatted_arrival_window": { "type": "string" }, "location_summary": { "type": "string" }, "message": { "type": "string" }, "needs_manual": { "type": "boolean" }, "next_step": { "type": "string" }, "replayed": { "type": "boolean" }, "review_sandbox": { "type": "boolean" }, "scheduled_end": { "type": "string" }, "scheduled_start": { "type": "string" }, "service_city": { "type": "string" }, "service_description": { "type": "string" }, "status": { "enum": [ "confirmed", "callback_pending", "rejected" ], "type": "string" }, "success": { "type": "boolean" }, "timezone": { "type": "string" } }, "required": [ "success", "status", "booked", "needs_manual", "business_phone", "business_phone_href", "message", "next_step" ], "type": "object" } }, { "description": "For a returning customer: first call with phone and confirmed:true to request a code. Next call with the returned challenge_id and customer-supplied code. Saved details and recent service history are returned only after successful verification. If lookup fails, offer the new-customer form or office assistance. Never claim a match from the initial response.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "challenge_id": { "format": "uuid", "type": "string" }, "code": { "pattern": "^\\d{6}$", "type": "string" }, "confirmed": { "const": true, "type": "boolean" }, "phone": { "minLength": 7, "type": "string" } }, "required": [ "phone", "confirmed" ], "type": "object" }, "name": "customer_lookup", "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "challenge_id": { "type": "string" }, "customer": { "additionalProperties": false, "properties": { "addresses": { "items": { "additionalProperties": false, "properties": { "city": { "type": "string" }, "country": { "type": "string" }, "state": { "type": "string" }, "street": { "type": "string" }, "street_line_2": { "type": "string" }, "zip": { "type": "string" } }, "type": "object" }, "type": "array" }, "email": { "type": "string" }, "firstName": { "type": "string" }, "lastName": { "type": "string" }, "phone": { "type": "string" } }, "required": [ "phone", "addresses" ], "type": "object" }, "history": { "items": { "additionalProperties": false, "properties": { "description": { "type": "string" }, "scheduledStart": { "type": "string" }, "workStatus": { "type": "string" } }, "required": [ "description", "workStatus" ], "type": "object" }, "type": "array" }, "history_status": { "enum": [ "available", "unavailable" ], "type": "string" }, "message": { "type": "string" }, "next_step": { "type": "string" }, "record_id": { "description": "Saved office lead reference, when applicable.", "type": "string" }, "request_id": { "description": "Public operation receipt for support; never a provider customer ID.", "format": "uuid", "type": "string" }, "review_sandbox": { "type": "boolean" }, "status": { "enum": [ "verification_requested", "verified" ], "type": "string" }, "success": { "type": "boolean" } }, "required": [ "request_id", "next_step", "success", "status", "message" ], "type": "object" } }, { "description": "Use this immediately when the user describes an urgent plumbing safety or damage situation. Give bounded mitigation guidance and direct them to call Johnson Bros.; for gas, fire, or immediate danger, direct them to leave and call 911 first. Do not treat this tool as monitored emergency dispatch or create an online emergency appointment.\n\nWHEN TO USE: Immediately when a customer mentions an emergency situation like:\n- Burst pipe, flooding, or water damage\n- Gas smell or suspected gas leak (CRITICAL - may need to call 911)\n- Sewage backup or overflow\n- No water or sudden loss of water\n- Water heater leaking or not working\n\nPRIORITY ORDER:\n1. First ensure customer safety (especially for gas leaks)\n2. Provide immediate mitigation steps (how to shut off water, etc.)\n3. Then tell the user to call Johnson Bros. for emergency service\n\nRETURNS: Step-by-step immediate actions, safety warnings, things NOT to do, urgency level, and whether emergency dispatch is recommended.\n\nIMPORTANT: For gas leaks, always advise leaving the house and calling 911 first.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "additional_details": { "description": "Additional context about the emergency (optional). Include location, duration, actions already taken.", "type": "string" }, "emergency_type": { "description": "Type of plumbing emergency (required). Examples: 'burst pipe', 'flooding', 'gas leak', 'sewage backup', 'no hot water', 'no water'", "type": "string" } }, "required": [ "emergency_type" ], "type": "object" }, "name": "emergency_help", "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "call_now": { "type": "string" }, "emergency_contact": { "additionalProperties": false, "properties": { "available": { "type": "string" }, "phone": { "type": "string" }, "response_time": { "type": "string" } }, "required": [ "phone", "available", "response_time" ], "type": "object" }, "emergency_type": { "type": "string" }, "error": { "type": "string" }, "immediate_steps": { "items": { "type": "string" }, "type": "array" }, "recommendation": { "type": "string" }, "review_sandbox": { "type": "boolean" }, "safety_warnings": { "items": { "type": "string" }, "type": "array" }, "success": { "type": "boolean" }, "urgency_level": { "type": "string" } }, "required": [ "success" ], "type": "object" } }, { "description": "Use this to read the full text of a document returned by search. Takes the exact id from a search result. Returns public business information only -- it never returns customer records.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "id": { "description": "Document id from a search result, e.g. 'faq:pricing-service-fee'", "minLength": 1, "type": "string" } }, "required": [ "id" ], "type": "object" }, "name": "fetch", "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "error": { "type": "string" }, "error_code": { "type": "string" }, "id": { "type": "string" }, "metadata": { "additionalProperties": { "type": "string" }, "type": "object" }, "success": { "type": "boolean" }, "text": { "type": "string" }, "title": { "type": "string" }, "url": { "type": "string" } }, "required": [ "success" ], "type": "object" } }, { "description": "Use this when the user wants live Johnson Bros. appointment availability. Include zip and any known town/state for a customer booking inquiry. Outside-area or unresolved locations receive no windows. Without a location, this returns general capacity only, not eligibility to book; coverage_status is not_checked. Never call for a customer already found outside coverage. Do not promise or create an appointment; use request_booking and confirm_booking.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "days": { "default": 7, "maximum": 14, "minimum": 1, "type": "integer" }, "start_date": { "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" }, "state": { "maxLength": 2, "minLength": 2, "type": "string" }, "time_preference": { "default": "any", "enum": [ "any", "morning", "afternoon", "evening" ], "type": "string" }, "town": { "maxLength": 60, "minLength": 2, "type": "string" }, "zip": { "description": "Service ZIP when known. Always include the customer location for a booking inquiry; outside-area requests receive no windows.", "maxLength": 10, "minLength": 3, "type": "string" } }, "type": "object" }, "name": "get_availability", "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "booking_flow": { "type": "string" }, "coverage_status": { "enum": [ "verified", "not_checked", "outside_service_area", "unknown" ], "type": "string" }, "error_code": { "type": "string" }, "has_more": { "type": "boolean" }, "missing_fields": { "items": { "type": "string" }, "type": "array" }, "next_step": { "type": "string" }, "open_windows": { "type": "integer" }, "privacy": { "type": "string" }, "requested_days": { "type": "integer" }, "returned_windows": { "type": "integer" }, "review_sandbox": { "type": "boolean" }, "status": { "enum": [ "available", "needs_more_information", "outside_service_area", "unavailable" ], "type": "string" }, "success": { "type": "boolean" }, "time_preference": { "enum": [ "any", "morning", "afternoon", "evening" ], "type": "string" }, "timezone": { "type": "string" }, "total_matching_windows": { "type": "integer" }, "total_windows": { "type": "integer" }, "windows": { "items": { "additionalProperties": false, "properties": { "arrival_end": { "description": "Customer-facing two-hour arrival promise.", "type": "string" }, "arrival_start": { "type": "string" }, "available": { "type": "boolean" }, "end_local": { "type": "string" }, "end_time": { "description": "Reserved three-hour job-block end; pass unchanged to request_booking.", "type": "string" }, "part_of_day": { "enum": [ "morning", "afternoon", "evening" ], "type": "string" }, "start_local": { "type": "string" }, "start_time": { "description": "Selected job-block start; pass unchanged to request_booking.", "type": "string" } }, "required": [ "start_time", "end_time", "arrival_start", "arrival_end", "start_local", "end_local", "part_of_day", "available" ], "type": "object" }, "type": "array" } }, "required": [ "success", "timezone", "requested_days", "time_preference", "total_windows", "open_windows", "windows", "booking_flow", "privacy" ], "type": "object" } }, { "description": "Use this when the user wants a non-binding estimate for a specific plumbing issue. Returns a price range, typical duration, and next step. Do not present the range as a guaranteed repair price; final pricing is confirmed on-site before work begins.\n\nWHEN TO USE: When a customer asks \"How much does it cost?\", \"What's the price?\", or wants to know pricing before booking. Use this early in the conversation to set expectations.\n\nPRICING NOTES:\n- Estimates are ranges; final price depends on on-site assessment\n- Do not invent urgency, after-hours, or commercial surcharges\n- The office or technician confirms any timing- or property-related pricing before work\n- The $99 service fee covers sending a technician out to diagnose the problem and give you an estimate before repair work starts. If you approve the repair, we waive the service fee and you pay only the price the technician quoted. If you decline the repair, the $99 service fee is due.\n\nWORKFLOW:\n1. Use this tool when customer asks about pricing\n2. Share the estimate with appropriate caveats\n3. If they want to proceed, use get_availability, request_booking, and confirm_booking\n\nRETURNS: Service name, price range (min/max in USD), estimated duration, urgency notes, and suggested next steps.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "issue_description": { "description": "Description of the plumbing problem (required). Be specific about symptoms and location.", "type": "string" }, "property_type": { "description": "Type of property (default: 'residential')", "enum": [ "residential", "commercial" ], "type": "string" }, "service_type": { "description": "Type of plumbing service (required). Examples: 'drain cleaning', 'water heater repair', 'toilet repair'", "type": "string" }, "urgency": { "description": "How urgent is the repair?", "enum": [ "routine", "soon", "urgent", "emergency" ], "type": "string" } }, "required": [ "service_type", "issue_description" ], "type": "object" }, "name": "get_quote", "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "description": { "type": "string" }, "error": { "type": "string" }, "error_code": { "type": "string" }, "estimated_duration": { "type": "string" }, "estimated_price_range": { "additionalProperties": false, "properties": { "currency": { "type": "string" }, "max": { "type": "number" }, "min": { "type": "number" } }, "required": [ "min", "max", "currency" ], "type": "object" }, "next_step": { "type": "string" }, "next_steps": { "type": "string" }, "notes": { "items": { "type": "string" }, "type": "array" }, "property_type": { "type": "string" }, "review_sandbox": { "type": "boolean" }, "service": { "type": "string" }, "service_fee": { "type": "string" }, "service_supported": { "type": "boolean" }, "success": { "type": "boolean" }, "urgency_level": { "type": "string" } }, "required": [ "success" ], "type": "object" } }, { "description": "Use this when the user wants to browse Johnson Bros. services or general non-binding price ranges. Do not use it for an issue-specific estimate; use get_quote. Final pricing is confirmed on-site before work begins.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "category": { "description": "Filter by category: 'emergency', 'maintenance', 'repair', 'installation', 'specialty'", "type": "string" }, "search": { "description": "Search term, e.g. \"water heater\", \"drain\"", "type": "string" } }, "type": "object" }, "name": "get_services_pricing", "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "categories": { "items": { "type": "string" }, "type": "array" }, "error": { "type": "string" }, "error_code": { "type": "string" }, "next_step": { "type": "string" }, "pricing_disclaimer": { "type": "string" }, "review_sandbox": { "type": "boolean" }, "service_fee": { "type": "string" }, "service_supported": { "type": "boolean" }, "services": { "items": { "additionalProperties": false, "properties": { "category": { "type": "string" }, "description": { "type": "string" }, "estimated_duration": { "type": "string" }, "id": { "type": "string" }, "is_emergency": { "type": "boolean" }, "name": { "type": "string" }, "price_max": { "type": "number" }, "price_min": { "type": "number" }, "price_range": { "type": "string" } }, "required": [ "id", "name", "description", "price_range", "price_min", "price_max", "estimated_duration", "is_emergency" ], "type": "object" }, "type": "array" }, "success": { "type": "boolean" }, "total_services": { "type": "integer" } }, "required": [ "success", "total_services", "services", "categories", "pricing_disclaimer", "service_fee" ], "type": "object" } }, { "description": "Use this when the customer wants to book Johnson Bros. service or search their own past visits. Opens a compact card that expands into a customer form without sending a message or creating a booking. History requires SMS verification and the customer card’s private, short-lived proof. Booking requires reviewing details and the customer-supplied SMS code.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "view": { "default": "booking", "description": "Choose booking for a new service visit, or history for the customer’s own previous and upcoming visits.", "enum": [ "booking", "history" ], "type": "string" } }, "type": "object" }, "name": "open_customer_portal", "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "business_phone": { "type": "string" }, "message": { "type": "string" }, "review_sandbox": { "type": "boolean" }, "success": { "const": true, "type": "boolean" }, "view": { "enum": [ "booking", "history" ], "type": "string" } }, "required": [ "success", "view", "business_phone", "message" ], "type": "object" } }, { "description": "Use this only after the user explicitly asks to start a Johnson Bros. booking and confirms their own contact details, service address, issue, and preferred windows. It sends a six-digit SMS code and does not schedule a visit. Do not claim an appointment exists until confirm_booking returns status:confirmed and booked:true.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "address": { "additionalProperties": false, "properties": { "city": { "minLength": 2, "type": "string" }, "state": { "default": "MA", "maxLength": 2, "minLength": 2, "type": "string" }, "street": { "minLength": 3, "type": "string" }, "unit": { "type": "string" }, "zip": { "minLength": 5, "type": "string" } }, "required": [ "street", "city", "zip" ], "type": "object" }, "confirmed": { "const": true, "description": "True only after the user explicitly asks to start this booking request and send the SMS code", "type": "boolean" }, "customer_type": { "description": "Required for booking: answer to Have you used us before?", "enum": [ "new", "returning" ], "type": "string" }, "email": { "format": "email", "type": "string" }, "heard_about_us": { "description": "Required for new customers: where they found us", "maxLength": 200, "minLength": 1, "type": "string" }, "name": { "description": "Customer full name", "maxLength": 120, "minLength": 2, "type": "string" }, "notes": { "description": "Issue description / anything the technician should know", "maxLength": 2000, "type": "string" }, "phone": { "description": "Customer mobile number — receives the 6-digit confirmation code", "minLength": 7, "type": "string" }, "preferred_windows": { "default": [], "description": "Preferred arrival windows from get_availability (start_time/end_time ISO strings)", "items": { "additionalProperties": false, "properties": { "end_time": { "type": "string" }, "start_time": { "type": "string" } }, "required": [ "start_time", "end_time" ], "type": "object" }, "maxItems": 5, "type": "array" }, "promotion_review_requested": { "default": false, "type": "boolean" }, "referral_code": { "maxLength": 300, "type": "string" }, "service": { "description": "Requested service, e.g. \"water heater replacement\"", "maxLength": 200, "minLength": 3, "type": "string" }, "time_preference": { "default": "any", "description": "Fallback time-of-day preference if none of the preferred windows is open", "enum": [ "any", "morning", "afternoon", "evening" ], "type": "string" } }, "required": [ "service", "name", "phone", "address", "confirmed" ], "type": "object" }, "name": "request_booking", "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "attempts_allowed": { "type": "integer" }, "booking_id": { "type": "string" }, "code_sent_to": { "type": "string" }, "error": { "type": "string" }, "error_code": { "type": "string" }, "expires_at": { "type": "string" }, "in_service_area": { "type": "boolean" }, "next_step": { "type": "string" }, "review_sandbox": { "type": "boolean" }, "sandbox_verification_code": { "type": "string" }, "service_area_notice": { "type": "string" }, "status": { "enum": [ "pending_sms_confirmation", "rejected" ], "type": "string" }, "success": { "type": "boolean" } }, "required": [ "success", "status", "next_step" ], "type": "object" } }, { "description": "Use this only after the user explicitly asks Johnson Bros. to call them about a plumbing need and provides their own contact details. This creates a callback lead, not an appointment, and can notify the office and send a transactional SMS acknowledgment. Do not use it for emergency dispatch; tell emergency users to call (617) 479-9911.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "confirmed": { "const": true, "description": "True only after the user explicitly asks Johnson Bros. to contact them", "type": "boolean" }, "email": { "format": "email", "type": "string" }, "issue_description": { "description": "Short description of the plumbing issue", "maxLength": 2000, "minLength": 3, "type": "string" }, "name": { "description": "Customer full name, for example \"Jane Smith\"", "maxLength": 120, "minLength": 2, "type": "string" }, "phone": { "description": "Customer phone number for the callback", "minLength": 7, "type": "string" }, "preferred_callback_time": { "description": "Optional preference such as \"weekday morning\"", "maxLength": 200, "type": "string" }, "urgency": { "default": "routine", "enum": [ "routine", "soon", "urgent" ], "type": "string" } }, "required": [ "name", "phone", "issue_description", "confirmed" ], "type": "object" }, "name": "request_callback", "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "error_code": { "type": "string" }, "message": { "type": "string" }, "next_step": { "type": "string" }, "phone_last4": { "type": "string" }, "record_id": { "type": "string" }, "request_id": { "format": "uuid", "type": "string" }, "review_sandbox": { "type": "boolean" }, "status": { "enum": [ "callback_requested", "rejected" ], "type": "string" }, "success": { "type": "boolean" } }, "required": [ "request_id", "success", "status", "message", "next_step" ], "type": "object" } }, { "description": "Use as soon as a caller is found to be outside the automatic-booking service area and agrees to a call from the office. Requires name, phone, city, state, service ZIP, issue_description and confirmed:true. The server rechecks coverage: in_service_area means continue normal booking (no callback is created). For a Massachusetts address it flags the office to call back ASAP (status office_callback_requested); tell the caller the office will call them soon and that they are also welcome to call (617) 479-9911. Outside Massachusetts returns outside_massachusetts and creates nothing. It never books an appointment. Retries within 30 minutes return the same request (duplicate:true).", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "address": { "additionalProperties": false, "properties": { "city": { "maxLength": 60, "minLength": 2, "type": "string" }, "state": { "maxLength": 2, "minLength": 2, "type": "string" }, "street": { "description": "Street address, if the caller gave it", "maxLength": 200, "minLength": 3, "type": "string" }, "unit": { "maxLength": 50, "type": "string" }, "zip": { "description": "Five-digit service ZIP; decides coverage and Massachusetts", "pattern": "^\\d{5}(?:-\\d{4})?$", "type": "string" } }, "required": [ "city", "state", "zip" ], "type": "object" }, "confirmed": { "const": true, "description": "True only after the caller agreed to the office calling them back", "type": "boolean" }, "issue_description": { "description": "What the caller needs, in their words", "maxLength": 4000, "minLength": 3, "type": "string" }, "name": { "description": "Caller full first and last name", "maxLength": 120, "minLength": 3, "type": "string" }, "phone": { "description": "Callback number. On phone calls the channel supplies the caller ID; confirm it with the caller.", "maxLength": 30, "minLength": 7, "type": "string" } }, "required": [ "name", "phone", "address", "issue_description", "confirmed" ], "type": "object" }, "name": "request_out_of_area_callback", "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "booked": { "const": false, "type": "boolean" }, "coverage_verified": { "description": "False when the coverage database could not be read; the office will confirm.", "type": "boolean" }, "duplicate": { "description": "True when this callback was already requested recently; no second office task was created.", "type": "boolean" }, "error_code": { "type": "string" }, "in_massachusetts": { "type": "boolean" }, "in_service_area": { "type": "boolean" }, "message": { "type": "string" }, "next_step": { "type": "string" }, "record_id": { "description": "Saved office lead reference, when a callback was requested.", "type": "string" }, "request_id": { "description": "Public operation receipt for support; never a provider customer ID.", "format": "uuid", "type": "string" }, "review_sandbox": { "type": "boolean" }, "status": { "enum": [ "office_callback_requested", "in_service_area", "outside_massachusetts", "rejected" ], "type": "string" }, "success": { "type": "boolean" } }, "required": [ "request_id", "success", "status", "in_service_area", "booked", "message", "next_step" ], "type": "object" } }, { "description": "Use this to find Johnson Bros. Plumbing pages about services, service area, pricing policy, or common questions. Returns ids, titles and URLs only -- call fetch with an id to read the full text. Do not use it to check live appointment availability (use get_availability) or to look up a customer.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "query": { "description": "Natural-language search terms, e.g. 'water heater Quincy'", "minLength": 1, "type": "string" } }, "required": [ "query" ], "type": "object" }, "name": "search", "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "results": { "items": { "additionalProperties": false, "properties": { "id": { "description": "Pass this to fetch to read the full document", "type": "string" }, "title": { "type": "string" }, "url": { "type": "string" } }, "required": [ "id", "title", "url" ], "type": "object" }, "type": "array" }, "success": { "type": "boolean" } }, "required": [ "success", "results" ], "type": "object" } }, { "description": "Use this from the customer card or browser bridge after customer_lookup verifies SMS and supplies private proof. Shared agents must use the history returned by customer_lookup or open the customer portal; an MCP connection alone never authorizes history. Searches the authenticated account records available from the customer portal by repair keywords, date text, and status. No customer IDs or portal bearer tokens are accepted. If verification expires, use customer_lookup again. Results cover only the records loaded by the portal, not a guaranteed lifetime archive.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "history_access_token": { "description": "Private verification proof attached automatically by the customer card or browser bridge. Never ask the customer for it or invent it.", "maxLength": 200, "type": "string" }, "limit": { "default": 20, "description": "Maximum records to return, from 1 to 50.", "maximum": 50, "minimum": 1, "type": "integer" }, "query": { "default": "", "description": "Repair keywords or date text, for example drain or 2025. Empty searches all available records.", "maxLength": 200, "type": "string" }, "status": { "default": "all", "description": "Filter the verified customer’s available visits by status.", "enum": [ "all", "completed", "upcoming" ], "type": "string" } }, "type": "object" }, "name": "search_service_history", "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "history": { "items": { "additionalProperties": false, "properties": { "description": { "type": "string" }, "scheduledStart": { "type": "string" }, "workStatus": { "type": "string" } }, "required": [ "description", "workStatus" ], "type": "object" }, "type": "array" }, "message": { "type": "string" }, "records_searched": { "type": "integer" }, "returned_records": { "type": "integer" }, "review_sandbox": { "type": "boolean" }, "success": { "const": true, "type": "boolean" } }, "required": [ "success", "history", "records_searched", "returned_records", "message" ], "type": "object" } }, { "description": "After asking Have you used us before?, use for NEW customers only after they approve full name, address, email, phone and where they found us. Include the customer-approved issue_description when the service or symptoms are already known. Saves an in-area customer; outside database coverage saves a lead with the supplied description for office review and never books a job. For a Massachusetts address outside the area that lead is also flagged for an ASAP office callback (office_callback_requested:true), so do not call request_out_of_area_callback afterwards. Say the description was saved only when issue_description_saved is true; in-area booking notes are saved later with request_booking. Lead submissions can notify the office and send a transactional SMS acknowledgment; they do not authorize marketing texts.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "address": { "additionalProperties": false, "properties": { "city": { "minLength": 2, "type": "string" }, "state": { "maxLength": 2, "minLength": 2, "type": "string" }, "street": { "minLength": 3, "type": "string" }, "unit": { "type": "string" }, "zip": { "pattern": "^\\d{5}(?:-\\d{4})?$", "type": "string" } }, "required": [ "street", "city", "state", "zip" ], "type": "object" }, "confirmed": { "const": true, "description": "Customer submitted or approved the new customer form, including any supplied issue description", "type": "boolean" }, "email": { "format": "email", "type": "string" }, "heard_about_us": { "description": "Where the customer found Johnson Bros; ask, never infer from the platform", "maxLength": 200, "minLength": 1, "type": "string" }, "issue_description": { "description": "Customer-approved service and reported symptoms, if already provided. Preserved in outside-area office lead notes; do not invent a diagnosis. Optional so contact-only intake still works.", "maxLength": 4000, "type": "string" }, "name": { "description": "Full first and last name", "maxLength": 120, "minLength": 3, "type": "string" }, "phone": { "maxLength": 30, "minLength": 7, "type": "string" } }, "required": [ "name", "phone", "email", "address", "heard_about_us", "confirmed" ], "type": "object" }, "name": "submit_customer_info", "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "booked": { "const": false, "type": "boolean" }, "error_code": { "type": "string" }, "in_massachusetts": { "description": "Outside-area leads only: whether the service ZIP is in Massachusetts.", "type": "boolean" }, "in_service_area": { "type": "boolean" }, "issue_description_saved": { "description": "True only after a supplied issue description was saved with an office-review lead. Customer creation alone does not save booking notes.", "type": "boolean" }, "message": { "type": "string" }, "next_step": { "type": "string" }, "office_callback_requested": { "description": "True when the outside-area lead was flagged for an ASAP office callback (Massachusetts addresses).", "type": "boolean" }, "record_id": { "description": "Saved office lead reference, when applicable.", "type": "string" }, "request_id": { "description": "Public operation receipt for support; never a provider customer ID.", "format": "uuid", "type": "string" }, "review_sandbox": { "type": "boolean" }, "status": { "enum": [ "customer_created", "lead_submitted", "rejected" ], "type": "string" }, "success": { "type": "boolean" } }, "required": [ "request_id", "next_step", "success", "status", "in_service_area", "booked", "message" ], "type": "object" } } ] }
Verify it yourselfcurl -s https://api.teppi.xyz/v1/evidence/sha256:3b501616117d6db700d96b0226ec0f8293fe16cf211088db0585130c92e22985 | sha256sum