cyanheads/fcc-broadband-mcp-server
Access FCC broadband availability, coverage analysis, and digital divide data for US geographies and census blocks via MCP. STDIO or Streamable HTTP.
Changelog
All notable changes to this project. Each entry links to its full per-version file in changelog/.
0.4.0 — 2026-11-03
Historical coverage analysis and paged results
0.3.0 — 2026-10-18
Discover place and CBSA geographies by name, with BDC downloads advertised only where credentials are configured.
0.2.4 — 2026-10-08
Adopts mcp-ts-core 0.13.6 → 0.13.14: tool arguments sent as an integer for a string ID, a numeric or boolean string, a lone string for a list, or null for an optional field are repaired instead of rejected, and every tool error result carries its request ID.
0.2.3 — 2026-09-20 · ⚠️ Breaking
Adopts mcp-ts-core 0.12.3 → 0.13.6: an unrecognized argument key is dropped or alias-rewritten before an undeclared one is rejected as InvalidParams (was ValidationError), upstream error data no longer carries the request URL by default, and a blank or unsubstituted bundle credential now reads as absent instead of a literal placeholder string.
0.2.2 — 2026-08-25
Adopts mcp-ts-core 0.12.3 across the framework's SDK v2 migration: protocol revision 2026-07-28 is served alongside the 2025 era, tool inputs reject an undeclared argument key by name, and cache hints declare what a client may reuse.
0.2.1 — 2026-08-13
Broadband and technology lookups now resolve against the correct census vintage and the complete Form 477 taxonomy, nonexistent geographies are rejected instead of read as zero coverage, and BDC downloads validate as-of dates up front and page instead of returning every file at once.
0.2.0 — 2026-08-13 · ⚠️ Breaking
Provider lookups and search no longer time out on the live FCC API, population figures are no longer overcounted, and the providers directory is now a paginated, named resource with a breaking URI change.
0.1.14 — 2026-08-13
Four ranking and filtering fixes across fcc_find_underserved and fcc_compare_areas: territory-aware state validation (#15), a safer min_unserved_pop default (#17), an unbounded area scan (#22), and worst-first sorting under every compare metric (#23).
0.1.13 — 2026-08-13
@cyanheads/mcp-ts-core ^0.10.10 → ^0.11.5 adoption, Form 477 mirror stores now enforce per-store query ceilings (#19), and the repo gains a LICENSE plus community/security docs.
0.1.12 — 2026-07-02
fcc_search_providers no longer retries its deterministic live GROUP BY timeout 4x — deadline aborts are classified as McpError(Timeout), the grouped query fails once with a non-retryable live_search_timeout and a recovery hint, and name searches drop the 10x grouped-row headroom.
0.1.11 — 2026-07-02
Opt-in local SQLite mirror of the frozen Form 477 corpus: state-scoped ingest via mirror:init/mirror:verify, coverage-gated serving with silent live-API fallback, FTS5 provider search, and FCC_MIRROR_ENABLED/FCC_MIRROR_PATH config.
0.1.10 — 2026-07-02 · 🛡️ Security
Fail-fast GEOID shape validation on fcc_get_coverage_summary and fcc_compare_areas, batched GEOID→name resolution in fcc_find_underserved and fcc_compare_areas output, mcp-ts-core ^0.10.10, and a lock refresh clearing 8 transitive advisories (hono, js-yaml).
0.1.9 — 2026-06-20
mcp-ts-core ^0.10.6 → ^0.10.9: ctx.content media collector, sharper Canvas SQL error classification, fresh-scaffold devcheck guards, plus two new devcheck steps (dependency specifiers, plugin-manifest checks) synced into the toolchain.
0.1.8 — 2026-06-12
mcp-ts-core ^0.9.21 → ^0.10.6; in-code identity name/title; truncation enrichment on find_underserved and search_providers; MCPB bundle agent-doc strip; optional BDC/Open Data credential env vars.
0.1.7 — 2026-06-04
Error contracts: migrate service-layer notFound throws to handler ctx.fail() with recovery hints (#9, #10); fix wrong error reason for missing geography_ids (#7).
0.1.6 — 2026-06-02
mcp-ts-core ^0.9.16 → ^0.9.21 — per-request log context fix, secret-stripped error messages, fail-fast retry logic.
0.1.5 — 2026-05-30
Enrichment adoption — search/coverage tools surface query echoes, result totals, and empty-result guidance in a typed enrichment block reaching both structuredContent and content[] channels.
0.1.4 — 2026-05-28
mcp-ts-core ^0.9.9 → ^0.9.13: 413 body cap, HTTP session-init gate, quieter 401/403/400/404 logging, GET /mcp keywords; error-code reclassifications (InvalidParams → ValidationError)
0.1.3 — 2026-05-26
Package metadata aligned to ecosystem standard: author, funding, scripts, install badges, FUNDING.yml
0.1.2 — 2026-05-25
Add mcpName and publish-mcp script for MCP Registry compatibility
0.1.1 — 2026-05-25
Field-test fixes — state filter, provider search, geography lookup, providers-list resource
0.1.0 — 2026-05-25
Initial release — 9 tools for FCC broadband availability, coverage analysis, digital divide, and BDC download manifests