Hum Internet Availability

Check broadband availability

check_availability

Read-onlyIdempotent

Start with {address}; continue only with a returned candidate_id and requested unit, {lookup_id} to poll, or the current question_set_id and answers. FCC findings are area-level evidence. Select only returned executable offer_id values.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`unit`	No
`address`	No
`answers`	No
`lookup_id`	No
`candidate_id`	No
`question_set_id`	No

Output Schema

TableJSON Schema

Name	Required	Description	Default
`error`	No
`status`	Yes
`message`	No
`sources`	No
`revision`	No
`warnings`	No
`lookup_id`	No
`providers`	No
`questions`	No
`candidates`	No
`expires_at`	No
`next_action`	No
`required_field`	No
`schema_version`	Yes
`question_set_id`	No
`clarification_type`	No
`normalized_address`	No
`retry_after_seconds`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed72 schema fields changedSep 21, 2026

removedInput schema / properties / address / description

Removed value: -"An imperfect natural-language U.S. service address."

addedInput schema / properties / answers

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": true,
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Answers"
+}

removedInput schema / properties / candidateId

Removed value: -{
-  "anyOf": [
-    {
-      "maxLength": 2048,
-      "minLength": 1,
-      "type": "string"
-    },
-    {
-      "type": "null"
-    }
-  ],
-  "default": null,
-  "description": "Opaque ID returned by a previous clarification result.",
-  "title": "Candidateid"
-}

addedInput schema / properties / candidate_id

Added value: +{
+  "anyOf": [
+    {
+      "maxLength": 2048,
+      "minLength": 1,
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Candidate Id"
+}

removedInput schema / properties / lookupId

Removed value: -{
-  "anyOf": [
-    {
-      "maxLength": 128,
-      "minLength": 1,
-      "type": "string"
-    },
-    {
-      "type": "null"
-    }
-  ],
-  "default": null,
-  "description": "Opaque ID returned by a previous processing result.",
-  "title": "Lookupid"
-}

addedInput schema / properties / lookup_id

Added value: +{
+  "anyOf": [
+    {
+      "maxLength": 256,
+      "minLength": 1,
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Lookup Id"
+}

addedInput schema / properties / question_set_id

Added value: +{
+  "anyOf": [
+    {
+      "maxLength": 256,
+      "minLength": 1,
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Question Set Id"
+}

removedInput schema / properties / unit / description

Removed value: -"Apartment, suite, or unit requested by a unit clarification."

removedOutput schema / $defs / Candidate / properties / candidateId

Removed value: -{
-  "maxLength": 2048,
-  "minLength": 1,
-  "title": "Candidateid",
-  "type": "string"
-}

addedOutput schema / $defs / Candidate / properties / candidate_id

Added value: +{
+  "maxLength": 2048,
+  "minLength": 1,
+  "title": "Candidate Id",
+  "type": "string"
+}

removedOutput schema / $defs / Candidate / properties / requiresUnit

Removed value: -{
-  "title": "Requiresunit",
-  "type": "boolean"
-}

addedOutput schema / $defs / Candidate / properties / requires_unit

Added value: +{
+  "title": "Requires Unit",
+  "type": "boolean"
+}

changedOutput schema / $defs / Candidate / required

Previous value: -[
-  "candidateId",
-  "display",
-  "requiresUnit"
-]New value: +[
+  "candidate_id",
+  "display",
+  "requires_unit"
+]

addedOutput schema / $defs / ContractTerms

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "months": {
+      "anyOf": [
+        {
+          "minimum": 0,
+          "type": "integer"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Months"
+    },
+    "required": {
+      "anyOf": [
+        {
+          "type": "boolean"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Required"
+    }
+  },
+  "title": "ContractTerms",
+  "type": "object"
+}

removedOutput schema / $defs / Coverage

Removed value: -{
-  "additionalProperties": false,
-  "properties": {
-    "checkedAt": {
-      "format": "date-time",
-      "title": "Checkedat",
-      "type": "string"
-    },
-    "dataAsOf": {
-      "anyOf": [
-        {
-          "format": "date-time",
-          "type": "string"
-        },
-        {
-          "type": "null"
-        }
-      ],
-      "title": "Dataasof"
-    },
-    "source": {
-      "enum": [
-        "one_source",
-        "fcc"
-      ],
-      "title": "Source",
-      "type": "string"
-    }
-  },
-  "required": [
-    "source",
-    "checkedAt",
-    "dataAsOf"
-  ],
-  "title": "Coverage",
-  "type": "object"
-}

changedOutput schema / $defs / ErrorDetail / properties / code / enum

Previous value: -[
-  "invalid_request",
-  "invalid_address",
-  "invalid_candidate",
-  "lookup_not_found",
-  "lookup_timeout",
-  "upstream_unavailable",
-  "rate_limited"
-]New value: +[
+  "invalid_request",
+  "invalid_address",
+  "invalid_answer",
+  "not_found",
+  "expired",
+  "offer_changed",
+  "offer_unavailable",
+  "validation_required",
+  "confirmation_required",
+  "idempotency_conflict",
+  "duplicate_order",
+  "rate_limited",
+  "temporarily_unavailable"
+]

addedOutput schema / $defs / ErrorDetail / properties / correlation_id

Added value: +{
+  "anyOf": [
+    {
+      "maxLength": 128,
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Correlation Id"
+}

addedOutput schema / $defs / ErrorDetail / properties / field_errors

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": {
+        "type": "string"
+      },
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Field Errors"
+}

removedOutput schema / $defs / ErrorDetail / properties / nextAction

Removed value: -{
-  "maxLength": 500,
-  "minLength": 1,
-  "title": "Nextaction",
-  "type": "string"
-}

addedOutput schema / $defs / ErrorDetail / properties / next_action

Added value: +{
+  "maxLength": 500,
+  "minLength": 1,
+  "title": "Next Action",
+  "type": "string"
+}

addedOutput schema / $defs / ErrorDetail / properties / retry_after_seconds

Added value: +{
+  "anyOf": [
+    {
+      "maximum": 300,
+      "minimum": 1,
+      "type": "integer"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Retry After Seconds"
+}

changedOutput schema / $defs / ErrorDetail / required

Previous value: -[
-  "code",
-  "message",
-  "retryable",
-  "nextAction"
-]New value: +[
+  "code",
+  "message",
+  "retryable",
+  "next_action"
+]

addedOutput schema / $defs / FccMatch

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "data_as_of": {
+      "anyOf": [
+        {
+          "format": "date-time",
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Data As Of"
+    },
+    "granularity": {
+      "enum": [
+        "census_block",
+        "census_tract"
+      ],
+      "title": "Granularity",
+      "type": "string"
+    }
+  },
+  "required": [
+    "granularity"
+  ],
+  "title": "FccMatch",
+  "type": "object"
+}

addedOutput schema / $defs / FeeFacts

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "activation_cents": {
+      "anyOf": [
+        {
+          "minimum": 0,
+          "type": "integer"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Activation Cents"
+    },
+    "currency": {
+      "pattern": "^[A-Z]{3}$",
+      "title": "Currency",
+      "type": "string"
+    },
+    "professional_installation_cents": {
+      "anyOf": [
+        {
+          "minimum": 0,
+          "type": "integer"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Professional Installation Cents"
+    },
+    "recurring_equipment_cents": {
+      "anyOf": [
+        {
+          "minimum": 0,
+          "type": "integer"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Recurring Equipment Cents"
+    },
+    "self_installation_cents": {
+      "anyOf": [
+        {
+          "minimum": 0,
+          "type": "integer"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Self Installation Cents"
+    }
+  },
+  "required": [
+    "currency"
+  ],
+  "title": "FeeFacts",
+  "type": "object"
+}

removedOutput schema / $defs / Fees

Removed value: -{
-  "additionalProperties": false,
-  "properties": {
-    "activationCents": {
-      "anyOf": [
-        {
-          "minimum": 0,
-          "type": "integer"
-        },
-        {
-          "type": "null"
-        }
-      ],
-      "title": "Activationcents"
-    },
-    "currency": {
-      "const": "USD",
-      "title": "Currency",
-      "type": "string"
-    },
-    "professionalInstallationCents": {
-      "anyOf": [
-        {
-          "minimum": 0,
-          "type": "integer"
-        },
-        {
-          "type": "null"
-        }
-      ],
-      "title": "Professionalinstallationcents"
-    },
-    "selfInstallationCents": {
-      "anyOf": [
-        {
-          "minimum": 0,
-          "type": "integer"
-        },
-        {
-          "type": "null"
-        }
-      ],
-      "title": "Selfinstallationcents"
-    }
-  },
-  "required": [
-    "selfInstallationCents",
-    "professionalInstallationCents",
-    "activationCents",
-    "currency"
-  ],
-  "title": "Fees",
-  "type": "object"
-}

addedOutput schema / $defs / InformationalPlan

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "conditions": {
+      "items": {
+        "type": "string"
+      },
+      "maxItems": 50,
+      "title": "Conditions",
+      "type": "array"
+    },
+    "contract_terms": {
+      "$ref": "#/$defs/ContractTerms"
+    },
+    "data_limit": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "integer"
+        },
+        {
+          "type": "number"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Data Limit"
+    },
+    "download_mbps": {
+      "anyOf": [
+        {
+          "minimum": 0,
+          "type": "number"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Download Mbps"
+    },
+    "fees": {
+      "$ref": "#/$defs/FeeFacts"
+    },
+    "name": {
+      "maxLength": 300,
+      "minLength": 1,
+      "title": "Name",
+      "type": "string"
+    },
+    "pricing": {
+      "$ref": "#/$defs/MoneyFacts"
+    },
+    "technology": {
+      "anyOf": [
+        {
+          "maxLength": 100,
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Technology"
+    },
+    "upload_mbps": {
+      "anyOf": [
+        {
+          "minimum": 0,
+          "type": "number"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Upload Mbps"
+    }
+  },
+  "required": [
+    "name",
+    "pricing",
+    "fees",
+    "contract_terms"
+  ],
+  "title": "InformationalPlan",
+  "type": "object"
+}

addedOutput schema / $defs / MoneyFacts

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "currency": {
+      "pattern": "^[A-Z]{3}$",
+      "title": "Currency",
+      "type": "string"
+    },
+    "intro_months": {
+      "anyOf": [
+        {
+          "minimum": 0,
+          "type": "integer"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Intro Months"
+    },
+    "monthly_cents": {
+      "anyOf": [
+        {
+          "minimum": 0,
+          "type": "integer"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Monthly Cents"
+    },
+    "regular_monthly_cents": {
+      "anyOf": [
+        {
+          "minimum": 0,
+          "type": "integer"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Regular Monthly Cents"
+    }
+  },
+  "required": [
+    "currency"
+  ],
+  "title": "MoneyFacts",
+  "type": "object"
+}

removedOutput schema / $defs / NormalizedAddress / properties / postalCode

Removed value: -{
-  "pattern": "^\\d{5}(?:-\\d{4})?$",
-  "title": "Postalcode",
-  "type": "string"
-}

addedOutput schema / $defs / NormalizedAddress / properties / postal_code

Added value: +{
+  "pattern": "^\\d{5}(?:-\\d{4})?$",
+  "title": "Postal Code",
+  "type": "string"
+}

removedOutput schema / $defs / NormalizedAddress / properties / streetLine

Removed value: -{
-  "maxLength": 300,
-  "minLength": 1,
-  "title": "Streetline",
-  "type": "string"
-}

addedOutput schema / $defs / NormalizedAddress / properties / street_line

Added value: +{
+  "maxLength": 300,
+  "minLength": 1,
+  "title": "Street Line",
+  "type": "string"
+}

addedOutput schema / $defs / NormalizedAddress / properties / unit / default
```
Added value: +null
```

changedOutput schema / $defs / NormalizedAddress / required

Previous value: -[
-  "display",
-  "streetLine",
-  "unit",
-  "city",
-  "state",
-  "postalCode"
-]New value: +[
+  "display",
+  "street_line",
+  "city",
+  "state",
+  "postal_code"
+]

addedOutput schema / $defs / Offer

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "conditions": {
+      "items": {
+        "type": "string"
+      },
+      "maxItems": 50,
+      "title": "Conditions",
+      "type": "array"
+    },
+    "contract_terms": {
+      "$ref": "#/$defs/ContractTerms"
+    },
+    "data_limit": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "integer"
+        },
+        {
+          "type": "number"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Data Limit"
+    },
+    "download_mbps": {
+      "anyOf": [
+        {
+          "minimum": 0,
+          "type": "number"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Download Mbps"
+    },
+    "expires_at": {
+      "format": "date-time",
+      "title": "Expires At",
+      "type": "string"
+    },
+    "fees": {
+      "$ref": "#/$defs/FeeFacts"
+    },
+    "name": {
+      "maxLength": 300,
+      "minLength": 1,
+      "title": "Name",
+      "type": "string"
+    },
+    "offer_id": {
+      "maxLength": 256,
+      "minLength": 1,
+      "title": "Offer Id",
+      "type": "string"
+    },
+    "orderable_through_hum": {
+      "const": true,
+      "title": "Orderable Through Hum",
+      "type": "boolean"
+    },
+    "pricing": {
+      "$ref": "#/$defs/MoneyFacts"
+    },
+    "provider_id": {
+      "maxLength": 256,
+      "minLength": 1,
+      "title": "Provider Id",
+      "type": "string"
+    },
+    "qualification_revision": {
+      "minimum": 1,
+      "title": "Qualification Revision",
+      "type": "integer"
+    },
+    "qualified_at": {
+      "format": "date-time",
+      "title": "Qualified At",
+      "type": "string"
+    },
+    "technology": {
+      "anyOf": [
+        {
+          "maxLength": 100,
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Technology"
+    },
+    "upload_mbps": {
+      "anyOf": [
+        {
+          "minimum": 0,
+          "type": "number"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Upload Mbps"
+    }
+  },
+  "required": [
+    "name",
+    "pricing",
+    "fees",
+    "contract_terms",
+    "offer_id",
+    "provider_id",
+    "qualification_revision",
+    "qualified_at",
+    "expires_at",
+    "orderable_through_hum"
+  ],
+  "title": "Offer",
+  "type": "object"
+}

removedOutput schema / $defs / Plan

Removed value: -{
-  "additionalProperties": false,
-  "properties": {
-    "contractMonths": {
-      "anyOf": [
-        {
-          "minimum": 0,
-          "type": "integer"
-        },
-        {
-          "type": "null"
-        }
-      ],
-      "title": "Contractmonths"
-    },
-    "contractRequired": {
-      "anyOf": [
-        {
-          "type": "boolean"
-        },
-        {
-          "type": "null"
-        }
-      ],
-      "title": "Contractrequired"
-    },
-    "dataLimit": {
-      "anyOf": [
-        {
-          "type": "string"
-        },
-        {
-          "type": "integer"
-        },
-        {
-          "type": "number"
-        },
-        {
-          "type": "null"
-        }
-      ],
-      "title": "Datalimit"
-    },
-    "downloadMbps": {
-      "anyOf": [
-        {
-          "minimum": 0,
-          "type": "number"
-        },
-        {
-          "type": "null"
-        }
-      ],
-      "title": "Downloadmbps"
-    },
-    "fees": {
-      "$ref": "#/$defs/Fees"
-    },
-    "name": {
-      "maxLength": 300,
-      "minLength": 1,
-      "title": "Name",
-      "type": "string"
-    },
-    "pricing": {
-      "$ref": "#/$defs/Pricing"
-    },
-    "promotion": {
-      "anyOf": [
-        {
-          "maxLength": 2000,
-          "type": "string"
-        },
-        {
-          "type": "null"
-        }
-      ],
-      "title": "Promotion"
-    },
-    "technology": {
-      "anyOf": [
-        {
-          "maxLength": 100,
-          "type": "string"
-        },
-        {
-          "type": "null"
-        }
-      ],
-      "title": "Technology"
-    },
-    "uploadMbps": {
-      "anyOf": [
-        {
-          "minimum": 0,
-          "type": "number"
-        },
-        {
-          "type": "null"
-        }
-      ],
-      "title": "Uploadmbps"
-    }
-  },
-  "required": [
-    "name",
-    "technology",
-    "downloadMbps",
-    "uploadMbps",
-    "dataLimit",
-    "contractRequired",
-    "contractMonths",
-    "pricing",
-    "fees",
-    "promotion"
-  ],
-  "title": "Plan",
-  "type": "object"
-}

removedOutput schema / $defs / Pricing

Removed value: -{
-  "additionalProperties": false,
-  "properties": {
-    "currency": {
-      "const": "USD",
-      "title": "Currency",
-      "type": "string"
-    },
-    "introMonths": {
-      "anyOf": [
-        {
-          "minimum": 0,
-          "type": "integer"
-        },
-        {
-          "type": "null"
-        }
-      ],
-      "title": "Intromonths"
-    },
-    "monthlyCents": {
-      "anyOf": [
-        {
-          "minimum": 0,
-          "type": "integer"
-        },
-        {
-          "type": "null"
-        }
-      ],
-      "title": "Monthlycents"
-    },
-    "regularMonthlyCents": {
-      "anyOf": [
-        {
-          "minimum": 0,
-          "type": "integer"
-        },
-        {
-          "type": "null"
-        }
-      ],
-      "title": "Regularmonthlycents"
-    }
-  },
-  "required": [
-    "monthlyCents",
-    "regularMonthlyCents",
-    "introMonths",
-    "currency"
-  ],
-  "title": "Pricing",
-  "type": "object"
-}

addedOutput schema / $defs / Provider / properties / catalog_plans

Added value: +{
+  "items": {
+    "$ref": "#/$defs/InformationalPlan"
+  },
+  "maxItems": 500,
+  "title": "Catalog Plans",
+  "type": "array"
+}

addedOutput schema / $defs / Provider / properties / fcc_match

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

removedOutput schema / $defs / Provider / properties / logoUrl

Removed value: -{
-  "anyOf": [
-    {
-      "maxLength": 2048,
-      "type": "string"
-    },
-    {
-      "type": "null"
-    }
-  ],
-  "title": "Logourl"
-}

addedOutput schema / $defs / Provider / properties / offers

Added value: +{
+  "items": {
+    "$ref": "#/$defs/Offer"
+  },
+  "maxItems": 500,
+  "title": "Offers",
+  "type": "array"
+}

addedOutput schema / $defs / Provider / properties / orderable_through_hum

Added value: +{
+  "anyOf": [
+    {
+      "type": "boolean"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Orderable Through Hum"
+}

removedOutput schema / $defs / Provider / properties / plans

Removed value: -{
-  "items": {
-    "$ref": "#/$defs/Plan"
-  },
-  "maxItems": 500,
-  "title": "Plans",
-  "type": "array"
-}

addedOutput schema / $defs / Provider / properties / provenance

Added value: +{
+  "items": {
+    "enum": [
+      "fcc",
+      "live_provider_check"
+    ],
+    "type": "string"
+  },
+  "maxItems": 2,
+  "minItems": 1,
+  "title": "Provenance",
+  "type": "array"
+}

addedOutput schema / $defs / Provider / properties / provider_id

Added value: +{
+  "maxLength": 256,
+  "minLength": 1,
+  "title": "Provider Id",
+  "type": "string"
+}

addedOutput schema / $defs / Provider / properties / qualification_status

Added value: +{
+  "enum": [
+    "not_checked",
+    "checking",
+    "needs_information",
+    "qualified",
+    "not_qualified",
+    "failed"
+  ],
+  "title": "Qualification Status",
+  "type": "string"
+}

removedOutput schema / $defs / Provider / properties / technologies

Removed value: -{
-  "items": {
-    "type": "string"
-  },
-  "maxItems": 50,
-  "title": "Technologies",
-  "type": "array"
-}

changedOutput schema / $defs / Provider / required

Previous value: -[
-  "name",
-  "logoUrl",
-  "technologies",
-  "plans"
-]New value: +[
+  "provider_id",
+  "name",
+  "provenance",
+  "qualification_status"
+]

addedOutput schema / $defs / Question

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "choices": {
+      "anyOf": [
+        {
+          "items": {
+            "type": "string"
+          },
+          "maxItems": 100,
+          "type": "array"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Choices"
+    },
+    "prompt": {
+      "maxLength": 500,
+      "minLength": 1,
+      "title": "Prompt",
+      "type": "string"
+    },
+    "question_id": {
+      "maxLength": 256,
+      "minLength": 1,
+      "title": "Question Id",
+      "type": "string"
+    },
+    "required": {
+      "title": "Required",
+      "type": "boolean"
+    },
+    "sensitivity": {
+      "enum": [
+        "none",
+        "personal",
+        "sensitive"
+      ],
+      "title": "Sensitivity",
+      "type": "string"
+    },
+    "type": {
+      "enum": [
+        "string",
+        "boolean",
+        "single_choice",
+        "date"
+      ],
+      "title": "Type",
+      "type": "string"
+    }
+  },
+  "required": [
+    "question_id",
+    "prompt",
+    "type",
+    "required",
+    "sensitivity"
+  ],
+  "title": "Question",
+  "type": "object"
+}

addedOutput schema / $defs / SourceState

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "checked_at": {
+      "anyOf": [
+        {
+          "format": "date-time",
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Checked At"
+    },
+    "data_as_of": {
+      "anyOf": [
+        {
+          "format": "date-time",
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Data As Of"
+    },
+    "error": {
+      "anyOf": [
+        {
+          "$ref": "#/$defs/ErrorDetail"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null
+    },
+    "status": {
+      "enum": [
+        "checking",
+        "needs_information",
+        "complete",
+        "failed",
+        "timed_out"
+      ],
+      "title": "Status",
+      "type": "string"
+    }
+  },
+  "required": [
+    "status"
+  ],
+  "title": "SourceState",
+  "type": "object"
+}

addedOutput schema / $defs / Sources

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "fcc": {
+      "$ref": "#/$defs/SourceState"
+    },
+    "live_provider_check": {
+      "$ref": "#/$defs/SourceState"
+    }
+  },
+  "required": [
+    "fcc",
+    "live_provider_check"
+  ],
+  "title": "Sources",
+  "type": "object"
+}

removedOutput schema / description

Removed value: -"Object-root output schema with status-specific runtime validation.\n\nOlder MCP peers require an object at the root of ``outputSchema``. The status is still a\ndiscriminator: every returned payload is validated against ``AvailabilityResult``."

removedOutput schema / properties / clarificationType

Removed value: -{
-  "anyOf": [
-    {
-      "enum": [
-        "candidate_selection",
-        "unit_required"
-      ],
-      "type": "string"
-    },
-    {
-      "type": "null"
-    }
-  ],
-  "default": null,
-  "title": "Clarificationtype"
-}

addedOutput schema / properties / clarification_type

Added value: +{
+  "anyOf": [
+    {
+      "enum": [
+        "candidate_selection",
+        "unit_required"
+      ],
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Clarification Type"
+}

removedOutput schema / properties / coverage

Removed value: -{
-  "anyOf": [
-    {
-      "$ref": "#/$defs/Coverage"
-    },
-    {
-      "type": "null"
-    }
-  ],
-  "default": null
-}

addedOutput schema / properties / expires_at

Added value: +{
+  "anyOf": [
+    {
+      "format": "date-time",
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Expires At"
+}

removedOutput schema / properties / lookupId

Removed value: -{
-  "anyOf": [
-    {
-      "maxLength": 128,
-      "type": "string"
-    },
-    {
-      "type": "null"
-    }
-  ],
-  "default": null,
-  "title": "Lookupid"
-}

addedOutput schema / properties / lookup_id

Added value: +{
+  "anyOf": [
+    {
+      "maxLength": 256,
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Lookup Id"
+}

addedOutput schema / properties / next_action

Added value: +{
+  "anyOf": [
+    {
+      "maxLength": 1000,
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Next Action"
+}

removedOutput schema / properties / normalizedAddress

Removed value: -{
-  "anyOf": [
-    {
-      "$ref": "#/$defs/NormalizedAddress"
-    },
-    {
-      "type": "null"
-    }
-  ],
-  "default": null
-}

addedOutput schema / properties / normalized_address

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

addedOutput schema / properties / question_set_id

Added value: +{
+  "anyOf": [
+    {
+      "maxLength": 256,
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Question Set Id"
+}

addedOutput schema / properties / questions

Added value: +{
+  "items": {
+    "$ref": "#/$defs/Question"
+  },
+  "maxItems": 100,
+  "title": "Questions",
+  "type": "array"
+}

removedOutput schema / properties / requiredField

Removed value: -{
-  "anyOf": [
-    {
-      "const": "unit",
-      "type": "string"
-    },
-    {
-      "type": "null"
-    }
-  ],
-  "default": null,
-  "title": "Requiredfield"
-}

addedOutput schema / properties / required_field

Added value: +{
+  "anyOf": [
+    {
+      "const": "unit",
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Required Field"
+}

removedOutput schema / properties / retryAfterSeconds

Removed value: -{
-  "anyOf": [
-    {
-      "maximum": 300,
-      "minimum": 1,
-      "type": "integer"
-    },
-    {
-      "type": "null"
-    }
-  ],
-  "default": null,
-  "title": "Retryafterseconds"
-}

addedOutput schema / properties / retry_after_seconds

Added value: +{
+  "anyOf": [
+    {
+      "maximum": 300,
+      "minimum": 1,
+      "type": "integer"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Retry After Seconds"
+}

addedOutput schema / properties / revision

Added value: +{
+  "anyOf": [
+    {
+      "minimum": 1,
+      "type": "integer"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Revision"
+}

removedOutput schema / properties / schemaVersion

Removed value: -{
-  "const": 3,
-  "title": "Schemaversion",
-  "type": "integer"
-}

addedOutput schema / properties / schema_version

Added value: +{
+  "const": 4,
+  "title": "Schema Version",
+  "type": "integer"
+}

addedOutput schema / properties / sources

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

changedOutput schema / properties / status / enum

Previous value: -[
-  "available",
-  "no_service",
-  "needs_clarification",
-  "processing",
-  "error"
-]New value: +[
+  "checking",
+  "needs_information",
+  "complete",
+  "failed",
+  "error"
+]

changedOutput schema / required

Previous value: -[
-  "schemaVersion",
-  "status",
-  "warnings"
-]New value: +[
+  "schema_version",
+  "status"
+]

First observedAug 28, 2026

TDQS

A4/5.0

Behavior4/5

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

The annotations already establish read-only, idempotent, and non-destructive behavior. The description adds valuable behavioral context beyond that: FCC findings are only area-level evidence, and callers must select only returned executable offer_id values. This warns about data granularity and restricts how results should be used, which the annotations alone do not convey.

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 compact at three sentences and front-loads the primary starting point ('Start with {address}'). Some phrasing is dense and slightly ambiguous, especially the 'continue only with...' list, but every sentence contributes workflow, caveat, or constraint information.

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

Completeness4/5

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

For a stateful, multi-parameter tool with no required inputs, the description gives a coherent workflow: address first, then candidate_id/unit, lookup_id polling, or question_set_id/answers. It also addresses output selection by requiring returned executable offer_id values. Gaps remain around exactly how modes combine and what the 'answers' object should contain, but the presence of an output schema reduces the need to document return details.

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

Parameters4/5

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

Schema description coverage is 0%, so the description carries the full burden of explaining parameters. It meaningfully maps address as the starting input and links candidate_id, unit, lookup_id, question_set_id, and answers to continuation modes. It does not fully explain relationships or possible exclusivity, but it provides substantial semantic value the bare schema lacks.

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 communicates an availability-check workflow: start with an address, then continue with candidate_id, lookup_id, or question_set_id and answers. It also references returned offer_id values, which clearly aligns with checking broadband availability rather than order operations. The main weakness is that the tool's core action ('checks availability') is only explicit in the title, not restated in the description.

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 concrete usage sequencing: begin with an address, then continue only with returned identifiers or the current question set and answers. This is clear guidance for invoking the tool across a multi-step flow. It does not explicitly name sibling tools or say when not to use them, but the context of availability polling is sufficiently distinct from order creation, validation, and retrieval.

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?