Hum Internet Availability

Validate internet order

validate_order

Idempotent

Start: {"lookup_id":"","offer_id":""}. Poll: {"checkout_id":""}. Edit: {"checkout_id":"","expected_revision":,"details":{}}. Use exactly one shape. Customer, installation, consents and internet_addons belong inside details, never at the root. While checking, wait retry_after_seconds and poll without details. Edits restart validation. On stale expected_revision, retrieve with checkout_id only before editing at the current revision. required_fields defines the contract; field_errors identifies actual missing/invalid fields relative to details. Refreshes the offer and returns an exact review without submitting an order. When preferred installation dates are required, provide both first and second choices using a time_window value allowed by the input schema. Installation type must be self or professional. Record the customer's explicit true or false choices for auto-pay and paperless billing; never enable them silently. Match the customer's equipment preference using returned equipment_options and catalog facts. Customer-owned equipment, included provider equipment and optional paid equipment are different choices. A free provider gateway does not satisfy an own-equipment request. Price or included status alone does not establish ownership. If an offer lacks the requested option, inspect another qualified offer or explain the limitation and ask the customer to choose; never fabricate an option. Send the complete selection in details.internet_addons using returned option_id and quantity values. Omit it to preserve current/default selections; [] declines optional items. Select at most one radio option and retain dependent parents. Ready means technically valid, not necessarily correct for the customer. Compare the entire review with the customer's budget, speed, equipment, billing and installation choices. Resolve mismatches before requesting authorization. Present every returned charge, discount, condition and unknown; do not invent a price adjustment for declined auto-pay or paperless billing. Never repeat the service PIN or full date of birth, even if supplied earlier. Keep capability IDs, terms_hash and validation_token out of customer-facing prose. Obtain explicit authorization for this exact current review before create_order; shopping intent or validation alone is not authorization.

Input Schema

Name	Required	Description	Default
`details`	No
`offer_id`	No
`lookup_id`	No
`checkout_id`	No
`expected_revision`	No

Output Schema

Name	Required	Description	Default
`error`	No
`review`	No
`status`	Yes
`revision`	No
`expires_at`	No
`terms_hash`	No
`checkout_id`	No
`next_action`	No
`field_errors`	No
`schema_version`	Yes
`required_fields`	No
`validation_token`	No
`equipment_options`	No
`retry_after_seconds`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedOct 19, 2026

changedOutput schema / $defs / ErrorDetail / properties / retry_after_seconds / anyOf

Previous value: -[
-  {
-    "maximum": 300,
-    "minimum": 1,
-    "type": "integer"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "maximum": 86400,
+    "minimum": 1,
+    "type": "integer"
+  },
+  {
+    "type": "null"
+  }
+]

Changed3 schema fields changedSep 24, 2026

addedInput schema / $defs / OrderDetails / description

Added value: +"Edit payload nested inside validate_order.details, never root tool arguments."

addedInput schema / $defs / OrderDetails / properties / consents / description

Added value: +"Customer consent choices at details.consents, using returned consent names."

changedInput schema / $defs / OrderDetails / properties / internet_addons / description

Previous value: -"Complete equipment selection using returned option IDs. Omit to keep the current selection or defaults; send [] to decline optional equipment."New value: +"Complete equipment selection at details.internet_addons using returned option IDs and quantities; retain dependent parents. Omit to keep current selections/defaults; send [] to decline optional equipment. A free provider gateway is not owned equipment."

Changed8 schema fields changedSep 22, 2026

addedInput schema / $defs / EquipmentSelection

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "option_id": {
+      "maxLength": 256,
+      "minLength": 1,
+      "title": "Option Id",
+      "type": "string"
+    },
+    "quantity": {
+      "minimum": 1,
+      "title": "Quantity",
+      "type": "integer"
+    }
+  },
+  "required": [
+    "option_id",
+    "quantity"
+  ],
+  "title": "EquipmentSelection",
+  "type": "object"
+}

addedInput schema / $defs / OrderDetails / properties / internet_addons

Added value: +{
+  "anyOf": [
+    {
+      "items": {
+        "$ref": "#/$defs/EquipmentSelection"
+      },
+      "maxItems": 100,
+      "type": "array"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "Complete equipment selection using returned option IDs. Omit to keep the current selection or defaults; send [] to decline optional equipment.",
+  "title": "Internet Addons"
+}

addedOutput schema / $defs / CartReview

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "bundle_discount": {
+      "anyOf": [
+        {
+          "$ref": "#/$defs/OrderAmount"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null
+    },
+    "included_products": {
+      "$ref": "#/$defs/IncludedProducts"
+    },
+    "one_time_fees": {
+      "items": {
+        "$ref": "#/$defs/OneTimeFee"
+      },
+      "maxItems": 100,
+      "title": "One Time Fees",
+      "type": "array"
+    },
+    "selected_plan": {
+      "$ref": "#/$defs/IncludedProduct"
+    },
+    "total_amount": {
+      "$ref": "#/$defs/OrderAmount"
+    }
+  },
+  "required": [
+    "selected_plan",
+    "included_products",
+    "one_time_fees",
+    "total_amount"
+  ],
+  "title": "CartReview",
+  "type": "object"
+}

addedOutput schema / $defs / EquipmentOption

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "included": {
+      "title": "Included",
+      "type": "boolean"
+    },
+    "max_quantity": {
+      "minimum": 1,
+      "title": "Max Quantity",
+      "type": "integer"
+    },
+    "name": {
+      "maxLength": 300,
+      "minLength": 1,
+      "title": "Name",
+      "type": "string"
+    },
+    "option_id": {
+      "maxLength": 256,
+      "minLength": 1,
+      "title": "Option Id",
+      "type": "string"
+    },
+    "selected_quantity": {
+      "minimum": 0,
+      "title": "Selected Quantity",
+      "type": "integer"
+    },
+    "selection_type": {
+      "enum": [
+        "radio",
+        "checkbox"
+      ],
+      "title": "Selection Type",
+      "type": "string"
+    },
+    "unit_pricing": {
+      "$ref": "#/$defs/OrderAmount"
+    }
+  },
+  "required": [
+    "option_id",
+    "name",
+    "selection_type",
+    "included",
+    "unit_pricing",
+    "max_quantity",
+    "selected_quantity"
+  ],
+  "title": "EquipmentOption",
+  "type": "object"
+}

addedOutput schema / $defs / OfferChangedReview / properties / current_cart

Added value: +{
+  "anyOf": [
+    {
+      "$ref": "#/$defs/CartReview"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null
+}

addedOutput schema / $defs / OfferChangedReview / properties / previous_cart

Added value: +{
+  "anyOf": [
+    {
+      "$ref": "#/$defs/CartReview"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null
+}

addedOutput schema / $defs / ReadyOrderReview / properties / bundle_discount

Added value: +{
+  "anyOf": [
+    {
+      "$ref": "#/$defs/OrderAmount"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null
+}

addedOutput schema / properties / equipment_options

Added value: +{
+  "items": {
+    "$ref": "#/$defs/EquipmentOption"
+  },
+  "maxItems": 100,
+  "title": "Equipment Options",
+  "type": "array"
+}

Changed4 schema fields changedSep 21, 2026

changedInput schema / $defs / BillingPreferences / properties / auto_pay / anyOf

Previous value: -[
-  {
-    "const": true,
-    "type": "boolean"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "type": "boolean"
+  },
+  {
+    "type": "null"
+  }
+]

changedInput schema / $defs / BillingPreferences / properties / paperless_billing / anyOf

Previous value: -[
-  {
-    "const": true,
-    "type": "boolean"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "type": "boolean"
+  },
+  {
+    "type": "null"
+  }
+]

changedOutput schema / $defs / BillingPreferences / properties / auto_pay / anyOf

Previous value: -[
-  {
-    "const": true,
-    "type": "boolean"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "type": "boolean"
+  },
+  {
+    "type": "null"
+  }
+]

changedOutput schema / $defs / BillingPreferences / properties / paperless_billing / anyOf

Previous value: -[
-  {
-    "const": true,
-    "type": "boolean"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "type": "boolean"
+  },
+  {
+    "type": "null"
+  }
+]

Changed6 schema fields changedSep 21, 2026

changedInput schema / $defs / BillingPreferences / properties / auto_pay / anyOf

Previous value: -[
-  {
-    "type": "boolean"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "const": true,
+    "type": "boolean"
+  },
+  {
+    "type": "null"
+  }
+]

changedInput schema / $defs / BillingPreferences / properties / paperless_billing / anyOf

Previous value: -[
-  {
-    "type": "boolean"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "const": true,
+    "type": "boolean"
+  },
+  {
+    "type": "null"
+  }
+]

changedInput schema / $defs / InstallationDetails / properties / type / anyOf

Previous value: -[
-  {
-    "enum": [
-      "self",
-      "professional",
-      "no_preference"
-    ],
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "enum": [
+      "self",
+      "professional"
+    ],
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

changedOutput schema / $defs / BillingPreferences / properties / auto_pay / anyOf

Previous value: -[
-  {
-    "type": "boolean"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "const": true,
+    "type": "boolean"
+  },
+  {
+    "type": "null"
+  }
+]

changedOutput schema / $defs / BillingPreferences / properties / paperless_billing / anyOf

Previous value: -[
-  {
-    "type": "boolean"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "const": true,
+    "type": "boolean"
+  },
+  {
+    "type": "null"
+  }
+]

changedOutput schema / $defs / InstallationDetails / properties / type / anyOf

Previous value: -[
-  {
-    "enum": [
-      "self",
-      "professional",
-      "no_preference"
-    ],
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "enum": [
+      "self",
+      "professional"
+    ],
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

Changed8 schema fields changedSep 21, 2026

addedOutput schema / $defs / IncludedProduct

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "name": {
+      "maxLength": 300,
+      "minLength": 1,
+      "title": "Name",
+      "type": "string"
+    },
+    "quantity": {
+      "minimum": 1,
+      "title": "Quantity",
+      "type": "integer"
+    },
+    "total_pricing": {
+      "$ref": "#/$defs/OrderAmount"
+    },
+    "unit_pricing": {
+      "$ref": "#/$defs/OrderAmount"
+    }
+  },
+  "required": [
+    "name",
+    "quantity",
+    "unit_pricing",
+    "total_pricing"
+  ],
+  "title": "IncludedProduct",
+  "type": "object"
+}

addedOutput schema / $defs / IncludedProducts

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "internet": {
+      "items": {
+        "$ref": "#/$defs/IncludedProduct"
+      },
+      "maxItems": 100,
+      "title": "Internet",
+      "type": "array"
+    },
+    "television": {
+      "items": {
+        "$ref": "#/$defs/IncludedProduct"
+      },
+      "maxItems": 100,
+      "title": "Television",
+      "type": "array"
+    },
+    "television_add_ons": {
+      "items": {
+        "$ref": "#/$defs/IncludedProduct"
+      },
+      "maxItems": 100,
+      "title": "Television Add Ons",
+      "type": "array"
+    }
+  },
+  "title": "IncludedProducts",
+  "type": "object"
+}

addedOutput schema / $defs / OneTimeFee

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "description": {
+      "maxLength": 1000,
+      "minLength": 1,
+      "title": "Description",
+      "type": "string"
+    },
+    "fee_type": {
+      "maxLength": 100,
+      "minLength": 1,
+      "title": "Fee Type",
+      "type": "string"
+    },
+    "name": {
+      "maxLength": 300,
+      "minLength": 1,
+      "title": "Name",
+      "type": "string"
+    },
+    "pricing": {
+      "$ref": "#/$defs/OrderAmount"
+    }
+  },
+  "required": [
+    "name",
+    "description",
+    "pricing",
+    "fee_type"
+  ],
+  "title": "OneTimeFee",
+  "type": "object"
+}

addedOutput schema / $defs / OrderAmount

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "amount_cents": {
+      "minimum": 0,
+      "title": "Amount Cents",
+      "type": "integer"
+    },
+    "amount_currency": {
+      "pattern": "^[A-Z]{3}$",
+      "title": "Amount Currency",
+      "type": "string"
+    }
+  },
+  "required": [
+    "amount_cents",
+    "amount_currency"
+  ],
+  "title": "OrderAmount",
+  "type": "object"
+}

addedOutput schema / $defs / ReadyOrderReview / properties / included_products
```
Added value: +{
+  "$ref": "#/$defs/IncludedProducts"
+}
```

addedOutput schema / $defs / ReadyOrderReview / properties / one_time_fees

Added value: +{
+  "items": {
+    "$ref": "#/$defs/OneTimeFee"
+  },
+  "maxItems": 100,
+  "title": "One Time Fees",
+  "type": "array"
+}

addedOutput schema / $defs / ReadyOrderReview / properties / total_amount
```
Added value: +{
+  "$ref": "#/$defs/OrderAmount"
+}
```

changedOutput schema / $defs / ReadyOrderReview / required

Previous value: -[
-  "provider_name",
-  "selected_offer",
-  "service_address",
-  "unknown_charges_remain_unknown"
-]New value: +[
+  "provider_name",
+  "selected_offer",
+  "included_products",
+  "one_time_fees",
+  "total_amount",
+  "service_address",
+  "unknown_charges_remain_unknown"
+]

Changed2 schema fields changedSep 21, 2026

changedInput schema / $defs / InstallationChoice / properties / time_window / anyOf

Previous value: -[
-  {
-    "maxLength": 100,
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "enum": [
+      "8:00 AM - 12:00 PM (Local Time)",
+      "12:00 PM - 5:00 PM (Local Time)"
+    ],
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

changedOutput schema / $defs / InstallationChoice / properties / time_window / anyOf

Previous value: -[
-  {
-    "maxLength": 100,
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "enum": [
+      "8:00 AM - 12:00 PM (Local Time)",
+      "12:00 PM - 5:00 PM (Local Time)"
+    ],
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

Changed1 schema field changedSep 21, 2026

addedInput schema / $defs / MailingAddress / properties / same_as_service

Added value: +{
+  "anyOf": [
+    {
+      "type": "boolean"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Same As Service"
+}

AddedSep 21, 2026

TDQS

A4.6/5.0

Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Beyond the annotations, the description discloses retry/polling behavior, the revision-conflict flow ("On stale expected_revision, retrieve with checkout_id only"), that edits restart validation, that "Ready means technically valid, not necessarily correct," and that it never submits an order. These are real operational traits (latency, versioning, side effects) that the annotations alone would not convey, and they are consistent with readOnlyHint=false/destructiveHint=false.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The content is dense and mostly load-bearing, but it is presented as an undifferentiated wall of prose with no paragraphing, lists, or headers, and the core purpose statement does not appear until mid-text. The bulk customer-equipment and disclosure policy could arguably live outside the tool definition.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a multi-mode, stateful tool with an output schema present (so return values need not be described), the description covers the call contract (required_fields vs field_errors), mode selection, revision handling, and the authorization gate before create_order. Nothing essential to invoking it correctly appears to be missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters5/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Top-level schema descriptions are 0% covered, so the description carries the full burden and does so: it maps lookup_id/offer_id to Start, checkout_id to Poll, and checkout_id/expected_revision/details to Edit, and clarifies that customer, installation, consents and internet_addons must nest inside details and never at the root. It also defines how expected_revision is used and reconciled.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific operation: "Refreshes the offer and returns an exact review without submitting an order," and later contrasts with create_order ("before create_order"), so an agent can distinguish it from the sibling that actually submits. However, this purpose sentence is buried after several sentences of payload JSON, and the tool's relationship to check_availability and get_order is never stated, so the purpose is clear in substance but poorly front-loaded and only partially differentiated.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It explicitly enumerates the three invocation shapes (Start/Poll/Edit), tells the agent to "use exactly one shape," explains polling ("wait retry_after_seconds and poll without details"), edit restart semantics, stale-revision recovery, and that authorization must precede create_order. This is concrete when-to-use, when-to-do-what, and an explicit alternative for submitting the order.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Hum Internet Availability tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?