Local Austin MCP

Local Austin MCP

La guía local de tu IA para Austin. Un servidor Model Context Protocol (MCP) que permite a Claude (y a cualquier cliente MCP) responder las preguntas reales que la gente hace cuando investiga una propiedad, compra o se muda al área de Austin — "¿quién enciende mi agua en esta dirección?", "¿cuáles son las escuelas y los impuestos de distritos especiales?", "¿está en una zona de inundación?", "¿qué hay en venta en este vecindario?" — consultando directamente las fuentes autorizadas de la Ciudad de Austin / Condados Travis-Williamson-Hays, además de listados de bienes raíces activos y escritores locales, todo proporcionado por Neuhaus Realty Group. Sin claves API, sin inicios de sesión.

Licencia: Código abierto bajo Apache License 2.0 — libre de usar, modificar y construir sobre ella, incluso comercialmente. Por favor conserva la atribución NOTICE cuando redistribuyas. La licencia Apache no otorga derechos de marca: "Neuhaus Realty Group" y las marcas Neuhaus siguen siendo nuestras (ver TRADEMARK.md). Propietario: Ed Neuhaus / Neuhaus Realty Group LLC, Austin, Texas. Fuente: https://github.com/mindwear-capitian/local-austin-mcp Desarrollado por: Neuhaus Realty Group — https://neuhausre.com (los listados de bienes raíces activos, páginas de vecindarios y contenido de blog que este MCP expone provienen de neuhausre.com).

🚧 Este es un proyecto temprano y me encantaría ayuda para mejorarlo. Soy un corredor que construyó esto para darle a una IA un control real y en lenguaje sencillo sobre Austin. Funciona, pero hay muchos más datos de Austin que vale la pena conectar y un par de problemas difíciles que no he resuelto. Si construyes con MCPs o conoces datos cívicos de Austin/Texas, los pull requests y las ideas son genuinamente bienvenidos — ver CONTRIBUTING.md y los good first issues.

🏙️ ¿Construyendo esto para tu propia ciudad? Este repositorio es la implementación de referencia para el patrón local-{city}-mcp. La especificación, una plantilla funcional y la lista completa de ciudades construidas hasta ahora viven en local-city-mcp-template — empieza allí.

---

Instalación

Añade a tu configuración de Claude Desktop:

// claude_desktop_config.json
{
  "mcpServers": {
    "local-austin": {
      "command": "npx",
      "args": ["-y", "github:mindwear-capitian/local-austin-mcp"]
    }
  }
}

Reinicia Claude Desktop. Eso es todo el proceso de instalación. No se requieren claves API para ninguna herramienta.

Claude Code

claude mcp add local-austin npx -y github:mindwear-capitian/local-austin-mcp

Configuración

Variables de entorno opcionales:

Var	Default	Propósito
AUSTIN_SODA_APP_TOKEN	sin definir	App token de Socrata. Aumenta el límite de tasa en data.austintexas.gov + datahub.austintexas.gov. Registro gratuito.
LOCAL_AUSTIN_MCP_TIER	all	Establecer a core para registrar solo las 14 herramientas más utilizadas (ahorra ~20 espacios de herramientas si tu cliente tiene un límite flexible).
VOW_PUBLIC_BASE	https://vow-api.re-workflow.com/public	Sobrescribe la URL base de Neuhaus VOW. Se usa para pruebas / staging.
AUSTIN_CACHE_DISABLED	sin definir	Establecer a 1 para omitir el geocodificador en memoria / caché de FEMA.
AUSTIN_LIMIT_<SOURCE>	varía	Sobrescribe el límite de concurrencia por fuente. Fuentes: SODA, ARCGIS, FEMA, CENSUS, TRAVIS_TAX, VOW_PUBLIC, NWS, RSS. Ejemplo: AUSTIN_LIMIT_SODA=8.

---

Pruébalo

Una vez instalado, pregúntale a Claude cosas como:

• "Muéstrame casas de 3 dormitorios en 78704 por menos de $700k con piscina."
• "Dime todo sobre 9501 San Lucas Dr en Austin — valor, impuestos, permisos, zona de inundación, escuelas."
• "¿Cómo está el nivel del Lake Travis ahora mismo?"
• "¿Quién es el representante del consejo municipal para 1100 Congress Ave?"
• "Tráeme los incidentes de AFD de las últimas 24 horas cerca de mi dirección."
• "¿Sobre qué votó el Concejo Municipal de Austin respecto a las ordenanzas de alquiler a corto plazo?"
• "Encuéntrame condominios en Tarrytown — ¿cuál es el inventario activo?"
• "¿Qué escribió Ed Neuhaus sobre el mercado de Austin en 2026?"
• "¿Hay una alerta activa de zona de inundación para 78731 ahora mismo?"
• "Consulta TCAD para 1234 Main St en Round Rock."
• "¿Qué sucursal de biblioteca está más cerca de 78704? ¿Horarios y servicios?"
• "¿Cuántos incidentes de uso de fuerza de APD se reportaron en el último mes?"
• "¿Dónde está la estación de bomberos más cercana a mi propiedad?"
• "¿Cuál es el puntaje más reciente de inspección de salud para Franklin Barbecue?"
• "¿Se ha emitido algún permiso de remoción de árboles en esta dirección?"
• "¿Qué proyectos de TxDOT están programados en la I-35 en el Condado Travis?"
• "¿Ha recibido Austin Animal Center algún calicó perdido cerca de 78704 este mes?"
• "¿Qué día es la recolección de basura en 1610 Willow St?"
• "¿Cuándo pasa el próximo autobús 801 por Congress y Oltorf?"

Claude determina qué herramienta llamar, consulta la fuente autorizada en vivo, y devuelve una source_url para que puedas verificar.

---

Herramientas (43 activas)

Todas las herramientas son de solo lectura, idempotentes, y consultan proveedores externos (readOnlyHint: true, idempotentHint: true, openWorldHint: true en anotaciones MCP). La austin_property_360 compuesta es el punto de entrada preferido para cualquier pregunta centrada en una dirección.

Bienes Raíces (proporcionado por Neuhaus Realty Group — gratis, sin inicio de sesión)

Herramienta	Qué hace
austin_active_listings	Busca listados MLS activos en venta por ciudad / código postal / distrito escolar / subdivisión + precio / dormitorios / características. Solo activos y pendientes de contrato.
austin_listing_detail	Trae un listado individual por ID de MLS — precio, dormitorios, pies cuadrados, características, fotos, enlace permanente de neuhausre.com.
austin_listing_by_address	Encuentra un listado activo por dirección.
austin_neighborhood_lookup	Busca o consulta vecindarios del área de Austin, con listados activos de muestra.
austin_search_blog	Busca en el blog de bienes raíces de Austin de Ed Neuhaus en neuhausre.com.

Propiedad (valuación del condado + impuestos + zonificación + permisos)

Herramienta	Qué hace
austin_travis_cad	Consulta de propiedad Travis CAD (propietario, valor, escrituras) vía API de True Prodigy.
austin_williamson_cad	Consulta de Williamson CAD vía ArcGIS.
austin_hays_cad	Consulta de Hays CAD vía ArcGIS.
austin_travis_tax	Oficina de Impuestos del Condado Travis — factura actual, exenciones, morosidad.
austin_mud_pid	Superposición de distritos especiales MUD / PID (Contralor de Texas).
austin_utility_providers	Quién proporciona agua + alcantarillado en una dirección del Condado Travis (titular del CCN), con guía de cómo iniciar. La pregunta del "quién enciende mi agua" para los recién llegados. Fuente: límites CCN de la PUC vía GIS del Condado Travis.
austin_fema_flood	Consulta de zona de inundación FEMA NFHL.
austin_permits	Historial completo de permisos para cualquier dirección de la Ciudad de Austin.
austin_code_cases	Casos de cumplimiento de código activos e históricos.
austin_zoning	Zonificación de Austin + dimensiones del lote + consulta de plano.
austin_city_code	Búsqueda de texto completo + recuperación de secciones del TEXTO del código municipal — Código de Ordenanzas de Austin, Código de Desarrollo de Tierras, manuales de criterios (además de Leander, Round Rock, Dripping Springs) vía Municode.
austin_tree_permits	Permisos de árboles emitidos por la Ciudad de Austin — remoción / patrimonial / trabajo en zona de raíces. Útil para preparación de listados y diligencia debida de compradores.
austin_property_360	Compuesta: una dirección → CAD + impuestos + inundación + permisos + código + 311 + zonificación en una sola consulta.
austin_relocation	Informe compuesto de nuevo residente: una dirección → proveedor de agua + alcantarillado, impuestos de distritos especiales, distrito escolar / precinto de votación / jurisdicción, y la lista de verificación de mudanza a Texas (licencia, registro, registro de votante, exención de vivienda). El punto de entrada del "me estoy mudando aquí, ¿qué tengo que configurar?".
austin_nearby	Compuesta: una dirección → estación de bomberos, biblioteca y parque más cercanos, clasificados por distancia en línea recta vía consulta geoespacial SoQL (sin clasificación en el lado del cliente).
austin_commute	Compuesta: tiempo de conducción + distancia entre dos direcciones. Enrutamiento de 3 niveles sin clave (demonio OSRM → demonio Valhalla → estimación en línea recta) para que nunca falle por completo. Sin tráfico en tiempo real.

Cívico + Seguridad Pública

Herramienta	Qué hace
austin_311	Solicitudes de servicio 311 de la Ciudad de Austin.
austin_crime	Reportes de delitos de APD.
austin_afd_incidents	Despachos en tiempo real del Departamento de Bomberos de Austin.
austin_council_votes	Registros de votación del Concejo Municipal — busca por tema, miembro, distrito o fecha.
austin_city_budget	Presupuesto Abierto de la Ciudad de Austin — datos de gastos por departamento, fondo, año fiscal.
austin_district_lookup	Dada una dirección: devuelve distrito del concejo, distrito escolar, ESD, precinto de votación, plan de vecindario.
austin_tea_schools	Asignación de escuelas TEA + asistencia AISD.
austin_libraries	Directorio de sucursales de la Biblioteca Pública de Austin — encuentra una sucursal por nombre, dirección o distrito del concejo. Incluye indicadores de servicios (wifi, computadoras, salas de capacitación).
austin_parks	Parques de la Ciudad de Austin — busca por distrito del concejo, dirección o tipo de parque. Devuelve dirección del predio, tipo de parque (Vecinal / Cinturón Verde / Piscina / Reserva) y estado de desarrollo.
austin_fire_stations	Directorio de estaciones de bomberos de AFD + ESD del Condado Travis — encuentra la estación más cercana a una propiedad. Útil para el contexto de calificación ISO y suscripción de seguros.
austin_police_data	Herramienta unificada de reportes de APD: type=arrests (cargos/fechas/demografía), type=use_of_force (nivel de fuerza/armas/lesiones), o type=dispatch (incidentes CAD 911 con prioridad + categoría de problema).
austin_restaurant_inspections	Puntajes de inspección de establecimientos de alimentos de Austin / Condado Travis (0-100). Filtra por nombre, dirección, código postal, rango de puntaje, fecha.
austin_roadway_work_zones	Construcciones / cierres activos del Departamento de Transporte y Obras Públicas de la Ciudad de Austin.
austin_animal_center	Ingresos + resultados de Austin Animal Center — búsqueda de mascotas perdidas por dirección de hallazgo + raza, disponibilidad de adopción.
austin_txdot_projects	Proyectos de construcción / mantenimiento de carreteras de TxDOT en el distrito de Austin. Filtra por carretera, condado, tipo de trabajo.
austin_trash_schedule	Consulta del día de recolección de basura / reciclaje / compost residencial por dirección. Basura + compost semanal; reciclaje quincenal (semana A/B).

Tránsito

Herramienta	Qué hace
austin_next_bus	CapMetro autobús/ferrocarril en tiempo real: encuentra una parada por nombre (stop_search), obtén llegadas próximas en vivo en una parada (stop_id), o ve las posiciones de vehículos en vivo para una ruta (route). Actualización del feed cada 15 segundos.

Medio Ambiente

Herramienta	Qué hace
austin_nws_alerts	Alertas activas del Servicio Meteorológico Nacional para una ubicación en Austin.
austin_lake_travis_level	Nivel del embalse de Lake Travis (y otros Highland Lakes) + tendencia de 30 días.

Comunidad

Herramienta	Qué hace
austin_local_voices	Busca publicaciones recientes en un conjunto seleccionado de escritores independientes de Austin y boletines comunitarios (Eric Webb, Jason Stanford, ATX Writing Club, 365 Things Austin, Camille Styles, Scott Francis, Austin Is Burning). Filtra por palabra clave, fuente y actualidad.

Meta

Herramienta	Qué hace
about	Resumen de versión + capacidades.
austin_health	Hace ping a cada proveedor upstream en paralelo y reporta {status, http, latency_ms, last_error} por fuente. Úsala cuando muchas herramientas estén dando errores y necesites saber qué proveedor está caído vs qué herramienta está rota.

---

Recursos MCP

Además de las herramientas, el servidor publica documentos de referencia estáticos vía la API de resources/* de MCP:

URI	Qué es
austin://datasets/index	Cada proveedor upstream, notas de cobertura, cadencia de actualización, URLs autorizadas.
austin://coverage/map	Qué condados / ciudades cubre cada herramienta.
austin://faq	Problemas comunes (valores redactados de WCAD, datos MLS gratuitos vs restringidos, etc.).

Prompts MCP

Plantillas publicadas por el servidor que encadenan herramientas. Los clientes las muestran como comandos de barra o flujos de un clic:

Nombre	Argumentos	Qué hace
investigate_property	address	Ejecuta austin_property_360 y escribe un informe orientado al comprador con riesgos + conclusión.
compare_addresses	address_a, address_b	austin_property_360 en paralelo sobre dos direcciones, tabla comparativa lado a lado.
neighborhood_brief	zip	Inventario activo + metadatos del vecindario para un código postal.
school_lookup	campus_name, district?	Calificación de responsabilidad TEA + resumen de una línea.
health_check	(ninguno)	Envuelve austin_health con narración.

---

Fuentes de Verdad

Cada herramienta devuelve datos de una fuente oficial y autorizada. Sin agregadores de terceros. Sin resúmenes generados por IA presentados como hechos. Cada respuesta incluye un campo source_url para que puedas verificar el registro subyacente.

Dominio	Fuente
Listados activos de bienes raíces + vecindarios	Neuhaus Realty Group (https://neuhausre.com) — solo activos y pendientes de contrato, sin comparables vendidos, sin inicio de sesión
Registros de propiedades	Travis CAD (True Prodigy API), Williamson + Hays CAD (ArcGIS REST)
Registros de impuestos	Travis County Tax Office
Distritos especiales	Texas Comptroller Special Purpose Districts
Permisos + zonificación + 311 + delitos + violaciones de código + presupuesto + votos del consejo + AFD + bibliotecas + parques + estaciones de bomberos + arrestos de APD / uso de fuerza / despacho CAD + inspecciones de restaurantes + permisos de árboles + zonas de obras viales + ingresos/resultados de refugios de animales	data.austintexas.gov (Socrata SODA API)
Proyectos de carreteras de TxDOT	TxDOT Open Data (ArcGIS)
Zonas de inundación	FEMA NFHL + Austin floodplain GIS
Límites de distritos	Ciudad de Austin + servicios de datos abiertos ArcGIS del condado de Travis
Escuelas	Texas Education Agency + AISD
Niveles de lagos	Texas Water Development Board (Water Data for Texas)
Clima	National Weather Service (api.weather.gov)
Horarios de basura/reciclaje	Austin Resource Recovery (data.austintexas.gov, dataset Recycling Schedules)
Tránsito	CapMetro GTFS + GTFS-realtime, republicado como JSON por el portal de datos abiertos del Texas DOT (data.texas.gov), actualizado cada 15s
Contenido del blog	neuhausre.com WordPress REST API
Voces locales de Austin	Fuentes RSS de 8 escritores independientes de Austin / boletines comunitarios (Substack + WordPress)
Geocodificación	Geocoder del U.S. Census

---

Arquitectura

• Node.js (módulos ES), @modelcontextprotocol/sdk sobre stdio
• Los manejadores de herramientas son sin estado por llamada; cada uno accede a la fuente autorizada en vivo. Una caché opcional en memoria LRU+TTL precede a algunas búsquedas estables (geocoder, FEMA NFHL por lat/lng) durante 24h para evitar llamadas duplicadas dentro de una sesión
• Las herramientas de bienes raíces llaman a un endpoint público gratuito alojado por Neuhaus Realty Group (con límite de tasa por IP, solo activos y pendientes de contrato)
• Sin bases de datos, sin servidores de autenticación, sin claves compartidas incrustadas en el binario
• Todas las llamadas API ascendentes son HTTPS directas del lado del cliente (Socrata, ArcGIS, NWS, etc.) o un paso ligero hacia el endpoint público de Neuhaus
• Los límites de concurrencia por fuente (lib/semaphore.js) evitan que el fan-out compuesto de austin_property_360 sature cualquier proveedor individual
• AsyncLocalStorage lleva el AbortSignal de la solicitud MCP a cada fetch ascendente, de modo que la cancelación del lado del cliente cancela las llamadas en vuelo

Resiliencia (v0.6.0+)

Cada llamada ascendente pasa por lib/retry.js, que:

• Agrega un tiempo de espera AbortController por intento (8–25 s según el perfil)
• Reintenta fallos transitorios (5xx, 429, tiempo de espera, red) con retroceso exponencial con jitter
• Devuelve 4xx tal cual (esos son problemas reales de consulta, no transitorios)
• Lanza un UpstreamError estructurado en el fallo final, nombrando la fuente, el tipo, el estado, los intentos y el último error

Cuando una herramienta presenta un UpstreamError a Claude, el mensaje indica claramente que el MCP está funcionando correctamente, nombra qué proveedor de datos de terceros tiene el problema y sugiere qué hacer a continuación (reintentar en N segundos, probar una herramienta alternativa). Los usuarios y los LLM nunca ven un seguimiento de pila crudo ni un mensaje confuso de “la herramienta falló”.

Seis perfiles de reintento ajustados al comportamiento ascendente: fast (NWS, Census), soda (data.austintexas.gov), arcgis (ArcGIS REST, FEMA, CAD de condados), tcad (Travis CAD vía True Prodigy — también tiene un límite de concurrencia específico), rss (degradación elegante por fuente entre voces locales), scraper (Travis Tax HTML).

Adiciones de v0.10.0

• structuredContent + outputSchema por herramienta — 23 de 36 herramientas publican un esquema de salida basado en Zod (envoltorios de tipo búsqueda) para que los clientes MCP puedan validar, renderizar y generar código SDK tipado; las herramientas restantes compuestas/de entidad única devuelven contenido estructurado abierto.
• Canalización de AbortSignal — la cancelación de solicitudes MCP se propaga a través de AsyncLocalStorage a cada fetch ascendente.
• Límites de concurrencia por fuente (lib/semaphore.js) — depósitos con nombre evitan que el fan-out compuesto de austin_property_360 golpee a cualquier proveedor individual.
• Caché LRU + TTL (lib/cache.js) — caché de 24 h para el geocoder del Census y las búsquedas puntuales de FEMA NFHL.
• Recursos y mensajes MCP — ver secciones anteriores.
• CI con GitHub Actions — matriz de Node 20 + 22, ejecuta pruebas unitarias y el protocolo de enlace MCP en cada push.

Consulta CHANGELOG.md para las notas completas de la versión v0.10.0, incluido el cambio de nombre de la herramienta a la forma con prefijo austin_* (cambio importante).

---

Contacto

Para consultas de colaboración, licencias, patrocinio o prensa:

Neuhaus Realty Group LLC Austin, Texas https://neuhausre.com

Construido por Ed Neuhaus — más sobre cómo está construido: https://edneuhaus.com/projects/local-austin-mcp/