Server definition
- Hash
- sha256:8d96b47c05852b626094d055f061ea40824bec01b88816277f86ec3583ce2679
- What it is
- What a remote MCP server returned when asked what it offers: 9 tools
The blob, as servednamed by its sha256
{
"instructions": "FCC broadband data server providing access to Form 477 (2015–2021) and BDC (2022+) datasets.\n- Start with fcc_geocode_block to convert coordinates to census block FIPS for address-level queries\n- Use fcc_get_coverage_summary for equity/policy analysis at state, county, or national level\n- Use fcc_find_underserved for BEAD program eligibility and funding analysis\n- BDC tools (fcc_list_downloads) require FCC_BDC_USERNAME and FCC_BDC_HASH_VALUE credentials\n- All Form 477 tools work without credentials and reflect data as of June 2021",
"tools": [
{
"description": "Compares broadband coverage metrics across multiple geographies of the same type and returns a ranked table sorted by unserved or underserved population. Answers \"which counties in this state have the worst broadband access?\" and drives BEAD funding prioritization. Provide up to 50 geography IDs, or set compare_all_states=true for all 50 states + DC. Data is from FCC Form 477 (as of June 2021).",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"compare_all_states": {
"default": false,
"description": "When true, compares all 50 states + DC. Overrides geography_ids. Requires geography_type=\"state\".",
"type": "boolean"
},
"geography_ids": {
"description": "Array of FIPS GEOIDs to compare (up to 50). For all 50 states, omit and set compare_all_states=true.",
"items": {
"type": "string"
},
"maxItems": 50,
"minItems": 2,
"type": "array"
},
"geography_type": {
"description": "Geographic level to compare. Must be uniform across all geographies in the comparison.",
"enum": [
"state",
"county",
"cd",
"place",
"cbsa",
"tribal"
],
"type": "string"
},
"sort_by": {
"default": "unserved_pct",
"description": "\"unserved_pct\" = share of population with no broadband (default). \"unserved_pop\" = raw headcount for BEAD funding. \"coverage_pct\" = share with any coverage. \"competitive_pct\" = share with 2+ providers. Every option ranks worst-first, so rank 1 is the highest unserved share or headcount, or the lowest coverage or competitive share.",
"enum": [
"unserved_pct",
"unserved_pop",
"coverage_pct",
"competitive_pct"
],
"type": "string"
},
"speed_down": {
"default": "25",
"description": "Download speed threshold in Mbps. 25 = FCC legacy standard. 100 = BEAD program standard.",
"enum": [
"4",
"10",
"25",
"100",
"250",
"1000",
"0.2"
],
"type": "string"
},
"tech_filter": {
"default": "acfosw",
"description": "Technology filter. \"acfosw\" = any wired or fixed wireless. \"f\" = fiber only. \"c\" = cable only. \"a\" = DSL. \"s\" = satellite. \"w\" = fixed wireless.",
"enum": [
"acfosw",
"f",
"c",
"a",
"o",
"s",
"w"
],
"type": "string"
}
},
"required": [
"geography_type"
],
"type": "object"
},
"name": "fcc_compare_areas",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"geographyType",
"techFilter",
"speedDownMbps",
"sortBy",
"areas",
"totalAreas",
"dataVintage",
"appliedFilters"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"appliedFilters": {
"additionalProperties": false,
"description": "Filters and parameters applied to this comparison.",
"properties": {
"areasCompared": {
"description": "Total number of geographies compared.",
"type": "number"
},
"geographyType": {
"description": "Geographic level compared.",
"type": "string"
},
"sortBy": {
"description": "Field used for ranking.",
"type": "string"
},
"speedDownMbps": {
"description": "Download speed threshold in Mbps.",
"type": "number"
},
"techFilter": {
"description": "Technology filter applied.",
"type": "string"
}
},
"required": [
"geographyType",
"techFilter",
"speedDownMbps",
"sortBy",
"areasCompared"
],
"type": "object"
},
"areas": {
"description": "Ranked comparison of geographies by the selected sort field.",
"items": {
"additionalProperties": false,
"description": "Coverage metrics for one geography in the comparison.",
"properties": {
"competitivePct": {
"description": "Percentage with two or more providers.",
"type": "number"
},
"coveragePct": {
"description": "Percentage with at least one provider.",
"type": "number"
},
"id": {
"description": "FIPS GEOID.",
"type": "string"
},
"name": {
"description": "Human-readable geography name if resolved (e.g., \"Pontotoc County, MS\").",
"type": "string"
},
"noCoverage": {
"description": "Population with no providers at the given speed.",
"type": "number"
},
"oneProvider": {
"description": "Population with exactly one provider.",
"type": "number"
},
"rank": {
"description": "Rank in the sorted comparison (1 = worst/lowest).",
"type": "number"
},
"threeOrMore": {
"description": "Population with three or more providers.",
"type": "number"
},
"total": {
"description": "Total population.",
"type": "number"
},
"twoProviders": {
"description": "Population with two providers.",
"type": "number"
},
"unservedPct": {
"description": "Percentage with no coverage.",
"type": "number"
}
},
"required": [
"id",
"rank",
"noCoverage",
"oneProvider",
"twoProviders",
"threeOrMore",
"total",
"unservedPct",
"coveragePct",
"competitivePct"
],
"type": "object"
},
"type": "array"
},
"dataVintage": {
"description": "Data vintage — Form 477 data as of June 2021.",
"type": "string"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `no_data_found`: No area table data found for any of the requested geography IDs. `invalid_all_states_combo`: compare_all_states=true used with geography_type other than \"state\". `missing_geography_ids`: No geography_ids provided and compare_all_states is false. `invalid_geography_id_shape`: A geography_ids entry has a digit count that does not match the geography_type (state=2, county=5, cd=4, cbsa=5, place=7). Other values are possible when a failure originates below the handler.",
"examples": [
"no_data_found",
"invalid_all_states_combo",
"missing_geography_ids",
"invalid_geography_id_shape"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"geographyType": {
"description": "Geography type compared.",
"type": "string"
},
"sortBy": {
"description": "Ranking field used.",
"type": "string"
},
"speedDownMbps": {
"description": "Speed threshold in Mbps.",
"type": "number"
},
"techFilter": {
"description": "Technology filter applied.",
"type": "string"
},
"totalAreas": {
"description": "Total number of areas compared.",
"type": "number"
}
},
"type": "object"
}
},
{
"description": "Finds geographic areas with limited or no broadband coverage at a given speed threshold, ranked by unserved population. The core tool for BEAD program analysis and broadband equity research. Accepts a state abbreviation to narrow scope or runs nationwide. Defaults to rural areas where underservice is most concentrated. Data is from FCC Form 477 (as of June 2021).",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"geography_type": {
"default": "county",
"description": "Geographic granularity for results. \"county\" is most useful for policy analysis and BEAD eligibility. \"cd\" = congressional district. \"place\" = census-designated place. \"cbsa\" = metro area.",
"enum": [
"county",
"cd",
"place",
"cbsa"
],
"type": "string"
},
"limit": {
"default": 20,
"description": "Maximum number of areas to return, ranked by unserved population (descending).",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"min_unserved_pop": {
"default": 1,
"description": "Minimum population with no coverage to include. Defaults to 1, which keeps fully covered areas out of a ranking of underserved ones. Set to 0 to rank every area regardless of unserved population, or higher to drop small gaps (e.g., 500 keeps only areas with at least 500 unserved residents).",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"speed_down": {
"default": "25",
"description": "Download speed threshold in Mbps for defining \"underserved.\" 25 = FCC legacy standard. 100 = BEAD program standard.",
"enum": [
"4",
"10",
"25",
"100",
"250",
"1000",
"0.2"
],
"type": "string"
},
"state": {
"description": "2-letter USPS state or territory code (e.g., \"WY\", \"MS\", \"PR\") to limit scope. An unrecognized code is rejected, not ignored. Omit for nationwide search — returns top areas only.",
"pattern": "^[A-Z]{2}$",
"type": "string"
},
"tech_filter": {
"default": "acfosw",
"description": "Technology filter. \"acfosw\" = any wired or fixed wireless. \"f\" = fiber only. \"c\" = cable only.",
"enum": [
"acfosw",
"f",
"c",
"a",
"o",
"s",
"w"
],
"type": "string"
},
"urban_rural_filter": {
"default": "R",
"description": "Defaults to rural (\"R\") — where underservice is most concentrated. Use \"U\" to find underserved urban areas (digital redlining research). Set to \"all\" for both.",
"enum": [
"all",
"R",
"U"
],
"type": "string"
}
},
"type": "object"
},
"name": "fcc_find_underserved",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"areas",
"geographyType",
"speedDownMbps",
"urbanRuralFilter",
"dataVintage",
"totalFound",
"appliedFilters"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"appliedFilters": {
"additionalProperties": false,
"description": "Filters applied to this query.",
"properties": {
"geographyType": {
"description": "Geographic granularity queried.",
"type": "string"
},
"minUnservedPop": {
"description": "Minimum unserved population filter applied.",
"type": "number"
},
"speedDownMbps": {
"description": "Download speed threshold in Mbps.",
"type": "number"
},
"state": {
"description": "State abbreviation filter applied. Absent for nationwide searches.",
"type": "string"
},
"techFilter": {
"description": "Technology filter applied.",
"type": "string"
},
"urbanRuralFilter": {
"description": "Urban/rural filter applied.",
"type": "string"
}
},
"required": [
"geographyType",
"speedDownMbps",
"techFilter",
"urbanRuralFilter",
"minUnservedPop"
],
"type": "object"
},
"areas": {
"description": "Ranked list of underserved areas.",
"items": {
"additionalProperties": false,
"description": "An underserved area ranked by unserved population.",
"properties": {
"coveragePct": {
"description": "Percentage of population with at least one provider.",
"type": "number"
},
"id": {
"description": "FIPS GEOID of the geography.",
"type": "string"
},
"name": {
"description": "Human-readable geography name if resolved (e.g., \"Pontotoc County, MS\").",
"type": "string"
},
"noCoverage": {
"description": "Population with zero providers at the given speed threshold.",
"type": "number"
},
"oneProvider": {
"description": "Population with exactly one provider.",
"type": "number"
},
"rank": {
"description": "Rank by unserved population (1 = most unserved).",
"type": "number"
},
"total": {
"description": "Total population in the geography.",
"type": "number"
},
"unservedPct": {
"description": "Percentage of population with no coverage.",
"type": "number"
}
},
"required": [
"id",
"rank",
"noCoverage",
"oneProvider",
"total",
"unservedPct",
"coveragePct"
],
"type": "object"
},
"type": "array"
},
"cap": {
"description": "The limit that was applied. Present when truncated.",
"type": "number"
},
"dataVintage": {
"description": "Data vintage — Form 477 data as of June 2021.",
"type": "string"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `unknown_state`: The state input is two uppercase letters but is not a USPS state or territory abbreviation. Other values are possible when a failure originates below the handler.",
"examples": [
"unknown_state"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"geographyType": {
"description": "Geography type returned.",
"type": "string"
},
"notice": {
"description": "Guidance about the result set — how to broaden the filters when nothing matched, and how to narrow the query when the upstream scan hit its row ceiling. Absent when neither applies.",
"type": "string"
},
"scanRowCap": {
"description": "Raw upstream row ceiling that bound the scan. Present only when scanTruncated is true.",
"type": "number"
},
"scanTruncated": {
"description": "True when the upstream row scan stopped at its ceiling before reaching the end of the matching data, so totalFound and the ranking cover only the portion that was scanned. Absent when the scan read every matching row.",
"type": "boolean"
},
"shown": {
"description": "Number of areas returned after applying the limit. Present when truncated.",
"type": "number"
},
"speedDownMbps": {
"description": "Speed threshold used in Mbps.",
"type": "number"
},
"totalFound": {
"description": "Total number of areas found before applying the limit filter.",
"type": "number"
},
"truncated": {
"description": "True when more areas matched than the limit returned. Absent when not truncated.",
"type": "boolean"
},
"urbanRuralFilter": {
"description": "Urban/rural filter applied.",
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Converts a latitude/longitude coordinate to a 15-digit census block FIPS code, plus county FIPS, county name, state FIPS, state code, and state name. This is the required prerequisite for fcc_search_availability since the broadband dataset is indexed by census block, not address. The block is resolved against 2010 census boundaries, the vintage the Form 477 deployment dataset is keyed by, so the returned blockFips can be passed straight to fcc_search_availability; a 2020-vintage block ID from another source will not match. Uses the FCC public Geo API — no authentication required.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"latitude": {
"description": "Latitude of the location in decimal degrees (e.g., 47.6062 for Seattle, WA). Must be within the continental US, Alaska, Hawaii, or US territories.",
"maximum": 90,
"minimum": -90,
"type": "number"
},
"longitude": {
"description": "Longitude of the location in decimal degrees (e.g., -122.3321 for Seattle, WA). Negative for western hemisphere.",
"maximum": 180,
"minimum": -180,
"type": "number"
}
},
"required": [
"latitude",
"longitude"
],
"type": "object"
},
"name": "fcc_geocode_block",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"blockFips",
"censusVintage",
"countyFips",
"countyName",
"stateFips",
"stateCode",
"stateName"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"blockFips": {
"description": "15-digit census block FIPS code on 2010 census boundaries (e.g., \"530330081002024\"). Pass this to fcc_search_availability to look up broadband providers.",
"type": "string"
},
"censusVintage": {
"description": "Decennial census whose block boundaries blockFips belongs to. Always \"2010\" — the vintage the Form 477 deployment dataset behind fcc_search_availability is keyed by.",
"type": "string"
},
"countyFips": {
"description": "5-digit county FIPS code (e.g., \"53033\" for King County, WA).",
"type": "string"
},
"countyName": {
"description": "Human-readable county name (e.g., \"King\").",
"type": "string"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `block_not_found`: No census block found at the given coordinates — may be over water or outside US coverage. Other values are possible when a failure originates below the handler.",
"examples": [
"block_not_found"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"stateCode": {
"description": "2-letter state abbreviation (e.g., \"WA\").",
"type": "string"
},
"stateFips": {
"description": "2-digit state FIPS code (e.g., \"53\" for Washington).",
"type": "string"
},
"stateName": {
"description": "Full state name (e.g., \"Washington\").",
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Returns a broadband coverage summary for a geography — population with zero, one, two, or three-plus providers at a given speed threshold, split by urban/rural and tribal/non-tribal segments. The primary tool for digital divide and equity analysis. Supports state, county, congressional district, census place, CBSA (metro area), tribal area, and national level. Data is from FCC Form 477 (as of June 2021). Use 100 Mbps as the speed threshold for BEAD program policy analysis.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"geography_id": {
"description": "FIPS GEOID for the geography. State: 2-digit (e.g., \"06\" for California). County: 5-digit (e.g., \"06037\" for LA County). Congressional district: 4-digit state+district (e.g., \"0601\"). CBSA: 5-digit code. Place: 7-digit state+place (e.g., \"0644000\"). Omit for nation-level queries.",
"type": "string"
},
"geography_type": {
"description": "Geographic aggregation level. \"nation\" = US-wide totals (geography_id not needed). \"cd\" = congressional district. \"place\" = census-designated place. \"cbsa\" = core-based statistical area (metro area). \"tribal\" = tribal land area.",
"enum": [
"nation",
"state",
"county",
"cd",
"place",
"cbsa",
"tribal"
],
"type": "string"
},
"speed_down": {
"default": "25",
"description": "Minimum download speed threshold in Mbps. 25 = FCC legacy broadband definition. 100 = BEAD program standard (use this for current policy analysis). \"0.2\" = any service above 200 Kbps.",
"enum": [
"4",
"10",
"25",
"100",
"250",
"1000",
"0.2"
],
"type": "string"
},
"tech_filter": {
"default": "acfosw",
"description": "Technology filter. \"acfosw\" = any wired or fixed wireless (recommended baseline). \"f\" = fiber only. \"c\" = cable only. \"a\" = ADSL/DSL only. \"s\" = satellite only. \"w\" = fixed wireless only. Mix letters for combinations, e.g., \"fc\" = fiber or cable.",
"enum": [
"acfosw",
"f",
"c",
"a",
"o",
"s",
"w"
],
"type": "string"
},
"tribal_filter": {
"default": "all",
"description": "Filter to tribal (\"T\") or non-tribal (\"N\") areas. Use \"T\" to assess Native American connectivity gaps.",
"enum": [
"all",
"T",
"N"
],
"type": "string"
},
"urban_rural_filter": {
"default": "all",
"description": "Filter to urban (\"U\") or rural (\"R\") areas only, or \"all\" for both combined. Rural breakdown is key for BEAD program analysis.",
"enum": [
"all",
"R",
"U"
],
"type": "string"
}
},
"required": [
"geography_type"
],
"type": "object"
},
"name": "fcc_get_coverage_summary",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"geography",
"techFilter",
"speedDownMbps",
"population",
"coveragePct",
"unservedPct",
"competitivePct",
"breakdown",
"dataVintage",
"appliedFilters"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"appliedFilters": {
"additionalProperties": false,
"description": "Filters applied to this query.",
"properties": {
"geographyId": {
"description": "FIPS GEOID queried. Absent for nation-level.",
"type": "string"
},
"geographyType": {
"description": "Geographic aggregation level queried.",
"type": "string"
},
"speedDownMbps": {
"description": "Download speed threshold in Mbps.",
"type": "number"
},
"techFilter": {
"description": "Technology filter applied.",
"type": "string"
},
"tribalFilter": {
"description": "Tribal/non-tribal filter applied.",
"type": "string"
},
"urbanRuralFilter": {
"description": "Urban/rural filter applied.",
"type": "string"
}
},
"required": [
"geographyType",
"techFilter",
"speedDownMbps",
"urbanRuralFilter",
"tribalFilter"
],
"type": "object"
},
"breakdown": {
"description": "Per-segment breakdown by urban/rural and tribal/non-tribal.",
"items": {
"additionalProperties": false,
"description": "One urban/rural × tribal/non-tribal segment.",
"properties": {
"coveragePct": {
"description": "Coverage percentage for this segment.",
"type": "number"
},
"population": {
"additionalProperties": false,
"description": "Population breakdown for this urban/rural × tribal segment.",
"properties": {
"noCoverage": {
"description": "Population with no coverage in this segment.",
"type": "number"
},
"oneProvider": {
"description": "Population with one provider in this segment.",
"type": "number"
},
"threeOrMore": {
"description": "Population with three or more providers in this segment.",
"type": "number"
},
"total": {
"description": "Total population in this segment.",
"type": "number"
},
"twoProviders": {
"description": "Population with two providers in this segment.",
"type": "number"
}
},
"required": [
"noCoverage",
"oneProvider",
"twoProviders",
"threeOrMore",
"total"
],
"type": "object"
},
"tribal": {
"description": "\"T\" = tribal land, \"N\" = non-tribal.",
"enum": [
"T",
"N"
],
"type": "string"
},
"unservedPct": {
"description": "Unserved percentage for this segment.",
"type": "number"
},
"urbanRural": {
"description": "\"R\" = rural, \"U\" = urban.",
"enum": [
"R",
"U"
],
"type": "string"
}
},
"required": [
"urbanRural",
"tribal",
"population",
"coveragePct",
"unservedPct"
],
"type": "object"
},
"type": "array"
},
"competitivePct": {
"description": "Percentage with two or more providers.",
"type": "number"
},
"coveragePct": {
"description": "Percentage of population with at least one provider at the given speed.",
"type": "number"
},
"dataVintage": {
"description": "Data vintage — Form 477 data as of June 2021.",
"type": "string"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `geography_not_found`: No area data found for the given geography ID and type. `invalid_geography_combo`: geography_id is omitted for a non-nation type, or geography_type is \"nation\" but geography_id is provided. `invalid_geography_id_shape`: geography_id digit count does not match the geography_type (state=2, county=5, cd=4, cbsa=5, place=7). Other values are possible when a failure originates below the handler.",
"examples": [
"geography_not_found",
"invalid_geography_combo",
"invalid_geography_id_shape"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"geography": {
"additionalProperties": false,
"description": "The queried geography.",
"properties": {
"id": {
"description": "FIPS GEOID (e.g., \"06\").",
"type": "string"
},
"name": {
"description": "Human-readable name if available.",
"type": "string"
},
"type": {
"description": "Geography type (e.g., \"state\").",
"type": "string"
}
},
"required": [
"type",
"id"
],
"type": "object"
},
"population": {
"additionalProperties": false,
"description": "Population counts by provider availability tier.",
"properties": {
"noCoverage": {
"description": "Population where zero providers offer service at the given speed.",
"type": "number"
},
"oneProvider": {
"description": "Population with exactly one provider — no competitive choice.",
"type": "number"
},
"threeOrMore": {
"description": "Population with three or more providers.",
"type": "number"
},
"total": {
"description": "Total population in the geography.",
"type": "number"
},
"twoProviders": {
"description": "Population with exactly two providers.",
"type": "number"
}
},
"required": [
"noCoverage",
"oneProvider",
"twoProviders",
"threeOrMore",
"total"
],
"type": "object"
},
"speedDownMbps": {
"description": "Download speed threshold used in Mbps.",
"type": "number"
},
"techFilter": {
"description": "Technology filter applied.",
"type": "string"
},
"unservedPct": {
"description": "Percentage with zero providers — FCC \"unserved\" definition.",
"type": "number"
}
},
"type": "object"
}
},
{
"description": "Returns a national-level coverage profile for a specific holding company (by hoconum): technologies deployed and the population covered at each download speed tier. Population figures come from the FCC provider summary table and count each person once, regardless of how many technologies the provider uses to reach them. Use fcc_search_providers to find valid hoconum values. Data is from FCC Form 477 (as of June 2021).",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"hoconum": {
"description": "Holding company number from fcc_search_providers — digits only, e.g. \"130317\" for Comcast Corporation.",
"pattern": "^\\d+$",
"type": "string"
}
},
"required": [
"hoconum"
],
"type": "object"
},
"name": "fcc_get_provider",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"hoconum",
"holdingCompanyName",
"techCodes",
"techLabels",
"speedTierPopulation",
"dataVintage"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"dataVintage": {
"description": "Data vintage — Form 477 data as of June 2021.",
"type": "string"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `provider_not_found`: No provider found with the given hoconum. `live_provider_timeout`: A live FCC Open Data lookup exceeded its 30-second budget; the queries are point lookups, so a retry reaches the same result. Other values are possible when a failure originates below the handler.",
"examples": [
"provider_not_found",
"live_provider_timeout"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"hoconum": {
"description": "Holding company number.",
"type": "string"
},
"holdingCompanyName": {
"description": "Holding company name.",
"type": "string"
},
"speedTierPopulation": {
"description": "National covered population by download speed tier, from the FCC all-technology rollup. Tiers with no coverage are omitted; empty when the provider reports no population coverage.",
"items": {
"additionalProperties": false,
"description": "A speed tier with its covered population.",
"properties": {
"population": {
"description": "People covered at or above this download speed, counted once each.",
"type": "number"
},
"tier": {
"description": "Download speed threshold (e.g., \"25 Mbps\").",
"type": "string"
}
},
"required": [
"tier",
"population"
],
"type": "object"
},
"type": "array"
},
"techCodes": {
"description": "Technology codes this provider reports nationally. Empty when the provider reports no population coverage (e.g. business-only carriers).",
"items": {
"type": "string"
},
"type": "array"
},
"techLabels": {
"description": "Human-readable technology descriptions.",
"items": {
"type": "string"
},
"type": "array"
}
},
"type": "object"
}
},
{
"description": "Lists downloadable BDC data files for a specific as-of date — fixed availability by state and provider, mobile coverage, and challenge data — with file metadata (provider, state, technology, record count). Download URLs are included for each file. Requires FCC BDC API credentials (FCC_BDC_USERNAME and FCC_BDC_HASH_VALUE). Use fcc_list_filing_periods first to determine valid as_of_date values (BDC dates start June 2022); a date that is not on the calendar, or that falls before the first BDC period, is rejected without credentials, while a well-formed date the BDC API does not publish is rejected once credentials let the published set be read. One as-of date can carry thousands of per-provider files, so results come back a page at a time: totalFiles counts every file matching the filters, the response reports the offset and the count on this page, and it carries a nextOffset to pass back for the following page until the last one, which omits it.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"as_of_date": {
"description": "BDC as-of date in YYYY-MM-DD format (e.g., \"2024-06-30\"). Get valid dates from fcc_list_filing_periods with include_bdc=true.",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string"
},
"category": {
"description": "File category. \"State\" = per-state coverage files. \"Provider\" = per-provider files. \"Summary\" = aggregate coverage tables.",
"enum": [
"Summary",
"State",
"Provider"
],
"type": "string"
},
"data_type": {
"default": "availability",
"description": "\"availability\" = ISP-reported coverage files (by state and provider). \"challenge\" = consumer and government dispute records.",
"enum": [
"availability",
"challenge"
],
"type": "string"
},
"limit": {
"default": 50,
"description": "Maximum number of files to return on one page.",
"maximum": 200,
"minimum": 1,
"type": "integer"
},
"offset": {
"default": 0,
"description": "Zero-based index of the first file to return, within the files matching the filters. Start at 0 and follow the nextOffset each response carries.",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"provider_name": {
"description": "Partial provider holding company name to filter results (case-insensitive).",
"type": "string"
},
"state": {
"description": "Filter to one state's files (2-letter abbreviation, e.g., \"WA\").",
"pattern": "^[A-Z]{2}$",
"type": "string"
},
"technology_type": {
"description": "Filter to a specific technology type of coverage data.",
"enum": [
"Fixed Broadband",
"Mobile Broadband",
"Mobile Voice"
],
"type": "string"
}
},
"required": [
"as_of_date"
],
"type": "object"
},
"name": "fcc_list_downloads",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"files",
"totalFiles",
"asOfDate",
"dataType",
"offset",
"pageSize",
"count",
"truncated",
"appliedFilters",
"notice"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"appliedFilters": {
"additionalProperties": false,
"description": "Filters applied to this query.",
"properties": {
"asOfDate": {
"description": "As-of date queried.",
"type": "string"
},
"category": {
"description": "Category filter applied. Absent when not filtered.",
"type": "string"
},
"dataType": {
"description": "Data type queried.",
"type": "string"
},
"providerName": {
"description": "Provider name filter applied. Absent when not filtered.",
"type": "string"
},
"state": {
"description": "State filter applied. Absent for all-state results.",
"type": "string"
},
"technologyType": {
"description": "Technology type filter applied. Absent when not filtered.",
"type": "string"
}
},
"required": [
"asOfDate",
"dataType"
],
"type": "object"
},
"asOfDate": {
"description": "The queried as-of date.",
"type": "string"
},
"count": {
"description": "Files actually returned on this page. Zero both when nothing matched and when the offset is past the end; the notice says which.",
"type": "number"
},
"dataType": {
"description": "Data type queried (availability or challenge).",
"type": "string"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `credentials_required`: FCC_BDC_USERNAME or FCC_BDC_HASH_VALUE environment variables are not set. `invalid_as_of_date`: The as_of_date is not a date on the calendar, falls before the first BDC filing period, or is not among the as-of dates the BDC API publishes. The first two are caught without credentials; the third needs them, since only the credentialed endpoint knows the published set. Other values are possible when a failure originates below the handler.",
"examples": [
"credentials_required",
"invalid_as_of_date"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"files": {
"description": "Downloadable BDC files on this page, in the order the BDC API lists them.",
"items": {
"additionalProperties": false,
"description": "A downloadable BDC file entry.",
"properties": {
"asOfDate": {
"description": "As-of date for this file.",
"type": "string"
},
"category": {
"description": "File category (e.g., \"State\", \"Provider\", \"Summary\").",
"type": "string"
},
"downloadUrl": {
"description": "Direct download URL for the file.",
"type": "string"
},
"fileId": {
"description": "Unique file identifier.",
"type": "string"
},
"fileName": {
"description": "File name.",
"type": "string"
},
"fileSizeBytes": {
"description": "File size in bytes when available.",
"type": "number"
},
"providerName": {
"description": "Provider name for provider-level files.",
"type": "string"
},
"recordCount": {
"description": "Number of records in the file when available.",
"type": "number"
},
"stateAbbr": {
"description": "State abbreviation for state-level files.",
"type": "string"
},
"stateName": {
"description": "State name for state-level files.",
"type": "string"
},
"subcategory": {
"description": "File subcategory when available.",
"type": "string"
},
"technologyType": {
"description": "Technology type covered (e.g., \"Fixed Broadband\", \"Mobile Broadband\").",
"type": "string"
}
},
"required": [
"fileId",
"fileName",
"category",
"downloadUrl",
"asOfDate"
],
"type": "object"
},
"type": "array"
},
"nextOffset": {
"description": "Offset to pass back for the next page. Omitted on the last page and when the offset is past the end.",
"type": "number"
},
"notice": {
"description": "Where this page sits in the matching set and how to continue — or, when the page is empty, whether nothing matched the filters or the offset ran past the end.",
"type": "string"
},
"offset": {
"description": "Zero-based index of the first file on this page.",
"type": "number"
},
"pageSize": {
"description": "Maximum files one page returns — the limit that was applied.",
"type": "number"
},
"totalFiles": {
"description": "Files matching the filters across every page, not just this one. Compare against the count enrichment field to see how much of the set this page holds.",
"type": "number"
},
"truncated": {
"description": "True when this page holds fewer files than totalFiles, so more pages exist.",
"type": "boolean"
}
},
"type": "object"
}
},
{
"description": "Returns available data vintages: Form 477 filing periods (hardcoded Jun 2015 – Jun 2021, always available) and BDC as-of dates from the authenticated API (Jun 2022 onward, requires credentials). Call this before fcc_list_downloads to determine valid as_of_date values. Note: there is a data gap between June 2021 (last Form 477) and June 2022 (first BDC filing period).",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"include_bdc": {
"default": false,
"description": "When true, also fetches BDC as-of dates from the authenticated API (requires FCC_BDC_USERNAME and FCC_BDC_HASH_VALUE). When false (default), returns only hardcoded Form 477 periods.",
"type": "boolean"
}
},
"type": "object"
},
"name": "fcc_list_filing_periods",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"periods",
"form477Count",
"bdcCount",
"hasBdcCredentials",
"dataNote"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"bdcCount": {
"description": "Number of BDC periods returned (0 when credentials not configured or include_bdc=false).",
"type": "number"
},
"dataNote": {
"description": "Note on data availability and the Form 477 vs. BDC gap.",
"type": "string"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode.",
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"form477Count": {
"description": "Number of Form 477 periods returned (always available).",
"type": "number"
},
"hasBdcCredentials": {
"description": "Whether BDC API credentials are configured in this deployment.",
"type": "boolean"
},
"periods": {
"description": "Available filing periods sorted newest first.",
"items": {
"additionalProperties": false,
"description": "A filing period entry.",
"properties": {
"asOfDate": {
"description": "Filing period as-of date in YYYY-MM-DD format (e.g., \"2021-06-30\").",
"type": "string"
},
"publicationDate": {
"description": "Date the dataset was published, if available.",
"type": "string"
},
"source": {
"description": "\"form477\" = legacy ISP-reported data (2015–2021). \"bdc\" = Broadband Data Collection (2022+).",
"enum": [
"form477",
"bdc"
],
"type": "string"
}
},
"required": [
"asOfDate",
"source"
],
"type": "object"
},
"type": "array"
}
},
"type": "object"
}
},
{
"description": "Queries broadband providers and advertised speeds at a census block from FCC Form 477 data (as of June 2021). Answers \"which ISPs serve this location and what speeds do they offer?\" — the core tool for address-level broadband lookup. Requires a 15-digit census block FIPS code; use fcc_geocode_block to convert coordinates first. Data reflects ISP-reported availability at the block level, which may overstate actual coverage for some addresses.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"block_fips": {
"description": "15-digit census block FIPS code on 2010 census boundaries, the vintage this Form 477 dataset is keyed by (e.g., \"530330081002024\"). Obtain from fcc_geocode_block using address coordinates — a 2020-vintage block ID matches no deployment row.",
"pattern": "^\\d{15}$",
"type": "string"
},
"consumer": {
"description": "Filter to consumer service (true) or business service (false). Omit to return both consumer and business offerings.",
"type": "boolean"
},
"min_speed_down": {
"description": "Minimum advertised download speed in Mbps to include in results. Omit to return all providers regardless of speed.",
"minimum": 0,
"type": "number"
},
"tech_filter": {
"description": "Technology codes to filter, from the complete Form 477 taxonomy: 0=All other, 10=Asymmetric xDSL, 11=ADSL2, 12=VDSL, 20=Symmetric xDSL, 30=Other copper wireline, 40=Cable modem, 41=Cable modem DOCSIS 1/1.1/2.0, 42=Cable modem DOCSIS 3.0, 43=Cable modem DOCSIS 3.1, 50=Fiber to the end user, 60=Satellite, 70=Terrestrial fixed wireless, 90=Electric power line. Omit to return all technologies.",
"items": {
"enum": [
"0",
"10",
"11",
"12",
"20",
"30",
"40",
"41",
"42",
"43",
"50",
"60",
"70",
"90"
],
"type": "string"
},
"type": "array"
}
},
"required": [
"block_fips"
],
"type": "object"
},
"name": "fcc_search_availability",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"blockFips",
"providers",
"totalProviders",
"dataVintage",
"appliedFilters"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"appliedFilters": {
"additionalProperties": false,
"description": "Filters applied to this query.",
"properties": {
"consumerFilter": {
"description": "Consumer/business filter applied. true = consumer only, false = business only. Absent when both were returned.",
"type": "boolean"
},
"minSpeedDown": {
"description": "Minimum advertised download speed filter in Mbps. Absent when no speed filter was used.",
"type": "number"
},
"techFilter": {
"description": "Technology codes applied as a filter. Absent when no tech filter was used.",
"items": {
"type": "string"
},
"type": "array"
}
},
"type": "object"
},
"blockFips": {
"description": "The queried census block FIPS code.",
"type": "string"
},
"dataVintage": {
"description": "Data vintage — all Form 477 data on FCC Open Data is as of June 2021. For newer BDC data, use fcc_list_downloads.",
"type": "string"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `block_not_found`: No providers in the FCC dataset for this census block. Other values are possible when a failure originates below the handler.",
"examples": [
"block_not_found"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"notice": {
"description": "Recovery hint when no providers are found — suggests how to broaden the query. Absent on successful results.",
"type": "string"
},
"providers": {
"description": "ISP offerings reported for this census block.",
"items": {
"additionalProperties": false,
"description": "One ISP offering at this census block.",
"properties": {
"business": {
"description": "Whether this offering serves businesses.",
"type": "boolean"
},
"consumer": {
"description": "Whether this offering serves consumers.",
"type": "boolean"
},
"hoconum": {
"description": "Holding company number — use with fcc_get_provider for a national profile.",
"type": "string"
},
"holdingCompanyName": {
"description": "Parent holding company name (e.g., \"Comcast\").",
"type": "string"
},
"maxDownloadMbps": {
"description": "Maximum advertised download speed in Mbps.",
"type": "number"
},
"maxUploadMbps": {
"description": "Maximum advertised upload speed in Mbps.",
"type": "number"
},
"providerId": {
"description": "FCC provider registration number (FRN).",
"type": "string"
},
"providerName": {
"description": "Registered provider name.",
"type": "string"
},
"stateAbbr": {
"description": "State where coverage is reported.",
"type": "string"
},
"techCode": {
"description": "FCC Form 477 technology code (e.g., \"50\" = fiber, \"43\" = cable DOCSIS 3.1, \"60\" = satellite).",
"type": "string"
},
"techLabel": {
"description": "Human-readable technology description.",
"type": "string"
}
},
"required": [
"providerId",
"providerName",
"holdingCompanyName",
"hoconum",
"stateAbbr",
"techCode",
"techLabel",
"maxDownloadMbps",
"maxUploadMbps",
"consumer",
"business"
],
"type": "object"
},
"type": "array"
},
"totalProviders": {
"description": "Total number of distinct holding companies offering service at this block.",
"type": "number"
}
},
"type": "object"
}
},
{
"description": "Searches for ISPs by holding company name, filtered by state and technology type. Returns a deduplicated list of matching providers with hoconum identifiers for follow-up calls to fcc_get_provider. Answers \"which ISPs serve Washington with fiber?\" and \"find all Comcast entities.\" Geographic filtering is state-level; sub-state granularity requires cross-referencing block data. Against the live FCC API the search reads a bounded window of deployment rows to find which holding companies match, so when scanTruncated comes back true the providers are a sample of the matches rather than every one of them and no true match count is available; a narrower filter raises the share of matches the sample surfaces but cannot make it complete, and only a deployment running the local Form 477 mirror returns every match. The sample is of which companies come back — every company that does carries its complete national footprint, since statesServed and techCodes are resolved per company rather than read off the window, at the cost of one lookup per provider returned. Data is from FCC Form 477 (as of June 2021).",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"limit": {
"default": 50,
"description": "Maximum number of distinct providers to return.",
"maximum": 200,
"minimum": 1,
"type": "integer"
},
"name_search": {
"description": "Partial holding company name to search (case-insensitive). e.g., \"Comcast\", \"T-Mobile\", \"Frontier\". Omit to list all providers in a state.",
"type": "string"
},
"state": {
"description": "2-letter state abbreviation (e.g., \"WA\") to limit results to providers serving that state. Matches individual deployment filings, so every filter given must hold on one filing together — a provider is returned for state=\"WA\" with tech_filter=[\"50\"] only if it filed fiber in Washington, not if it filed fiber elsewhere and something else in Washington.",
"pattern": "^[A-Z]{2}$",
"type": "string"
},
"tech_filter": {
"description": "Technology codes to filter, from the complete Form 477 taxonomy: 0=All other, 10=Asymmetric xDSL, 11=ADSL2, 12=VDSL, 20=Symmetric xDSL, 30=Other copper wireline, 40=Cable modem, 41=Cable modem DOCSIS 1/1.1/2.0, 42=Cable modem DOCSIS 3.0, 43=Cable modem DOCSIS 3.1, 50=Fiber to the end user, 60=Satellite, 70=Terrestrial fixed wireless, 90=Electric power line. Omit for all technologies. Matches individual deployment filings like state does, so pairing this with name_search narrows to filings made under the matched name — a holding company that files some technologies under an acquired brand name can come back empty here while its techCodes list the technology. To ask what one company deploys, search the name alone and read techCodes off the result.",
"items": {
"enum": [
"0",
"10",
"11",
"12",
"20",
"30",
"40",
"41",
"42",
"43",
"50",
"60",
"70",
"90"
],
"type": "string"
},
"type": "array"
}
},
"type": "object"
},
"name": "fcc_search_providers",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"providers",
"totalFound",
"dataVintage",
"appliedFilters"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"appliedFilters": {
"additionalProperties": false,
"description": "Filters applied to this query.",
"properties": {
"nameSearch": {
"description": "Name fragment searched. Absent when no name search was used.",
"type": "string"
},
"state": {
"description": "State filter applied. Absent for nationwide searches.",
"type": "string"
},
"techFilter": {
"description": "Technology code filter applied. Absent when no tech filter was used.",
"items": {
"type": "string"
},
"type": "array"
}
},
"type": "object"
},
"cap": {
"description": "The limit that was applied. Present when capped.",
"type": "number"
},
"dataVintage": {
"description": "Data vintage — Form 477 data as of June 2021.",
"type": "string"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `live_search_timeout`: A live FCC Open Data provider search exceeded its 30-second budget, on either the bounded windowed read or one of the per-provider footprint lookups; both are shapes that answer in seconds or not at all, so a retry reaches the same result. Other values are possible when a failure originates below the handler.",
"examples": [
"live_search_timeout"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"notice": {
"description": "Guidance about the result set — that the list was capped at the limit, that the upstream scan returned a sample rather than every match, and how to broaden the search when nothing matched. Absent when none applies.",
"type": "string"
},
"providers": {
"description": "Matching providers, deduplicated by holding company.",
"items": {
"additionalProperties": false,
"description": "A deduplicated ISP holding company entry.",
"properties": {
"hoconum": {
"description": "Holding company number — use with fcc_get_provider for a national profile.",
"type": "string"
},
"holdingCompanyName": {
"description": "Holding company name as filed on the deployment rows this search matched. One holding company number can carry more than one name in Form 477 — an acquired brand still filing under the parent number — and this is the name the matched rows carry, not necessarily every name filed under the number.",
"type": "string"
},
"statesServed": {
"description": "Every state, district, and territory this holding company filed deployments in nationally — its complete footprint, resolved per company. Not narrowed by the state filter, and complete even when the provider list is a sample.",
"items": {
"description": "State abbreviation (e.g., \"WA\").",
"type": "string"
},
"type": "array"
},
"techCodes": {
"description": "Every technology code this holding company deployed nationally — its complete set, resolved per company. Not narrowed by tech_filter, and complete even when the provider list is a sample. Drawn from block-level deployment filings, so it can exceed the technologies fcc_get_provider reports, which counts only those with reported covered population.",
"items": {
"description": "FCC technology code (e.g., \"50\" = fiber).",
"type": "string"
},
"type": "array"
}
},
"required": [
"hoconum",
"holdingCompanyName",
"statesServed",
"techCodes"
],
"type": "object"
},
"type": "array"
},
"scanRowCap": {
"description": "Raw upstream row ceiling that bound the scan. Present only when scanTruncated is true.",
"type": "number"
},
"scanTruncated": {
"description": "True when the upstream row scan stopped at its ceiling before reaching the end of the matching data, so the providers returned are a sample of the matches rather than the complete set. Bounds which companies came back, not what each one reports — statesServed and techCodes are resolved per company and stay complete. Absent when the scan read every matching row.",
"type": "boolean"
},
"shown": {
"description": "Number of providers returned. Present when capped.",
"type": "number"
},
"totalCount": {
"description": "Distinct providers matching the query, before the limit. Present only when the scan read every matching row — absent when scanTruncated is true, because the true match count is then unknown.",
"type": "number"
},
"totalFound": {
"description": "Providers in this response. Not the number matching the query — that is totalCount, and it is only knowable when the scan read every matching row.",
"type": "number"
},
"truncated": {
"description": "True when results were capped at the limit and more providers may exist. Absent when not capped.",
"type": "boolean"
}
},
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:8d96b47c05852b626094d055f061ea40824bec01b88816277f86ec3583ce2679 | sha256sum