Skip to main content

​
Releases and migration

Hum Broadband MCP 2.0.1 adds live qualification, order validation, authorized submission, and retrieval at Hum’s stable MCP endpoint. This release replaces the earlier availability-only schema at that endpoint.

​
Version 2.0.1

The public contract and current guidance are frozen to letshum/hum-mcp commit cd74ba9583c1c245638fa100a914f9cf85372dc7 on September 24, 2026. Harmony-backed example fixtures are verified against letshum/harmony commit 84d042bc702b9f63891ec340ffe9bf96a3a2d3e8.

​
September 24 checkout guidance

Ordering skill 1.2.0 and the validate_order tool description now show the exact start, poll, and edit shapes. Validation guidance distinguishes the checkout’s field definitions from actual field errors, explains stale revisions and polling, preserves customer equipment-ownership choices, and presents fuller review facts before authorization. Error text for malformed nested details identifies safe field paths without repeating submitted values. The four tools, schema version 4, server version 2.0.1, signed review, submission and recovery contract, and Harmony behavior did not change. The update did not add a public sandbox or a live-order test. The current 2.0.1 release makes the mailing-address choice explicit, aligns the server-owned fulfillment payload with the selected offer, and adds server-returned equipment choices and cart reviews. Clients can select equipment through opaque option IDs, see included products, one-time fees, totals, and returned discounts, and compare the previous and current cart when terms change. The public payload schema remains version 4. The server version identifies the connector release. schema_version identifies the payload contract. They use separate version numbers and should not be compared as if they were the same sequence.

​
Availability-only clients

There is one public endpoint. It reports com.letshum/broadband, exposes all four tools, and uses schema version 4 with snake_case fields. /mcp/v2 is not a released endpoint. The shorter availability skill remains available for clients that only use check_availability: Version 2.0.0 of that skill describes the availability portion of schema version 4. It does not preserve the earlier schema-version 3 payload or camelCase field names. Load the ordering skill before calling validate_order, create_order, or get_order.

​
Released lifetimes

Availability and validation work can run for up to 90 seconds per attempt. Poll after the delay in the current response. These values are freshness and access limits; they do not reserve provider inventory or guarantee a price.

​
Schema 3 to schema 4

The stable URL does not imply payload compatibility. Update schema-3 clients before reconnecting them to /mcp, including field names, status handling, continuation shapes, and order safety rules.

​
Migration steps

  1. Test the schema-version 4 server at the stable endpoint before replacing a production client connection.
  2. Confirm discovery returns the four tools and schema version 4.
  3. Load skill://order-internet-service/SKILL.md, or verify that the client can follow the tool descriptions without it.
  4. Update field access from camelCase to snake_case.
  5. Preserve separate FCC and live-source states and support typed question continuations.
  6. Treat catalog plans as informational and select only exact returned executable offer IDs.
  7. Add non-committing validation, return the complete selection from equipment_options, and present the exact cart review before authorization.
  8. Treat omitted internet_addons as retaining the current selection or defaults and [] as declining optional equipment.
  9. Persist the checkout ID and stable idempotency identity so a lost create response can be recovered through get_order.
  10. Present the six fulfillment states as Hum submission evidence, not ISP acceptance or installation status.
  11. Complete the testing checklist before enabling the updated connection for users.

​
Skill migration

Both skills use the same canonical Markdown, digest, MCP resource, and fixed HTTP delivery mechanism. Use order-internet-service for the complete schema-version 4 workflow. Keep check-internet-availability when a client only needs discovery. Both skills use snake_case fields at /mcp; the shorter skill directs transactional clients to the broader manual. This release does not change Hum’s partner REST API or widget contract. The partner API still does not expose order placement, and its analytics states do not map directly to MCP fulfillment states.