Cursor
Grok Bot
Grok
MuseTitle96/100
Find internet providers for a US ZIP or address
The title clearly communicates the tool’s action and subject. Keep it concise.
Description98/100
Check which internet providers actually serve a US address or ZIP code, using real FCC broadband coverage data. Returns the full FCC answer: per-technology provider rows and ranked brand cards, with raw homes-passed (bsl) and area-coverage (cov) percentages, max filed speeds, FCC filing-quirk flags, and a link to full results and next steps on getconnectedfast.com. Provide exactly ONE of: zip (answers for the whole ZIP) or address (answers for that exact location). An empty result means the FCC lists no serviceable locations there. No pricing data.
The description explains the capability, when to use it, and what to expect.
Inputs75/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
zip
US ZIP code of the area to check. Answers for the whole ZIP: every provider serving any part of it. Use this for area-level questions.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
address
US street address of the one location to check, with city and state (e.g. '9400 S Cicero Ave, Oak Lawn, IL'). Answers for that exact location only. Rate limited - prefer zip unless the user needs an exact address answer.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
Annotations100/100
All four behavior hints are declared.
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}Output schema84/100
The output schema explains the structured result.
View output schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query",
"match",
"h3_hex",
"count",
"providers",
"cards",
"see_all_results_url",
"field_guide",
"data_source",
"disclosure"
],
"properties": {
"note": {
"type": "string",
"description": "Important context about the answer"
},
"cards": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"required": [
"provider",
"provider_slug",
"brand_slug",
"tech",
"techs",
"max_download_mbps",
"max_upload_mbps",
"speed_note",
"group",
"position",
"badge",
"source",
"next_step_url"
],
"properties": {
"bsl": {
"type": "number",
"description": "Percent (0-100) of the ZIP's residential broadband-serviceable locations this provider passes - the HOMES number. 0 is a real value: listed here but passing under 0.5% of homes. Only on residential whole-ZIP answers, terrestrial fixed technologies."
},
"cov": {
"type": "number",
"description": "Percent (0-100) of the ZIP's serviceable AREA covered by this provider and technology - NOT homes. Never present cov as a share of homes; use bsl for homes claims. Only on whole-ZIP answers."
},
"tech": {
"type": "string",
"description": "The surviving row's technology - what the speeds describe"
},
"badge": {
"anyOf": [
{
"enum": [
"recommended"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "Only position 1 can carry 'recommended': our top pick for this location"
},
"group": {
"enum": [
"featured",
"more",
"limited"
],
"type": "string",
"description": "Presentation group: 'featured' = top cards, 'more' = the rest, 'limited' = sub-10/1 Mbps footnote rows"
},
"techs": {
"type": "array",
"items": {
"type": "string"
},
"description": "Every technology the brand files here, best quality first"
},
"source": {
"enum": [
"fcc",
"footprint_override"
],
"type": "string",
"description": "'fcc' = real availability filing; 'footprint_override' = marketing-footprint gap-fill (known-served ZIP whose FCC rows lag)"
},
"position": {
"type": "number",
"description": "1-based rank across all groups"
},
"provider": {
"type": "string",
"description": "Display name (consumer brand)"
},
"brand_slug": {
"type": "string",
"description": "Canonical brand identity after alias collapse"
},
"speed_note": {
"anyOf": [
{
"enum": [
"below_10_1",
"at_least_10_1_below_25_3"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "FCC filing quirk for sub-25/3 Mbps buckets. 'below_10_1': the filed 0/0 means real service slower than 10/1 Mbps, not zero service. 'at_least_10_1_below_25_3': at least 10/1 but under 25/3 Mbps (either direction may actually be faster). null: speeds as filed."
},
"next_step_url": {
"type": "string",
"description": "Results page for this location on getconnectedfast.com, opened to compare options and get help connecting with this provider. Carries only the ZIP, this provider's slug, and campaign tags (utm_source=mcp) - nothing about the user."
},
"provider_slug": {
"type": "string",
"description": "Slug of the surviving FCC row"
},
"max_upload_mbps": {
"type": "number"
},
"max_download_mbps": {
"type": "number"
}
},
"additionalProperties": false
}
},
{
"type": "null"
}
],
"description": "Ranked presentation, one card per brand (alias/multi-tech rows collapsed to the strongest product); null if ranking failed"
},
"count": {
"type": "number",
"description": "Length of providers[]"
},
"match": {
"enum": [
"zip",
"hex"
],
"type": "string",
"description": "'zip' = whole-ZIP union (a specific address inside it may have fewer options); 'hex' = exact-point answer (~0.7 sq km hex)"
},
"query": {
"type": "object",
"required": [
"lat",
"lng",
"service_type"
],
"properties": {
"lat": {
"type": "number"
},
"lng": {
"type": "number"
},
"zip": {
"type": "string",
"description": "Echoed on zip lookups only"
},
"service_type": {
"enum": [
"residential",
"business"
],
"type": "string"
},
"matched_place": {
"type": "string",
"description": "'City, ST' for the location, when the match parses"
},
"matched_address": {
"type": "string",
"description": "Census-matched address, on address lookups only"
}
},
"description": "Echo of the resolved lookup input",
"additionalProperties": false
},
"h3_hex": {
"type": [
"string",
"null"
],
"description": "H3 res-8 cell of a point answer; null on whole-ZIP answers"
},
"bsl_total": {
"type": "number",
"description": "The bsl denominator: residential broadband-serviceable locations in the ZIP. Residential whole-ZIP answers only."
},
"providers": {
"type": "array",
"items": {
"type": "object",
"required": [
"provider",
"provider_id",
"tech",
"max_download_mbps",
"max_upload_mbps",
"speed_note"
],
"properties": {
"bsl": {
"type": "number",
"description": "Percent (0-100) of the ZIP's residential broadband-serviceable locations this provider passes - the HOMES number. 0 is a real value: listed here but passing under 0.5% of homes. Only on residential whole-ZIP answers, terrestrial fixed technologies."
},
"cov": {
"type": "number",
"description": "Percent (0-100) of the ZIP's serviceable AREA covered by this provider and technology - NOT homes. Never present cov as a share of homes; use bsl for homes claims. Only on whole-ZIP answers."
},
"tech": {
"type": "string",
"description": "FCC technology label, e.g. Fiber, Cable, DSL, Fixed Wireless"
},
"provider": {
"type": "string",
"description": "FCC-filed brand name"
},
"speed_note": {
"anyOf": [
{
"enum": [
"below_10_1",
"at_least_10_1_below_25_3"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "FCC filing quirk for sub-25/3 Mbps buckets. 'below_10_1': the filed 0/0 means real service slower than 10/1 Mbps, not zero service. 'at_least_10_1_below_25_3': at least 10/1 but under 25/3 Mbps (either direction may actually be faster). null: speeds as filed."
},
"provider_id": {
"type": "string",
"description": "Name-derived slug of the FCC brand name"
},
"max_upload_mbps": {
"type": "number"
},
"max_download_mbps": {
"type": "number"
}
},
"additionalProperties": false
},
"description": "Pure FCC availability rows, one per provider+technology, fastest download first"
},
"disclosure": {
"type": "string",
"description": "Affiliate disclosure - relay to the user once, in plain words"
},
"data_source": {
"type": "string",
"description": "Data attribution and honesty caveats - relay to the user"
},
"field_guide": {
"type": "object",
"description": "How to read match/providers/cards/bsl/cov/speed_note",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
},
"see_all_results_url": {
"type": "string",
"description": "Full, shareable results page for this location on getconnectedfast.com"
}
},
"additionalProperties": false
}