> ## Documentation Index > Fetch the complete documentation index at: https://docs.letshum.com/llms.txt > Use this file to discover all available pages before exploring further. # Releases and migration > Migrate from Hum's availability-only MCP to the schema-version 4 broadband workflow # 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 | Item | Value | | - | - | | Server name | `com.letshum/broadband` | | Server version | `2.0.1` | | Payload schema version | `4` | | Endpoint | `https://mcp.letshum.com/mcp` | | Transport | Stateless Streamable HTTP | | Primary skill | `skill://order-internet-service/SKILL.md`, version `1.2.0` | | Availability skill | `skill://check-internet-availability/SKILL.md`, version `2.0.0` | 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`: * Public Markdown: [Check internet availability](https://mcp.letshum.com/skills/check-internet-availability/SKILL.md) * MCP resource: `skill://check-internet-availability/SKILL.md` 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 | Resource | Lifetime | | - | - | | Address candidate | 10 minutes | | Lookup | 10 minutes, renewed after accepted answers or a revision advance | | Executable offer | 15 minutes | | Ready validation | 5 minutes | | Draft | 24 hours | | Checkout read capability | 90 days | 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 | Area | Earlier availability-only release | Broadband 2.0.1 | | - | - | - | | Endpoint | `/mcp` | `/mcp` (replaced in place) | | Tools | `check_availability` | Four-tool availability and ordering workflow | | Field style | camelCase | snake\_case | | Availability | One versioned availability result | Separate FCC and live source states with revisions and typed questions | | Plans | Availability facts | Informational `catalog_plans` separated from executable `offers` | | Order preparation | Not supported | Non-committing `validate_order` with customer details, equipment selection, and exact cart review | | Submission | Not supported | Authorized `create_order` with validation token, terms hash, and idempotency key | | Recovery | Poll the lookup | Retrieve an order with `get_order` after any uncertain create response | | Public order states | None | Six evidence-based fulfillment states | 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](/mcp/testing) 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. ## Related contracts 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. * [Partner API integration](/api-integration) * [Partner order reporting](/order-reporting) * [MCP fulfillment states](/mcp/ordering-and-recovery#fulfillment-states) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.