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

TableJSON Schema

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

Output Schema

TableJSON 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.

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.5/5.0

Behavior5/5

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

Annotations only declare readOnlyHint=false, openWorldHint=true, idempotentHint=true, destructiveHint=false. The description adds an exceptional amount of behavioral context: polling semantics, edits restarting validation, stale-revision recovery, never fabricating options, never silently enabling auto-pay/paperless billing, never repeating PIN/DOB, and keeping internal IDs out of customer-facing prose. No contradiction with annotations.

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

Conciseness4/5

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

The description is very long, but nearly every sentence carries operational weight—polling, revision handling, equipment ownership, consent recording, and authorization. It is front-loaded with the three usage shapes. A few concepts are stated more than once (e.g., auto-pay/paperless cautions), but the density is justified for a tool of this complexity.

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?

Given 5 parameters, zero schema description coverage, and an output schema that documents return values, the description covers every operational requirement an agent needs: invocation shapes, contract semantics (required_fields vs field_errors), equipment selection rules, installation constraints, consent handling, and the authorization boundary with create_order. Nothing essential is 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?

Schema description coverage is 0%, and the description fully compensates. It explains the three invocation shapes (lookup_id+offer_id for start, checkout_id for poll/edit, expected_revision for stale detection), dictates that customer/installation/consents/internet_addons belong inside details, and defines the semantics of required_fields and field_errors. This goes far beyond the bare schema.

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 clear verb and resource: 'Refreshes the offer and returns an exact review without submitting an order.' It also distinguishes itself from create_order explicitly ('Obtain explicit authorization... before create_order'). However, it does not explicitly address check_availability or get_order, and the dense operational rules slightly diffuse the core-purpose statement.

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

Usage Guidelines4/5

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

The description gives explicit usage modes ('Start', 'Poll', 'Edit') and clearly delineates the boundary with create_order: validation alone is not authorization. It does not explicitly discuss when check_availability or get_order should be used instead, but it provides strong contextual guidance on when validate_order is the right step in the flow.

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?