Hum Internet Availability is an MCP server published by com.letshum, hosted at mcp.letshum.com. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 4 tools, including check_availability, validate_order, create_order, get_order.
Check internet providers, plans, speeds, and known pricing at a specific U.S. street address.
8 connections through 4 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
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.
| Parameter | Type | Description |
|---|---|---|
| unit | any | |
| address | any | |
| answers | any |
None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
| lookup_id | any |
| candidate_id | any |
| question_set_id | any |
{
"name": "check_availability",
"title": "Check broadband availability",
"description": "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.",
"inputSchema": {
"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
},
"outputSchema": {
"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
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| details | any | |
| offer_id | any | |
| lookup_id | any | |
| checkout_id | any | |
| expected_revision | any |
{
"name": "validate_order",
"title": "Validate internet order",
"description": "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.",
"inputSchema": {
"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
},
"outputSchema": {
"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
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| checkout_id * | string | |
| confirmation * | ref | |
| idempotency_key * | string | |
| validation_token * | string |
{
"name": "create_order",
"title": "Create internet order",
"description": "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.",
"inputSchema": {
"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
},
"outputSchema": {
"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
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| checkout_id * | string |
{
"name": "get_order",
"title": "Get internet order",
"description": "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.",
"inputSchema": {
"type": "object",
"title": "get_orderArguments",
"required": [
"checkout_id"
],
"properties": {
"checkout_id": {
"type": "string",
"title": "Checkout Id",
"maxLength": 256,
"minLength": 1
}
},
"additionalProperties": false
},
"outputSchema": {
"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
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Hum answers which home internet providers, plans, speeds and prices are available at a U.S. street address. Call check_availability with the full address, including any apartment or unit. Each call waits for live results; if the status is still checking, call it again with the returned lookup_id in the same turn rather than ending your turn, and if you must answer early, say the results are partial. Describe live-qualified offers as confirmed at the address. Providers reported only in FCC data for the area were not checked at the address: never call them available, unavailable or not qualified there. Never guess an address, unit, answer, price or provider, and use only returned IDs. Start an order only when the customer asks to order: validate_order prepares an exact review without ordering, and create_order needs the customer's explicit approval of that review. After a lost or uncertain create_order response, call get_order instead of resubmitting. Do not collect card data, SSNs, account passwords or payment authorization. Optional reading: https://mcp.letshum.com/skills/check-internet-availability/SKILL.md and https://mcp.letshum.com/skills/order-internet-service/SKILL.md.
Names, descriptions and schemas were written by the server and are shown as data.