Hum Internet Availability MCP
An official MCP server by Hum that allows AI agents to check internet service availability, compare plans, and order broadband services for specific U.S. street addresses. It integrates with resident apps and multifamily operators to streamline move-in processes by providing real-time pricing and provider data.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
MCP endpoint (Streamable HTTP)
https://mcp.letshum.com/mcpWhat its tools do
4 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.
Read-only (2)
Can change data (2)
Checks and signals
Each line is separate evidence, not a trust score.
- Passed Endpoint answered the live check ·
- Passed Official MCP Registry namespace is tied to letshum.com ·
- Passed Endpoint is on the registry namespace domain ·
- Availability 1 of 1 checks passed in 30 days
What you can do with it
- Check internet availability at a specific address
- Compare broadband plans and pricing
- Order internet service for a resident
Source and maintenance
Vendor evidenceRegistry 1.3.0
Protocol and capabilities
- Server
- com.letshum/broadband 2.0.1
- MCP protocol negotiated in check
- 2025-11-25
- Tools
- 4 advertised
- Resources
- 2 advertised
- Resource templates
- 0 advertised
- Prompts
- 0 advertised
Server-advertised capabilities
{
"tools": {
"listChanged": false
},
"prompts": {
"listChanged": false
},
"resources": {
"subscribe": false,
"listChanged": false
},
"experimental": {}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
4 advertised
check_availability — Check broadband availability
Advertised read-onlyOpen-world
Use this when someone asks what internet service or plans are available at a U.S. street address: providers, speeds and prices. U.S. addresses only; not for outages, speed tests or router troubleshooting. Start with {address}: the full street address, and include the apartment or unit in the address. Continue only with returned IDs: {candidate_id} (plus unit if asked) to pick an address, {lookup_id} to keep checking, or {lookup_id, question_set_id, answers}. Each call waits for live results; while status is checking, call again with lookup_id. Providers reported only in FCC area data were not checked at the address. Select only returned offer_id values.
check_availability input schema
{
"type": "object",
"title": "check_availabilityArguments",
"properties": {
"unit": {
"anyOf": [
{
"type": "string",
"maxLength": 100,
"minLength": 1
},
{
"type": "null"
}
],
"title": "Unit",
"default": null
},
"address": {
"anyOf": [
{
"type": "string",
"maxLength": 300,
"minLength": 1
},
{
"type": "null"
}
],
"title": "Address",
"default": null
},
"answers": {
"anyOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "null"
}
],
"title": "Answers",
"default": null
},
"lookup_id": {
"anyOf": [
{
"type": "string",
"maxLength": 256,
"minLength": 1
},
{
"type": "null"
}
],
"title": "Lookup Id",
"default": null
},
"candidate_id": {
"anyOf": [
{
"type": "string",
"maxLength": 2048,
"minLength": 1
},
{
"type": "null"
}
],
"title": "Candidate Id",
"default": null
},
"question_set_id": {
"anyOf": [
{
"type": "string",
"maxLength": 256,
"minLength": 1
},
{
"type": "null"
}
],
"title": "Question Set Id",
"default": null
}
},
"additionalProperties": false
}check_availability output schema
{
"type": "object",
"$defs": {
"Offer": {
"type": "object",
"title": "Offer",
"required": [
"name",
"pricing",
"fees",
"contract_terms",
"offer_id",
"provider_id",
"qualification_revision",
"qualified_at",
"expires_at",
"orderable_through_hum"
],
"properties": {
"fees": {
"$ref": "#/$defs/FeeFacts"
},
"name": {
"type": "string",
"title": "Name",
"maxLength": 300,
"minLength": 1
},
"pricing": {
"$ref": "#/$defs/MoneyFacts"
},
"offer_id": {
"type": "string",
"title": "Offer Id",
"maxLength": 256,
"minLength": 1
},
"conditions": {
"type": "array",
"items": {
"type": "string"
},
"title": "Conditions",
"maxItems": 50
},
"data_limit": {
"anyOf": [
{
"type": "string"
},
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Data Limit",
"default": null
},
"expires_at": {
"type": "string",
"title": "Expires At",
"format": "date-time"
},
"technology": {
"anyOf": [
{
"type": "string",
"maxLength": 100
},
{
"type": "null"
}
],
"title": "Technology",
"default": null
},
"provider_id": {
"type": "string",
"title": "Provider Id",
"maxLength": 256,
"minLength": 1
},
"upload_mbps": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Upload Mbps",
"default": null
},
"qualified_at": {
"type": "string",
"title": "Qualified At",
"format": "date-time"
},
"download_mbps": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Download Mbps",
"default": null
},
"contract_terms": {
"$ref": "#/$defs/ContractTerms"
},
"orderable_through_hum": {
"type": "boolean",
"const": true,
"title": "Orderable Through Hum"
},
"qualification_revision": {
"type": "integer",
"title": "Qualification Revision",
"minimum": 1
}
},
"additionalProperties": false
},
"Sources": {
"type": "object",
"title": "Sources",
"required": [
"fcc",
"live_provider_check"
],
"properties": {
"fcc": {
"$ref": "#/$defs/SourceState"
},
"live_provider_check": {
"$ref": "#/$defs/SourceState"
}
},
"additionalProperties": false
},
"FccMatch": {
"type": "object",
"title": "FccMatch",
"required": [
"granularity"
],
"properties": {
"data_as_of": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Data As Of",
"default": null
},
"granularity": {
"enum": [
"census_block",
"census_tract"
],
"type": "string",
"title": "Granularity"
}
},
"additionalProperties": false
},
"FeeFacts": {
"type": "object",
"title": "FeeFacts",
"required": [
"currency"
],
"properties": {
"currency": {
"type": "string",
"title": "Currency",
"pattern": "^[A-Z]{3}$"
},
"activation_cents": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Activation Cents",
"default": null
},
"self_installation_cents": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Self Installation Cents",
"default": null
},
"recurring_equipment_cents": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Recurring Equipment Cents",
"default": null
},
"professional_installation_cents": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Professional Installation Cents",
"default": null
}
},
"additionalProperties": false
},
"Provider": {
"type": "object",
"title": "Provider",
"required": [
"provider_id",
"name",
"provenance",
"qualification_status"
],
"properties": {
"name": {
"type": "string",
"title": "Name",
"maxLength": 300,
"minLength": 1
},
"offers": {
"type": "array",
"items": {
"$ref": "#/$defs/Offer"
},
"title": "Offers",
"maxItems": 500
},
"fcc_match": {
"anyOf": [
{
"$ref": "#/$defs/FccMatch"
},
{
"type": "null"
}
],
"default": null
},
"provenance": {
"type": "array",
"items": {
"enum": [
"fcc",
"live_provider_check"
],
"type": "string"
},
"title": "Provenance",
"maxItems": 2,
"minItems": 1
},
"provider_id": {
"type": "string",
"title": "Provider Id",
"maxLength": 256,
"minLength": 1
},
"catalog_plans": {
"type": "array",
"items": {
"$ref": "#/$defs/InformationalPlan"
},
"title": "Catalog Plans",
"maxItems": 500
},
"qualification_status": {
"enum": [
"not_checked",
"checking",
"needs_information",
"qualified",
"not_qualified",
"failed"
],
"type": "string",
"title": "Qualification Status"
},
"orderable_through_hum": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Orderable Through Hum",
"default": null
}
},
"additionalProperties": false
},
"Question": {
"type": "object",
"title": "Question",
"required": [
"question_id",
"prompt",
"type",
"required",
"sensitivity"
],
"properties": {
"type": {
"enum": [
"string",
"boolean",
"single_choice",
"date"
],
"type": "string",
"title": "Type"
},
"prompt": {
"type": "string",
"title": "Prompt",
"maxLength": 500,
"minLength": 1
},
"choices": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
},
"maxItems": 100
},
{
"type": "null"
}
],
"title": "Choices",
"default": null
},
"required": {
"type": "boolean",
"title": "Required"
},
"question_id": {
"type": "string",
"title": "Question Id",
"maxLength": 256,
"minLength": 1
},
"sensitivity": {
"enum": [
"none",
"personal",
"sensitive"
],
"type": "string",
"title": "Sensitivity"
}
},
"additionalProperties": false
},
"Candidate": {
"type": "object",
"title": "Candidate",
"required": [
"candidate_id",
"display",
"requires_unit"
],
"properties": {
"display": {
"type": "string",
"title": "Display",
"maxLength": 500,
"minLength": 1
},
"candidate_id": {
"type": "string",
"title": "Candidate Id",
"maxLength": 2048,
"minLength": 1
},
"requires_unit": {
"type": "boolean",
"title": "Requires Unit"
}
},
"additionalProperties": false
},
"MoneyFacts": {
"type": "object",
"title": "MoneyFacts",
"required": [
"currency"
],
"properties": {
"currency": {
"type": "string",
"title": "Currency",
"pattern": "^[A-Z]{3}$"
},
"intro_months": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Intro Months",
"default": null
},
"monthly_cents": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Monthly Cents",
"default": null
},
"regular_monthly_cents": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Regular Monthly Cents",
"default": null
}
},
"additionalProperties": false
},
"ErrorDetail": {
"type": "object",
"title": "ErrorDetail",
"required": [
"code",
"message",
"retryable",
"next_action"
],
"properties": {
"code": {
"enum": [
"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"
],
"type": "string",
"title": "Code"
},
"message": {
"type": "string",
"title": "Message",
"maxLength": 500,
"minLength": 1
},
"retryable": {
"type": "boolean",
"title": "Retryable"
},
"next_action": {
"type": "string",
"title": "Next Action",
"maxLength": 500,
"minLength": 1
},
"field_errors": {
"anyOf": [
{
"type": "object",
"additionalProperties": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Field Errors",
"default": null
},
"correlation_id": {
"anyOf": [
{
"type": "string",
"maxLength": 128
},
{
"type": "null"
}
],
"title": "Correlation Id",
"default": null
},
"retry_after_seconds": {
"anyOf": [
{
"type": "integer",
"maximum": 86400,
"minimum": 1
},
{
"type": "null"
}
],
"title": "Retry After Seconds",
"default": null
}
},
"additionalProperties": false
},
"SourceState": {
"type": "object",
"title": "SourceState",
"required": [
"status"
],
"properties": {
"error": {
"anyOf": [
{
"$ref": "#/$defs/ErrorDetail"
},
{
"type": "null"
}
],
"default": null
},
"status": {
"enum": [
"checking",
"needs_information",
"complete",
"failed",
"timed_out"
],
"type": "string",
"title": "Status"
},
"checked_at": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Checked At",
"default": null
},
"data_as_of": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Data As Of",
"default": null
}
},
"additionalProperties": false
},
"ContractTerms": {
"type": "object",
"title": "ContractTerms",
"properties": {
"months": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Months",
"default": null
},
"required": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Required",
"default": null
}
},
"additionalProperties": false
},
"InformationalPlan": {
"type": "object",
"title": "InformationalPlan",
"required": [
"name",
"pricing",
"fees",
"contract_terms"
],
"properties": {
"fees": {
"$ref": "#/$defs/FeeFacts"
},
"name": {
"type": "string",
"title": "Name",
"maxLength": 300,
"minLength": 1
},
"pricing": {
"$ref": "#/$defs/MoneyFacts"
},
"conditions": {
"type": "array",
"items": {
"type": "string"
},
"title": "Conditions",
"maxItems": 50
},
"data_limit": {
"anyOf": [
{
"type": "string"
},
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Data Limit",
"default": null
},
"technology": {
"anyOf": [
{
"type": "string",
"maxLength": 100
},
{
"type": "null"
}
],
"title": "Technology",
"default": null
},
"upload_mbps": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Upload Mbps",
"default": null
},
"download_mbps": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Download Mbps",
"default": null
},
"contract_terms": {
"$ref": "#/$defs/ContractTerms"
}
},
"additionalProperties": false
},
"NormalizedAddress": {
"type": "object",
"title": "NormalizedAddress",
"required": [
"display",
"street_line",
"city",
"state",
"postal_code"
],
"properties": {
"city": {
"type": "string",
"title": "City",
"maxLength": 100,
"minLength": 1
},
"unit": {
"anyOf": [
{
"type": "string",
"maxLength": 100
},
{
"type": "null"
}
],
"title": "Unit",
"default": null
},
"state": {
"type": "string",
"title": "State",
"pattern": "^[A-Z]{2}$"
},
"display": {
"type": "string",
"title": "Display",
"maxLength": 500,
"minLength": 1
},
"postal_code": {
"type": "string",
"title": "Postal Code",
"pattern": "^\\d{5}(?:-\\d{4})?$"
},
"street_line": {
"type": "string",
"title": "Street Line",
"maxLength": 300,
"minLength": 1
}
},
"additionalProperties": false
}
},
"title": "AvailabilityEnvelope",
"required": [
"schema_version",
"status"
],
"properties": {
"error": {
"anyOf": [
{
"$ref": "#/$defs/ErrorDetail"
},
{
"type": "null"
}
],
"default": null
},
"status": {
"enum": [
"checking",
"needs_information",
"complete",
"failed",
"error"
],
"type": "string",
"title": "Status"
},
"message": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "null"
}
],
"title": "Message",
"default": null
},
"sources": {
"anyOf": [
{
"$ref": "#/$defs/Sources"
},
{
"type": "null"
}
],
"default": null
},
"revision": {
"anyOf": [
{
"type": "integer",
"minimum": 1
},
{
"type": "null"
}
],
"title": "Revision",
"default": null
},
"warnings": {
"type": "array",
"items": {
"type": "string"
},
"title": "Warnings",
"maxItems": 20
},
"lookup_id": {
"anyOf": [
{
"type": "string",
"maxLength": 256
},
{
"type": "null"
}
],
"title": "Lookup Id",
"default": null
},
"providers": {
"anyOf": [
{
"type": "array",
"items": {
"$ref": "#/$defs/Provider"
},
"maxItems": 500
},
{
"type": "null"
}
],
"title": "Providers",
"default": null
},
"questions": {
"type": "array",
"items": {
"$ref": "#/$defs/Question"
},
"title": "Questions",
"maxItems": 100
},
"candidates": {
"anyOf": [
{
"type": "array",
"items": {
"$ref": "#/$defs/Candidate"
},
"maxItems": 5
},
{
"type": "null"
}
],
"title": "Candidates",
"default": null
},
"expires_at": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Expires At",
"default": null
},
"next_action": {
"anyOf": [
{
"type": "string",
"maxLength": 1000
},
{
"type": "null"
}
],
"title": "Next Action",
"default": null
},
"required_field": {
"anyOf": [
{
"type": "string",
"const": "unit"
},
{
"type": "null"
}
],
"title": "Required Field",
"default": null
},
"schema_version": {
"type": "integer",
"const": 4,
"title": "Schema Version"
},
"question_set_id": {
"anyOf": [
{
"type": "string",
"maxLength": 256
},
{
"type": "null"
}
],
"title": "Question Set Id",
"default": null
},
"clarification_type": {
"anyOf": [
{
"enum": [
"candidate_selection",
"unit_required"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Clarification Type",
"default": null
},
"normalized_address": {
"anyOf": [
{
"$ref": "#/$defs/NormalizedAddress"
},
{
"type": "null"
}
],
"default": null
},
"retry_after_seconds": {
"anyOf": [
{
"type": "integer",
"maximum": 300,
"minimum": 1
},
{
"type": "null"
}
],
"title": "Retry After Seconds",
"default": null
}
},
"additionalProperties": false
}check_availability annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}validate_order — Validate internet order
Open-world
Start: {"lookup_id":"<returned lookup_id>","offer_id":"<returned offer_id>"}. Poll: {"checkout_id":"<returned checkout_id>"}. Edit: {"checkout_id":"<returned checkout_id>","expected_revision":<current revision>,"details":{<changed fields>}}. Use exactly one shape. Customer, installation, consents and internet_addons belong inside details, never at the root. Start a checkout only when the customer asks to order. Each call waits for progress; while checking, poll with checkout_id only. 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.
validate_order input schema
{
"type": "object",
"$defs": {
"OrderDetails": {
"type": "object",
"title": "OrderDetails",
"properties": {
"consents": {
"anyOf": [
{
"type": "object",
"additionalProperties": {
"type": "boolean"
}
},
{
"type": "null"
}
],
"title": "Consents",
"default": null,
"description": "Customer consent choices at details.consents, using returned consent names."
},
"customer": {
"anyOf": [
{
"$ref": "#/$defs/CustomerDetails"
},
{
"type": "null"
}
],
"default": null
},
"installation": {
"anyOf": [
{
"$ref": "#/$defs/InstallationDetails"
},
{
"type": "null"
}
],
"default": null
},
"internet_addons": {
"anyOf": [
{
"type": "array",
"items": {
"$ref": "#/$defs/EquipmentSelection"
},
"maxItems": 100
},
{
"type": "null"
}
],
"title": "Internet Addons",
"default": null,
"description": "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."
}
},
"description": "Edit payload nested inside validate_order.details, never root tool arguments.",
"additionalProperties": false
},
"MailingAddress": {
"type": "object",
"title": "MailingAddress",
"properties": {
"city": {
"anyOf": [
{
"type": "string",
"maxLength": 100
},
{
"type": "null"
}
],
"title": "City",
"default": null
},
"line1": {
"anyOf": [
{
"type": "string",
"maxLength": 300
},
{
"type": "null"
}
],
"title": "Line1",
"default": null
},
"line2": {
"anyOf": [
{
"type": "string",
"maxLength": 100
},
{
"type": "null"
}
],
"title": "Line2",
"default": null
},
"state": {
"anyOf": [
{
"type": "string",
"pattern": "^[A-Z]{2}$"
},
{
"type": "null"
}
],
"title": "State",
"default": null
},
"postal_code": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{5}(?:-\\d{4})?$"
},
{
"type": "null"
}
],
"title": "Postal Code",
"default": null
},
"same_as_service": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Same As Service",
"default": null
}
},
"additionalProperties": false
},
"PreferredDates": {
"type": "object",
"title": "PreferredDates",
"properties": {
"first": {
"anyOf": [
{
"$ref": "#/$defs/InstallationChoice"
},
{
"type": "null"
}
],
"default": null
},
"second": {
"anyOf": [
{
"$ref": "#/$defs/InstallationChoice"
},
{
"type": "null"
}
],
"default": null
}
},
"additionalProperties": false
},
"CustomerDetails": {
"type": "object",
"title": "CustomerDetails",
"properties": {
"email": {
"anyOf": [
{
"type": "string",
"maxLength": 254
},
{
"type": "null"
}
],
"title": "Email",
"default": null
},
"last_name": {
"anyOf": [
{
"type": "string",
"maxLength": 100
},
{
"type": "null"
}
],
"title": "Last Name",
"default": null
},
"first_name": {
"anyOf": [
{
"type": "string",
"maxLength": 100
},
{
"type": "null"
}
],
"title": "First Name",
"default": null
},
"preferences": {
"anyOf": [
{
"$ref": "#/$defs/BillingPreferences"
},
{
"type": "null"
}
],
"default": null
},
"service_pin": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{4}$"
},
{
"type": "null"
}
],
"title": "Service Pin",
"default": null
},
"phone_number": {
"anyOf": [
{
"type": "string",
"maxLength": 40
},
{
"type": "null"
}
],
"title": "Phone Number",
"default": null
},
"date_of_birth": {
"anyOf": [
{
"type": "string",
"format": "date"
},
{
"type": "null"
}
],
"title": "Date Of Birth",
"default": null
},
"mailing_address": {
"anyOf": [
{
"$ref": "#/$defs/MailingAddress"
},
{
"type": "null"
}
],
"default": null
}
},
"additionalProperties": false
},
"BillingPreferences": {
"type": "object",
"title": "BillingPreferences",
"properties": {
"auto_pay": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Auto Pay",
"default": null
},
"paperless_billing": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Paperless Billing",
"default": null
}
},
"additionalProperties": false
},
"EquipmentSelection": {
"type": "object",
"title": "EquipmentSelection",
"required": [
"option_id",
"quantity"
],
"properties": {
"quantity": {
"type": "integer",
"title": "Quantity",
"minimum": 1
},
"option_id": {
"type": "string",
"title": "Option Id",
"maxLength": 256,
"minLength": 1
}
},
"additionalProperties": false
},
"InstallationChoice": {
"type": "object",
"title": "InstallationChoice",
"properties": {
"date": {
"anyOf": [
{
"type": "string",
"format": "date"
},
{
"type": "null"
}
],
"title": "Date",
"default": null
},
"time_window": {
"anyOf": [
{
"enum": [
"8:00 AM - 12:00 PM (Local Time)",
"12:00 PM - 5:00 PM (Local Time)"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Time Window",
"default": null
}
},
"additionalProperties": false
},
"InstallationDetails": {
"type": "object",
"title": "InstallationDetails",
"properties": {
"type": {
"anyOf": [
{
"enum": [
"self",
"professional"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Type",
"default": null
},
"preferred_dates": {
"anyOf": [
{
"$ref": "#/$defs/PreferredDates"
},
{
"type": "null"
}
],
"default": null
},
"desired_service_start_date": {
"anyOf": [
{
"type": "string",
"format": "date"
},
{
"type": "null"
}
],
"title": "Desired Service Start Date",
"default": null
}
},
"additionalProperties": false
}
},
"title": "validate_orderArguments",
"properties": {
"details": {
"anyOf": [
{
"$ref": "#/$defs/OrderDetails"
},
{
"type": "null"
}
],
"default": null
},
"offer_id": {
"anyOf": [
{
"type": "string",
"maxLength": 256,
"minLength": 1
},
{
"type": "null"
}
],
"title": "Offer Id",
"default": null
},
"lookup_id": {
"anyOf": [
{
"type": "string",
"maxLength": 256,
"minLength": 1
},
{
"type": "null"
}
],
"title": "Lookup Id",
"default": null
},
"checkout_id": {
"anyOf": [
{
"type": "string",
"maxLength": 256,
"minLength": 1
},
{
"type": "null"
}
],
"title": "Checkout Id",
"default": null
},
"expected_revision": {
"anyOf": [
{
"type": "integer",
"minimum": 1
},
{
"type": "null"
}
],
"title": "Expected Revision",
"default": null
}
},
"additionalProperties": false
}validate_order output schema
{
"type": "object",
"$defs": {
"FeeFacts": {
"type": "object",
"title": "FeeFacts",
"required": [
"currency"
],
"properties": {
"currency": {
"type": "string",
"title": "Currency",
"pattern": "^[A-Z]{3}$"
},
"activation_cents": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Activation Cents",
"default": null
},
"self_installation_cents": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Self Installation Cents",
"default": null
},
"recurring_equipment_cents": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Recurring Equipment Cents",
"default": null
},
"professional_installation_cents": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Professional Installation Cents",
"default": null
}
},
"additionalProperties": false
},
"PlanFacts": {
"type": "object",
"title": "PlanFacts",
"required": [
"name",
"pricing",
"fees",
"contract_terms"
],
"properties": {
"fees": {
"$ref": "#/$defs/FeeFacts"
},
"name": {
"type": "string",
"title": "Name",
"maxLength": 300,
"minLength": 1
},
"pricing": {
"$ref": "#/$defs/MoneyFacts"
},
"conditions": {
"type": "array",
"items": {
"type": "string"
},
"title": "Conditions",
"maxItems": 50
},
"data_limit": {
"anyOf": [
{
"type": "string"
},
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Data Limit",
"default": null
},
"technology": {
"anyOf": [
{
"type": "string",
"maxLength": 100
},
{
"type": "null"
}
],
"title": "Technology",
"default": null
},
"upload_mbps": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Upload Mbps",
"default": null
},
"download_mbps": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Download Mbps",
"default": null
},
"contract_terms": {
"$ref": "#/$defs/ContractTerms"
}
},
"additionalProperties": false
},
"CartReview": {
"type": "object",
"title": "CartReview",
"required": [
"selected_plan",
"included_products",
"one_time_fees",
"total_amount"
],
"properties": {
"total_amount": {
"$ref": "#/$defs/OrderAmount"
},
"monthly_total": {
"anyOf": [
{
"$ref": "#/$defs/OrderAmount"
},
{
"type": "null"
}
],
"default": null
},
"one_time_fees": {
"type": "array",
"items": {
"$ref": "#/$defs/OneTimeFee"
},
"title": "One Time Fees",
"maxItems": 100
},
"selected_plan": {
"$ref": "#/$defs/IncludedProduct"
},
"bundle_discount": {
"anyOf": [
{
"$ref": "#/$defs/OrderAmount"
},
{
"type": "null"
}
],
"default": null
},
"due_at_activation": {
"anyOf": [
{
"$ref": "#/$defs/OrderAmount"
},
{
"type": "null"
}
],
"default": null
},
"included_products": {
"$ref": "#/$defs/IncludedProducts"
}
},
"additionalProperties": false
},
"MoneyFacts": {
"type": "object",
"title": "MoneyFacts",
"required": [
"currency"
],
"properties": {
"currency": {
"type": "string",
"title": "Currency",
"pattern": "^[A-Z]{3}$"
},
"intro_months": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Intro Months",
"default": null
},
"monthly_cents": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Monthly Cents",
"default": null
},
"regular_monthly_cents": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Regular Monthly Cents",
"default": null
}
},
"additionalProperties": false
},
"OneTimeFee": {
"type": "object",
"title": "OneTimeFee",
"required": [
"name",
"description",
"pricing",
"fee_type"
],
"properties": {
"name": {
"type": "string",
"title": "Name",
"maxLength": 300,
"minLength": 1
},
"pricing": {
"$ref": "#/$defs/OrderAmount"
},
"fee_type": {
"type": "string",
"title": "Fee Type",
"maxLength": 100,
"minLength": 1
},
"description": {
"type": "string",
"title": "Description",
"maxLength": 1000,
"minLength": 1
}
},
"additionalProperties": false
},
"ErrorDetail": {
"type": "object",
"title": "ErrorDetail",
"required": [
"code",
"message",
"retryable",
"next_action"
],
"properties": {
"code": {
"enum": [
"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"
],
"type": "string",
"title": "Code"
},
"message": {
"type": "string",
"title": "Message",
"maxLength": 500,
"minLength": 1
},
"retryable": {
"type": "boolean",
"title": "Retryable"
},
"next_action": {
"type": "string",
"title": "Next Action",
"maxLength": 500,
"minLength": 1
},
"field_errors": {
"anyOf": [
{
"type": "object",
"additionalProperties": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Field Errors",
"default": null
},
"correlation_id": {
"anyOf": [
{
"type": "string",
"maxLength": 128
},
{
"type": "null"
}
],
"title": "Correlation Id",
"default": null
},
"retry_after_seconds": {
"anyOf": [
{
"type": "integer",
"maximum": 86400,
"minimum": 1
},
{
"type": "null"
}
],
"title": "Retry After Seconds",
"default": null
}
},
"additionalProperties": false
},
"OrderAmount": {
"type": "object",
"title": "OrderAmount",
"required": [
"amount_cents",
"amount_currency"
],
"properties": {
"amount_cents": {
"type": "integer",
"title": "Amount Cents",
"minimum": 0
},
"amount_currency": {
"type": "string",
"title": "Amount Currency",
"pattern": "^[A-Z]{3}$"
}
},
"additionalProperties": false
},
"ContractTerms": {
"type": "object",
"title": "ContractTerms",
"properties": {
"months": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Months",
"default": null
},
"required": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Required",
"default": null
}
},
"additionalProperties": false
},
"ReviewAddress": {
"type": "object",
"title": "ReviewAddress",
"required": [
"display"
],
"properties": {
"unit": {
"anyOf": [
{
"type": "string",
"maxLength": 100
},
{
"type": "null"
}
],
"title": "Unit",
"default": null
},
"display": {
"type": "string",
"title": "Display",
"maxLength": 500,
"minLength": 1
}
},
"additionalProperties": false
},
"PreferredDates": {
"type": "object",
"title": "PreferredDates",
"properties": {
"first": {
"anyOf": [
{
"$ref": "#/$defs/InstallationChoice"
},
{
"type": "null"
}
],
"default": null
},
"second": {
"anyOf": [
{
"$ref": "#/$defs/InstallationChoice"
},
{
"type": "null"
}
],
"default": null
}
},
"additionalProperties": false
},
"EquipmentOption": {
"type": "object",
"title": "EquipmentOption",
"required": [
"option_id",
"name",
"selection_type",
"included",
"unit_pricing",
"max_quantity",
"selected_quantity"
],
"properties": {
"name": {
"type": "string",
"title": "Name",
"maxLength": 300,
"minLength": 1
},
"included": {
"type": "boolean",
"title": "Included"
},
"required": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Required",
"default": null
},
"option_id": {
"type": "string",
"title": "Option Id",
"maxLength": 256,
"minLength": 1
},
"max_quantity": {
"type": "integer",
"title": "Max Quantity",
"minimum": 1
},
"unit_pricing": {
"$ref": "#/$defs/OrderAmount"
},
"selection_type": {
"enum": [
"radio",
"checkbox"
],
"type": "string",
"title": "Selection Type"
},
"selected_quantity": {
"type": "integer",
"title": "Selected Quantity",
"minimum": 0
}
},
"additionalProperties": false
},
"IncludedProduct": {
"type": "object",
"title": "IncludedProduct",
"required": [
"name",
"quantity",
"unit_pricing",
"total_pricing"
],
"properties": {
"name": {
"type": "string",
"title": "Name",
"maxLength": 300,
"minLength": 1
},
"quantity": {
"type": "integer",
"title": "Quantity",
"minimum": 1
},
"unit_pricing": {
"$ref": "#/$defs/OrderAmount"
},
"total_pricing": {
"$ref": "#/$defs/OrderAmount"
}
},
"additionalProperties": false
},
"IncludedProducts": {
"type": "object",
"title": "IncludedProducts",
"properties": {
"internet": {
"type": "array",
"items": {
"$ref": "#/$defs/IncludedProduct"
},
"title": "Internet",
"maxItems": 100
},
"television": {
"type": "array",
"items": {
"$ref": "#/$defs/IncludedProduct"
},
"title": "Television",
"maxItems": 100
},
"television_add_ons": {
"type": "array",
"items": {
"$ref": "#/$defs/IncludedProduct"
},
"title": "Television Add Ons",
"maxItems": 100
}
},
"additionalProperties": false
},
"ReadyOrderReview": {
"type": "object",
"title": "ReadyOrderReview",
"required": [
"provider_name",
"selected_offer",
"included_products",
"one_time_fees",
"total_amount",
"service_address",
"unknown_charges_remain_unknown"
],
"properties": {
"consents": {
"type": "object",
"title": "Consents",
"additionalProperties": {
"type": "boolean"
}
},
"installation": {
"anyOf": [
{
"$ref": "#/$defs/InstallationDetails"
},
{
"type": "null"
}
],
"default": null
},
"total_amount": {
"$ref": "#/$defs/OrderAmount"
},
"monthly_total": {
"anyOf": [
{
"$ref": "#/$defs/OrderAmount"
},
{
"type": "null"
}
],
"default": null
},
"one_time_fees": {
"type": "array",
"items": {
"$ref": "#/$defs/OneTimeFee"
},
"title": "One Time Fees",
"maxItems": 100
},
"provider_name": {
"type": "string",
"title": "Provider Name",
"maxLength": 300,
"minLength": 1
},
"selected_offer": {
"$ref": "#/$defs/PlanFacts"
},
"bundle_discount": {
"anyOf": [
{
"$ref": "#/$defs/OrderAmount"
},
{
"type": "null"
}
],
"default": null
},
"service_address": {
"$ref": "#/$defs/ReviewAddress"
},
"due_at_activation": {
"anyOf": [
{
"$ref": "#/$defs/OrderAmount"
},
{
"type": "null"
}
],
"default": null
},
"included_products": {
"$ref": "#/$defs/IncludedProducts"
},
"billing_preferences": {
"anyOf": [
{
"$ref": "#/$defs/BillingPreferences"
},
{
"type": "null"
}
],
"default": null
},
"unknown_charges_remain_unknown": {
"type": "boolean",
"const": true,
"title": "Unknown Charges Remain Unknown"
}
},
"additionalProperties": false
},
"BillingPreferences": {
"type": "object",
"title": "BillingPreferences",
"properties": {
"auto_pay": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Auto Pay",
"default": null
},
"paperless_billing": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Paperless Billing",
"default": null
}
},
"additionalProperties": false
},
"InstallationChoice": {
"type": "object",
"title": "InstallationChoice",
"properties": {
"date": {
"anyOf": [
{
"type": "string",
"format": "date"
},
{
"type": "null"
}
],
"title": "Date",
"default": null
},
"time_window": {
"anyOf": [
{
"enum": [
"8:00 AM - 12:00 PM (Local Time)",
"12:00 PM - 5:00 PM (Local Time)"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Time Window",
"default": null
}
},
"additionalProperties": false
},
"OfferChangedReview": {
"type": "object",
"title": "OfferChangedReview",
"required": [
"previous_offer",
"current_offer",
"changed_fields"
],
"properties": {
"current_cart": {
"anyOf": [
{
"$ref": "#/$defs/CartReview"
},
{
"type": "null"
}
],
"default": null
},
"current_offer": {
"$ref": "#/$defs/PlanFacts"
},
"previous_cart": {
"anyOf": [
{
"$ref": "#/$defs/CartReview"
},
{
"type": "null"
}
],
"default": null
},
"changed_fields": {
"type": "array",
"items": {
"type": "string"
},
"title": "Changed Fields",
"maxItems": 100,
"minItems": 1
},
"previous_offer": {
"$ref": "#/$defs/PlanFacts"
}
},
"additionalProperties": false
},
"InstallationDetails": {
"type": "object",
"title": "InstallationDetails",
"properties": {
"type": {
"anyOf": [
{
"enum": [
"self",
"professional"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Type",
"default": null
},
"preferred_dates": {
"anyOf": [
{
"$ref": "#/$defs/PreferredDates"
},
{
"type": "null"
}
],
"default": null
},
"desired_service_start_date": {
"anyOf": [
{
"type": "string",
"format": "date"
},
{
"type": "null"
}
],
"title": "Desired Service Start Date",
"default": null
}
},
"additionalProperties": false
}
},
"title": "ValidationEnvelope",
"required": [
"schema_version",
"status"
],
"properties": {
"error": {
"anyOf": [
{
"$ref": "#/$defs/ErrorDetail"
},
{
"type": "null"
}
],
"default": null
},
"review": {
"anyOf": [
{
"$ref": "#/$defs/ReadyOrderReview"
},
{
"$ref": "#/$defs/OfferChangedReview"
},
{
"type": "null"
}
],
"title": "Review",
"default": null
},
"status": {
"enum": [
"checking",
"needs_information",
"ready",
"offer_changed",
"unavailable",
"expired",
"failed",
"error"
],
"type": "string",
"title": "Status"
},
"revision": {
"anyOf": [
{
"type": "integer",
"minimum": 1
},
{
"type": "null"
}
],
"title": "Revision",
"default": null
},
"expires_at": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Expires At",
"default": null
},
"terms_hash": {
"anyOf": [
{
"type": "string",
"maxLength": 256
},
{
"type": "null"
}
],
"title": "Terms Hash",
"default": null
},
"checkout_id": {
"anyOf": [
{
"type": "string",
"maxLength": 256
},
{
"type": "null"
}
],
"title": "Checkout Id",
"default": null
},
"next_action": {
"anyOf": [
{
"type": "string",
"maxLength": 1000
},
{
"type": "null"
}
],
"title": "Next Action",
"default": null
},
"field_errors": {
"type": "object",
"title": "Field Errors",
"additionalProperties": {
"type": "string"
}
},
"schema_version": {
"type": "integer",
"const": 4,
"title": "Schema Version"
},
"required_fields": {
"type": "array",
"items": {
"type": "string"
},
"title": "Required Fields",
"maxItems": 100
},
"validation_token": {
"anyOf": [
{
"type": "string",
"maxLength": 512
},
{
"type": "null"
}
],
"title": "Validation Token",
"default": null
},
"equipment_options": {
"type": "array",
"items": {
"$ref": "#/$defs/EquipmentOption"
},
"title": "Equipment Options",
"maxItems": 100
},
"retry_after_seconds": {
"anyOf": [
{
"type": "integer",
"maximum": 300,
"minimum": 1
},
{
"type": "null"
}
],
"title": "Retry After Seconds",
"default": null
}
},
"additionalProperties": false
}validate_order annotations
{
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}create_order — Create internet order
Advertised destructiveOpen-world
Only after presenting the current review and obtaining authorization for its terms_hash, commit with its validation_token and one stable idempotency_key. After a lost or uncertain response, call get_order first; do not blindly resubmit.
create_order input schema
{
"type": "object",
"$defs": {
"Confirmation": {
"type": "object",
"title": "Confirmation",
"required": [
"terms_hash",
"confirmed"
],
"properties": {
"confirmed": {
"type": "boolean",
"const": true,
"title": "Confirmed"
},
"terms_hash": {
"type": "string",
"title": "Terms Hash",
"maxLength": 256,
"minLength": 1
}
},
"additionalProperties": false
}
},
"title": "create_orderArguments",
"required": [
"checkout_id",
"validation_token",
"idempotency_key",
"confirmation"
],
"properties": {
"checkout_id": {
"type": "string",
"title": "Checkout Id",
"maxLength": 256,
"minLength": 1
},
"confirmation": {
"$ref": "#/$defs/Confirmation"
},
"idempotency_key": {
"type": "string",
"title": "Idempotency Key",
"maxLength": 128,
"minLength": 1
},
"validation_token": {
"type": "string",
"title": "Validation Token",
"maxLength": 256,
"minLength": 1
}
},
"additionalProperties": false
}create_order output schema
{
"type": "object",
"$defs": {
"Evidence": {
"type": "object",
"title": "Evidence",
"required": [
"kind",
"recorded_at"
],
"properties": {
"kind": {
"type": "string",
"title": "Kind",
"maxLength": 100,
"minLength": 1
},
"recorded_at": {
"type": "string",
"title": "Recorded At",
"format": "date-time"
}
},
"additionalProperties": false
},
"FeeFacts": {
"type": "object",
"title": "FeeFacts",
"required": [
"currency"
],
"properties": {
"currency": {
"type": "string",
"title": "Currency",
"pattern": "^[A-Z]{3}$"
},
"activation_cents": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Activation Cents",
"default": null
},
"self_installation_cents": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Self Installation Cents",
"default": null
},
"recurring_equipment_cents": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Recurring Equipment Cents",
"default": null
},
"professional_installation_cents": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Professional Installation Cents",
"default": null
}
},
"additionalProperties": false
},
"PlanFacts": {
"type": "object",
"title": "PlanFacts",
"required": [
"name",
"pricing",
"fees",
"contract_terms"
],
"properties": {
"fees": {
"$ref": "#/$defs/FeeFacts"
},
"name": {
"type": "string",
"title": "Name",
"maxLength": 300,
"minLength": 1
},
"pricing": {
"$ref": "#/$defs/MoneyFacts"
},
"conditions": {
"type": "array",
"items": {
"type": "string"
},
"title": "Conditions",
"maxItems": 50
},
"data_limit": {
"anyOf": [
{
"type": "string"
},
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Data Limit",
"default": null
},
"technology": {
"anyOf": [
{
"type": "string",
"maxLength": 100
},
{
"type": "null"
}
],
"title": "Technology",
"default": null
},
"upload_mbps": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Upload Mbps",
"default": null
},
"download_mbps": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Download Mbps",
"default": null
},
"contract_terms": {
"$ref": "#/$defs/ContractTerms"
}
},
"additionalProperties": false
},
"MoneyFacts": {
"type": "object",
"title": "MoneyFacts",
"required": [
"currency"
],
"properties": {
"currency": {
"type": "string",
"title": "Currency",
"pattern": "^[A-Z]{3}$"
},
"intro_months": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Intro Months",
"default": null
},
"monthly_cents": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Monthly Cents",
"default": null
},
"regular_monthly_cents": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Regular Monthly Cents",
"default": null
}
},
"additionalProperties": false
},
"ErrorDetail": {
"type": "object",
"title": "ErrorDetail",
"required": [
"code",
"message",
"retryable",
"next_action"
],
"properties": {
"code": {
"enum": [
"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"
],
"type": "string",
"title": "Code"
},
"message": {
"type": "string",
"title": "Message",
"maxLength": 500,
"minLength": 1
},
"retryable": {
"type": "boolean",
"title": "Retryable"
},
"next_action": {
"type": "string",
"title": "Next Action",
"maxLength": 500,
"minLength": 1
},
"field_errors": {
"anyOf": [
{
"type": "object",
"additionalProperties": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Field Errors",
"default": null
},
"correlation_id": {
"anyOf": [
{
"type": "string",
"maxLength": 128
},
{
"type": "null"
}
],
"title": "Correlation Id",
"default": null
},
"retry_after_seconds": {
"anyOf": [
{
"type": "integer",
"maximum": 86400,
"minimum": 1
},
{
"type": "null"
}
],
"title": "Retry After Seconds",
"default": null
}
},
"additionalProperties": false
},
"ContractTerms": {
"type": "object",
"title": "ContractTerms",
"properties": {
"months": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Months",
"default": null
},
"required": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Required",
"default": null
}
},
"additionalProperties": false
}
},
"title": "OrderEnvelope",
"required": [
"schema_version",
"status"
],
"properties": {
"error": {
"anyOf": [
{
"$ref": "#/$defs/ErrorDetail"
},
{
"type": "null"
}
],
"default": null
},
"status": {
"enum": [
"queued",
"submitting",
"accepted_by_fulfillment",
"rejected_by_fulfillment",
"submission_unknown",
"not_submitted",
"error"
],
"type": "string",
"title": "Status"
},
"evidence": {
"anyOf": [
{
"$ref": "#/$defs/Evidence"
},
{
"type": "null"
}
],
"default": null
},
"order_id": {
"anyOf": [
{
"type": "string",
"maxLength": 256
},
{
"type": "null"
}
],
"title": "Order Id",
"default": null
},
"next_action": {
"anyOf": [
{
"type": "string",
"maxLength": 1000
},
{
"type": "null"
}
],
"title": "Next Action",
"default": null
},
"submitted_at": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Submitted At",
"default": null
},
"provider_name": {
"anyOf": [
{
"type": "string",
"maxLength": 300
},
{
"type": "null"
}
],
"title": "Provider Name",
"default": null
},
"schema_version": {
"type": "integer",
"const": 4,
"title": "Schema Version"
},
"last_checked_at": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Last Checked At",
"default": null
},
"selected_offer_summary": {
"anyOf": [
{
"$ref": "#/$defs/PlanFacts"
},
{
"type": "null"
}
],
"default": null
}
},
"additionalProperties": false
}create_order annotations
{
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}get_order — Get internet order
Advertised read-onlyOpen-world
Retrieve recorded fulfillment evidence with checkout_id, especially after a lost or uncertain create_order response. Public statuses do not prove ISP acceptance or installation confirmation.
get_order input schema
{
"type": "object",
"title": "get_orderArguments",
"required": [
"checkout_id"
],
"properties": {
"checkout_id": {
"type": "string",
"title": "Checkout Id",
"maxLength": 256,
"minLength": 1
}
},
"additionalProperties": false
}get_order output schema
{
"type": "object",
"$defs": {
"Evidence": {
"type": "object",
"title": "Evidence",
"required": [
"kind",
"recorded_at"
],
"properties": {
"kind": {
"type": "string",
"title": "Kind",
"maxLength": 100,
"minLength": 1
},
"recorded_at": {
"type": "string",
"title": "Recorded At",
"format": "date-time"
}
},
"additionalProperties": false
},
"FeeFacts": {
"type": "object",
"title": "FeeFacts",
"required": [
"currency"
],
"properties": {
"currency": {
"type": "string",
"title": "Currency",
"pattern": "^[A-Z]{3}$"
},
"activation_cents": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Activation Cents",
"default": null
},
"self_installation_cents": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Self Installation Cents",
"default": null
},
"recurring_equipment_cents": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Recurring Equipment Cents",
"default": null
},
"professional_installation_cents": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Professional Installation Cents",
"default": null
}
},
"additionalProperties": false
},
"PlanFacts": {
"type": "object",
"title": "PlanFacts",
"required": [
"name",
"pricing",
"fees",
"contract_terms"
],
"properties": {
"fees": {
"$ref": "#/$defs/FeeFacts"
},
"name": {
"type": "string",
"title": "Name",
"maxLength": 300,
"minLength": 1
},
"pricing": {
"$ref": "#/$defs/MoneyFacts"
},
"conditions": {
"type": "array",
"items": {
"type": "string"
},
"title": "Conditions",
"maxItems": 50
},
"data_limit": {
"anyOf": [
{
"type": "string"
},
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Data Limit",
"default": null
},
"technology": {
"anyOf": [
{
"type": "string",
"maxLength": 100
},
{
"type": "null"
}
],
"title": "Technology",
"default": null
},
"upload_mbps": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Upload Mbps",
"default": null
},
"download_mbps": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Download Mbps",
"default": null
},
"contract_terms": {
"$ref": "#/$defs/ContractTerms"
}
},
"additionalProperties": false
},
"MoneyFacts": {
"type": "object",
"title": "MoneyFacts",
"required": [
"currency"
],
"properties": {
"currency": {
"type": "string",
"title": "Currency",
"pattern": "^[A-Z]{3}$"
},
"intro_months": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Intro Months",
"default": null
},
"monthly_cents": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Monthly Cents",
"default": null
},
"regular_monthly_cents": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Regular Monthly Cents",
"default": null
}
},
"additionalProperties": false
},
"ErrorDetail": {
"type": "object",
"title": "ErrorDetail",
"required": [
"code",
"message",
"retryable",
"next_action"
],
"properties": {
"code": {
"enum": [
"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"
],
"type": "string",
"title": "Code"
},
"message": {
"type": "string",
"title": "Message",
"maxLength": 500,
"minLength": 1
},
"retryable": {
"type": "boolean",
"title": "Retryable"
},
"next_action": {
"type": "string",
"title": "Next Action",
"maxLength": 500,
"minLength": 1
},
"field_errors": {
"anyOf": [
{
"type": "object",
"additionalProperties": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Field Errors",
"default": null
},
"correlation_id": {
"anyOf": [
{
"type": "string",
"maxLength": 128
},
{
"type": "null"
}
],
"title": "Correlation Id",
"default": null
},
"retry_after_seconds": {
"anyOf": [
{
"type": "integer",
"maximum": 86400,
"minimum": 1
},
{
"type": "null"
}
],
"title": "Retry After Seconds",
"default": null
}
},
"additionalProperties": false
},
"ContractTerms": {
"type": "object",
"title": "ContractTerms",
"properties": {
"months": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Months",
"default": null
},
"required": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Required",
"default": null
}
},
"additionalProperties": false
}
},
"title": "OrderEnvelope",
"required": [
"schema_version",
"status"
],
"properties": {
"error": {
"anyOf": [
{
"$ref": "#/$defs/ErrorDetail"
},
{
"type": "null"
}
],
"default": null
},
"status": {
"enum": [
"queued",
"submitting",
"accepted_by_fulfillment",
"rejected_by_fulfillment",
"submission_unknown",
"not_submitted",
"error"
],
"type": "string",
"title": "Status"
},
"evidence": {
"anyOf": [
{
"$ref": "#/$defs/Evidence"
},
{
"type": "null"
}
],
"default": null
},
"order_id": {
"anyOf": [
{
"type": "string",
"maxLength": 256
},
{
"type": "null"
}
],
"title": "Order Id",
"default": null
},
"next_action": {
"anyOf": [
{
"type": "string",
"maxLength": 1000
},
{
"type": "null"
}
],
"title": "Next Action",
"default": null
},
"submitted_at": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Submitted At",
"default": null
},
"provider_name": {
"anyOf": [
{
"type": "string",
"maxLength": 300
},
{
"type": "null"
}
],
"title": "Provider Name",
"default": null
},
"schema_version": {
"type": "integer",
"const": 4,
"title": "Schema Version"
},
"last_checked_at": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Last Checked At",
"default": null
},
"selected_offer_summary": {
"anyOf": [
{
"$ref": "#/$defs/PlanFacts"
},
{
"type": "null"
}
],
"default": null
}
},
"additionalProperties": false
}get_order annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}Prompts
0 advertised
Resources
2 advertised
check-internet-availability — Check internet availability
Check internet providers, plans, speeds, and known pricing at a specific U.S. street address.
check-internet-availability URI
skill://check-internet-availability/SKILL.mdorder-internet-service — Order internet service
Discover, validate, submit, and recover a Hum internet-service order through the four transactional broadband tools.
order-internet-service URI
skill://order-internet-service/SKILL.md90-day uptime
A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.
- 2026-11-07: 1 of 1 checks answered
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 1349 ms
- 95th percentile latency
- 1349 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 1349 ms · metadata changed · 4 tool(s), 2 resource(s), 0 resource template(s), 0 prompt(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
Claude Code configuration
claude mcp add --transport http hum-internet-availability-mcp https://mcp.letshum.com/mcpCodex
Codex configuration
codex mcp add hum-internet-availability-mcp --url https://mcp.letshum.com/mcpCursor
Cursor configuration
{
"mcpServers": {
"hum-internet-availability-mcp": {
"url": "https://mcp.letshum.com/mcp"
}
}
}Cline
Cline configuration
{
"mcpServers": {
"hum-internet-availability-mcp": {
"type": "streamableHttp",
"url": "https://mcp.letshum.com/mcp",
"disabled": false
}
}
}VS Code
VS Code configuration
{
"servers": {
"hum-internet-availability-mcp": {
"type": "http",
"url": "https://mcp.letshum.com/mcp"
}
}
}Gemini CLI
Gemini CLI configuration
gemini mcp add --transport http hum-internet-availability-mcp https://mcp.letshum.com/mcpClaude Desktop
Claude Desktop configuration
https://mcp.letshum.com/mcpWindsurf
Windsurf configuration
{
"mcpServers": {
"hum-internet-availability-mcp": {
"serverUrl": "https://mcp.letshum.com/mcp"
}
}
}Let your agent find its tools
Find servers like Hum Internet Availability MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.
Other data and analytics servers
Do you run Hum Internet Availability MCP?
Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.