parcel-gis-mcp-server

Tercer conector de la suite Hutton SIR Research Agent (junto con los conectores FEMA NFHL y Municode). Expone consultas de datos de parcelas a nivel de condado/estado y consultas de identificación de capas GIS mediante el acceso directo a servicios públicos ArcGIS REST — el mismo patrón de "evitar el portal JS, consultar el servicio subyacente" que hizo funcionar el conector FEMA.

Sin claves API. Cada fuente upstream es un endpoint público.

Qué soluciona

La clase de fallo más consistente en las ejecuciones de SIR: los portales de parcelas de nivel 1 (qPublic/Schneider, pbcpao.gov, OCPA, aplicaciones LOJIC) son renderizados con JS o bloqueados por tokens, y el único espejo de nivel 2 (FloridaParcels) es solo para FL y poco fiable. Este servidor resuelve la clave primaria del SIR §0A — el identificador de parcela — contra las capas ArcGIS abiertas sobre las que se asientan esos portales, y añade búsquedas punto-en-polígono (distrito de zonificación, uso del suelo, distrito de gestión del agua, límites municipales) además de elevación USGS.

Herramientas

El centroide de parcel_lookup se encadena directamente al conector FEMA (fema_flood_zone_lookup) y a gis_elevation_at_point — identificador de parcela de entrada, zona de inundación + elevación de salida, con coordenadas transportadas según la Regla de Calidad 8.

El registro (src/registry.ts)

La cobertura crece añadiendo una entrada en el registro, no escribiendo código — el reflejo del Registro de Portales de Jurisdicción en el lado del código. Cada entrada lleva una fecha verified o false (= ⟨verificar en ejecución⟩). Semilla incluida:

• fl-statewide — FGIO/FDOR catastral, los 67 condados de FL (✅ verificado 2026-08-17; esquema confirmado: PARCEL_ID, OWN_NAME, PHY_ADDR1, LND_SQFOOT, DOR_UC, S_LEGAL, SALE_*, JV)

• ky-jefferson — LOJIC abierto OpenDataPVA parcelas (✅ verificado 2026-08-17 — el servidor abierto en gis.lojic.org, no el de apps.lojic.org bloqueado por token; solo geometría + PARCELID/PIN/LRSN)

• ky-state-pva-pattern — kygisserver plantilla PVA por condado (⟨verificar en ejecución⟩; Webster confirmado presente, Jefferson/Scott confirmados ausentes)

• tn-statewide-tdec — TDEC espejo de parcelas a nivel estatal para el mercado de Chattanooga (⟨verificar en ejecución⟩; devolvió 403 a un cliente no navegador el 2026-08-17)

• Capas de identificación: ky-jefferson-landuse (✅ listada), fl-wmd-boundaries + fl-municipal-boundaries (URL a fijar en el primer uso)

Incorporación de una nueva jurisdicción: usar gis_raw_query para consultar el directorio /rest/services del condado → encontrar la capa de parcelas/zonificación → leer su esquema de campos (f=json en la raíz de la capa) → añadir una entrada ParcelSource/IdentifyLayer → hacer commit → Render despliega automáticamente.

Desarrollo local

npm install
npm run build
npm start                      # listens on :3000, MCP endpoint = POST /mcp
node test/live-test.mjs        # smoke test against localhost

Nota: desde un entorno con sandbox/proxy, las llamadas salientes pueden estar bloqueadas; ejecutar la prueba de humo contra la URL desplegada en su lugar:

node test/live-test.mjs https://YOUR-SERVICE.onrender.com/mcp

Despliegue (GitHub → Render)

Mismo proceso que los conectores FEMA y Municode — ver DEPLOYMENT.md para los pasos detallados. Versión corta: subir este repositorio a GitHub → Render "Nuevo Servicio Web" desde el repositorio → build npm install && npm run build, start npm start → la URL del conector es https://<service>.onrender.com/mcp.