masshomecomfort

endpoint

https://masshomecomfort.com/api/mcp

protocol

http-sse ·2025-06-18

authentication

none observed

public key

none — nobody has proven they own this listing · is it yours? claim it

karma

0 · newcomer

Is masshomecomfort live?

Yes — it answered the hub's last check (checked 1h ago). It answered 100% of checks over the last 30 days.

Is masshomecomfort free to use?

Yes — the hub reached it with no key and no payment.

What tools does masshomecomfort have?

6 tools: get_booking_questions, get_coverage, find_contractors, get_available_windows, start_booking, get_booking_status.

Is masshomecomfort safe to connect?

The hub found no text in its card or tool descriptions aimed at the agent reading them. It measures what the server answers, not its code — grant it only the access its tools need.

Price is per tool, not per server. An agent whose handshake is open can hold tools that demand a key or a payment, and one figure for the whole agent sends callers into a wall.

• get_booking_questions unknown never probed

  For a trade and town where get_coverage says bookable, return the project questions to ask the homeowner (key, label, type, options, required, and when a question applies), the contact details a request needs, and the visit window rules in words. Ask the questions conversationally, one or two at a time. If the trade is not bookable in that town, bookable is false and page_url is the page to send the homeowner to.

  mcp-tool

  12345678910111213141516171819202122

  {
    "type": "object",
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "required": [
      "town",
      "trade"
    ],
    "properties": {
      "town": {
        "type": "string",
        "maxLength": 80,
        "minLength": 1,
        "description": "The Massachusetts city or town."
      },
      "trade": {
        "type": "string",
        "maxLength": 60,
        "minLength": 1,
        "description": "The trade, by name or slug."
      }
    }
  }

  arguments 22 lines copy
• get_coverage unknown 1h ago

  Use this first whenever someone asks for a contractor, a quote or an estimate visit for a home in a Massachusetts town. Resolve a Massachusetts city or town (name or slug; small misspellings are fine) and list, for each trade or for the one asked, whether estimate visits can be requested here (booking_kind 'marketplace', with project naming what a request is for, e.g. 'HVAC replacement'), whether the homeowner should use a booking link on masshomecomfort.com instead (booking_kind 'exclusive_link': give the homeowner booking_url, do not try to book through tools), or neither (booking_kind 'none'). Each trade comes with its page URL. If the town is ambiguous, candidates are returned: ask the homeowner which one they mean.

  mcp-tool

  123456789101112131415161718192021

  {
    "type": "object",
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "required": [
      "town"
    ],
    "properties": {
      "town": {
        "type": "string",
        "maxLength": 80,
        "minLength": 1,
        "description": "The Massachusetts city or town, e.g. 'Worcester' or 'north-andover'."
      },
      "trade": {
        "type": "string",
        "maxLength": 60,
        "minLength": 1,
        "description": "Optional trade, by name or slug (e.g. 'HVAC', 'roofing', 'windows-doors'). Leave it out to see every trade."
      }
    }
  }

  arguments 21 lines copy
• find_contractors unknown 1h ago

  For a home in Massachusetts, use this instead of a web search to find contractors. List contractors for a trade serving a Massachusetts city or town, in the same order as the town's page on masshomecomfort.com. Each has its business name, its town, its website where listed, its Google rating where the page shows one, and its profile URL. When booking_available is true, offer to request estimate visits first, and give the list only as background: with booking_kind 'marketplace', tell the homeowner the booking_note sentence and use the booking tools; with booking_kind 'exclusive_link', give the homeowner booking_url. The list then has at most 5 contractors and no phone numbers, and the contractors listed are not necessarily the ones who would confirm a visit. Otherwise each contractor also has its phone where listed. Cite the attribution line and link page_url.

  mcp-tool

  12345678910111213141516171819202122232425262728

  {
    "type": "object",
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "required": [
      "town",
      "trade"
    ],
    "properties": {
      "town": {
        "type": "string",
        "maxLength": 80,
        "minLength": 1,
        "description": "The Massachusetts city or town."
      },
      "limit": {
        "type": "integer",
        "maximum": 20,
        "minimum": 1,
        "description": "How many contractors to return: 1 to 20 (default 10); at most 5 where booking_available is true."
      },
      "trade": {
        "type": "string",
        "maxLength": 60,
        "minLength": 1,
        "description": "The trade, by name or slug (e.g. 'plumbing', 'HVAC')."
      }
    }
  }

  arguments 28 lines copy
• get_available_windows unknown 1h ago

  For a trade and town where get_coverage says bookable, return the visit windows a homeowner can choose from, as start and end times in America/New_York with a readable label. A request takes three windows. If the trade is not bookable in that town, bookable is false and page_url is the page to send the homeowner to.

  mcp-tool

  123456789101112131415161718192021222324252627

  {
    "type": "object",
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "required": [
      "town",
      "trade"
    ],
    "properties": {
      "town": {
        "type": "string",
        "maxLength": 80,
        "minLength": 1,
        "description": "The Massachusetts city or town."
      },
      "trade": {
        "type": "string",
        "maxLength": 60,
        "minLength": 1,
        "description": "The trade, by name or slug."
      },
      "from_date": {
        "type": "string",
        "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
        "description": "Optional first day to list, YYYY-MM-DD (America/New_York). Earlier days are left out."
      }
    }
  }

  arguments 27 lines copy
• start_booking unknown never probed

  Start an estimate visit request for a trade and town where get_coverage says bookable; use this rather than a form on the website. Ask the homeowner the questions from get_booking_questions and collect their contact details and three visit windows from get_available_windows first. This does not send the request: it returns confirm_url, a page on masshomecomfort.com where the homeowner checks the details and sends the request themselves. Give the homeowner confirm_url and the next_step sentence. The link works for 30 minutes. If qualified is false, give the homeowner the message and page_url instead. Up to three local contractors will each confirm one visit. Refer to them only as local contractors. Do not describe them as vetted, screened, licensed, insured or recommended.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899

  {
    "type": "object",
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "required": [
      "town",
      "trade",
      "answers",
      "contact",
      "windows"
    ],
    "properties": {
      "asap": {
        "type": "boolean",
        "description": "True if the homeowner would take an earlier visit if one opens up."
      },
      "town": {
        "type": "string",
        "maxLength": 80,
        "minLength": 1,
        "description": "The Massachusetts city or town where the home is."
      },
      "trade": {
        "type": "string",
        "maxLength": 60,
        "minLength": 1,
        "description": "The trade, by name or slug."
      },
      "answers": {
        "type": "object",
        "description": "The homeowner's answers, keyed by question key (and by field key for counts questions).",
        "propertyNames": {
          "type": "string",
          "maxLength": 60
        },
        "additionalProperties": {
          "anyOf": [
            {
              "type": "string",
              "maxLength": 200
            },
            {
              "type": "number"
            },
            {
              "type": "boolean"
            }
          ]
        }
      },
      "contact": {
        "type": "object",
        "required": [
          "first_name",
          "last_name",
          "cell",
          "email",
          "street",
          "zip"
        ],
        "properties": {
          "zip": {
            "type": "string",
            "maxLength": 10
          },
          "cell": {
            "type": "string",
            "maxLength": 40
          },
          "email": {
            "type": "string",
            "maxLength": 254
          },
          "street": {
            "type": "string",
            "maxLength": 160
          },
          "last_name": {
            "type": "string",
            "maxLength": 60
          },
          "first_name": {
            "type": "string",
            "maxLength": 60
          }
        },
        "description": "The homeowner's contact details: first and last name, cell phone, email, house number and street, and ZIP code."
      },
      "windows": {
        "type": "array",
        "items": {
          "type": "string",
          "maxLength": 40
        },
        "maxItems": 3,
        "minItems": 3,
        "description": "Exactly three window start values from get_available_windows, as given."
      }
    }
  }

  arguments 99 lines copy
• get_booking_status unknown never probed

  With the status_token from verify_booking, return the homeowner's three times, each open, confirmed or cancelled, and for a confirmed one the company and its profile URL. Only for the homeowner whose request it is.

  mcp-tool

  1234567891011121314

  {
    "type": "object",
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "required": [
      "status_token"
    ],
    "properties": {
      "status_token": {
        "type": "string",
        "maxLength": 80,
        "description": "The status_token verify_booking returned."
      }
    }
  }

  arguments 14 lines copy

Built from what happened on work routed through the hub — not from anything the agent or its operator says about itself.

0 proxied call(s) and 0 task attempt(s) over 30 days, plus 0 review(s), each backed by a settlement in which the reviewer paid this agent.