Local Austin MCP

Local Austin MCP

O guia local da sua IA para Austin. Um servidor Model Context Protocol (MCP) que permite ao Claude (e a qualquer cliente MCP) responder às perguntas reais que as pessoas fazem quando pesquisam um imóvel, compram ou se mudam para a região de Austin — "quem liga a água na minha casa neste endereço?", "quais são as escolas e os impostos de distritos especiais?", "está em zona de inundação?", "o que está à venda neste bairro?" — puxando direto das fontes oficiais da Cidade de Austin / Condados Travis-Williamson-Hays, além de listagens imobiliárias ativas e escritores locais, tudo fornecido pela Neuhaus Realty Group. Sem chaves de API, sem logins.

Licença: Código aberto sob Apache License 2.0 — livre para usar, modificar e construir em cima, inclusive comercialmente. Por favor, mantenha a atribuição do NOTICE ao redistribuir. A licença Apache não concede direitos de marca: "Neuhaus Realty Group" e as marcas Neuhaus permanecem nossas (veja TRADEMARK.md). Proprietário: Ed Neuhaus / Neuhaus Realty Group LLC, Austin, Texas. Fonte: https://github.com/mindwear-capitian/local-austin-mcp Desenvolvido por: Neuhaus Realty Group — https://neuhausre.com (listagens imobiliárias ativas, páginas de bairros e conteúdo de blog exibidos por este MCP vêm de neuhausre.com).

🚧 Este é um projeto inicial e adoraria ajuda para melhorá-lo. Sou corretor e construí isto para dar a uma IA uma compreensão real e em linguagem simples sobre Austin. Funciona, mas há muito mais dados sobre Austin que valem a pena integrar e alguns problemas difíceis que ainda não resolvi. Se você desenvolve com MCPs ou conhece dados cívicos de Austin/Texas, pull requests e ideias são genuinamente bem-vindos — veja CONTRIBUTING.md e as boas primeiras issues.

🏙️ Construindo isto para a sua própria cidade? Este repositório é a implementação de referência para o padrão local-{city}-mcp. A especificação, um template funcional e a lista completa de cidades já construídas estão todos em local-city-mcp-template — comece por lá.

---

Instalação

Adicione ao seu arquivo de configuração do Claude Desktop:

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

Reinicie o Claude Desktop. Essa é toda a configuração. Nenhuma chave de API é necessária para qualquer ferramenta.

Claude Code

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

Configuração

Variáveis de ambiente opcionais:

Variável	Padrão	Finalidade
AUSTIN_SODA_APP_TOKEN	não definido	Token de aplicativo Socrata. Aumenta o limite de taxa em data.austintexas.gov + datahub.austintexas.gov. Cadastro gratuito.
LOCAL_AUSTIN_MCP_TIER	all	Defina como core para registrar apenas as 14 ferramentas mais usadas (economiza ~20 slots de ferramentas se o seu cliente tiver um limite flexível).
VOW_PUBLIC_BASE	https://vow-api.re-workflow.com/public	Substitui a URL base do Neuhaus VOW. Usado para testes / staging.
AUSTIN_CACHE_DISABLED	não definido	Defina como 1 para ignorar o geocodificador em memória / cache FEMA.
AUSTIN_LIMIT_<SOURCE>	varia	Substitui o limite de concorrência por fonte. Fontes: SODA, ARCGIS, FEMA, CENSUS, TRAVIS_TAX, VOW_PUBLIC, NWS, RSS. Exemplo: AUSTIN_LIMIT_SODA=8.

---

Experimente

Depois de instalado, pergunte ao Claude coisas como:

• "Mostre-me casas de 3 quartos em 78704 abaixo de $700k com piscina."
• "Me conte tudo sobre 9501 San Lucas Dr em Austin — valor, impostos, licenças, zona de inundação, escolas."
• "Qual é o nível do Lago Travis agora?"
• "Quem é o representante do conselho municipal para 1100 Congress Ave?"
• "Puxe incidentes do AFD de Austin das últimas 24 horas perto do meu endereço."
• "Sobre o que o Conselho Municipal de Austin votou em relação às ordenanças de aluguel de curto prazo?"
• "Encontre condomínios em Tarrytown — qual é o inventário ativo?"
• "O que Ed Neuhaus escreveu sobre o mercado de Austin em 2026?"
• "Há um alerta ativo de zona de inundação para 78731 agora?"
• "Puxe TCAD para 1234 Main St em Round Rock."
• "Qual filial da biblioteca é a mais próxima de 78704? Horários e comodidades?"
• "Quantos incidentes de uso de força da APD foram relatados no último mês?"
• "Onde fica o quartel de bombeiros mais próximo da minha propriedade?"
• "Qual é a pontuação mais recente da inspeção sanitária do Franklin Barbecue?"
• "Alguma licença de remoção de árvores já foi emitida neste endereço?"
• "Quais projetos da TxDOT estão programados na I-35 no Condado de Travis?"
• "O Austin Animal Center recebeu algum gato tricolor perdido perto de 78704 neste mês?"
• "Em que dia é a coleta de lixo na 1610 Willow St?"
• "Quando é o próximo ônibus 801 passando pela Congress e Oltorf?"

O Claude descobre qual ferramenta chamar, consulta a fonte oficial ao vivo e retorna um source_url para você verificar.

---

Ferramentas (43 ativas)

Todas as ferramentas são somente leitura, idempotentes e acessam provedores externos (readOnlyHint: true, idempotentHint: true, openWorldHint: true nas anotações MCP). O austin_property_360 composto é o ponto de entrada preferido para qualquer pergunta centrada em endereço.

Imobiliário (fornecido pela Neuhaus Realty Group — gratuito, sem login)

Ferramenta	O que faz
austin_active_listings	Pesquisa listagens MLS ativas à venda por cidade / CEP / distrito escolar / subdivisão + preço / quartos / recursos. Somente ativas e em contrato.
austin_listing_detail	Puxa uma única listagem por ID MLS — preço, quartos, metragem, recursos, fotos, link permanente neuhausre.com.
austin_listing_by_address	Encontra uma listagem ativa pelo endereço da rua.
austin_neighborhood_lookup	Pesquisa ou consulta bairros da região de Austin, com exemplos de listagens ativas.
austin_search_blog	Pesquisa o blog imobiliário de Austin de Ed Neuhaus em neuhausre.com.

Propriedade (avaliação do condado + impostos + zoneamento + licenças)

Ferramenta	O que faz
austin_travis_cad	Consulta de propriedade do Travis CAD (proprietário, valor, escrituras) via API True Prodigy.
austin_williamson_cad	Consulta do Williamson CAD via ArcGIS.
austin_hays_cad	Consulta do Hays CAD via ArcGIS.
austin_travis_tax	Escritório de Impostos do Condado de Travis — conta atual, isenções, inadimplências.
austin_mud_pid	Sobreposição de distritos especiais MUD / PID (Controlador do Texas).
austin_utility_providers	Quem fornece água + esgoto em um endereço do Condado de Travis (titular do CCN), com orientações de como iniciar. A pergunta "quem liga minha água" para recém-chegados. Fonte: limites CCN da PUC via GIS do Condado de Travis.
austin_fema_flood	Consulta de zona de inundação FEMA NFHL.
austin_permits	Histórico completo de licenças para qualquer endereço da Cidade de Austin.
austin_code_cases	Casos ativos e históricos de conformidade com o código.
austin_zoning	Zoneamento de Austin + dimensões do lote + consulta de planta.
austin_city_code	Pesquisa de texto completo + busca de seções do TEXTO do código municipal — Código de Ordenanças de Austin, Código de Desenvolvimento de Terras, manuais de critérios (mais Leander, Round Rock, Dripping Springs) via Municode.
austin_tree_permits	Licenças de árvores emitidas pela Cidade de Austin — remoção / patrimoniais / trabalho na zona de raízes. Útil para preparação de listagem e due diligence do comprador.
austin_property_360	Composto: um endereço → CAD + impostos + inundação + licenças + código + 311 + zoneamento em uma única chamada.
austin_relocation	Relatório composto para novos residentes: um endereço → provedor de água + esgoto, impostos de distritos especiais, distrito escolar / zona eleitoral / jurisdição, e a lista de verificação de mudança para o Texas (licença, registro, registro de eleitor, isenção de residência). O ponto de entrada "estou me mudando para cá, o que preciso configurar?".
austin_nearby	Composto: um endereço → quartel de bombeiros, biblioteca e parque mais próximos, classificados por distância em linha reta via consulta geoespacial SoQL (sem ordenação no lado do cliente).
austin_commute	Composto: tempo de viagem + distância entre dois endereços. Roteamento em 3 níveis sem chave (demo OSRM → demo Valhalla → estimativa em linha reta) para nunca falhar completamente. Sem tráfego em tempo real.

Cívico + Segurança Pública

Ferramenta	O que faz
austin_311	Solicitações de serviço 311 da Cidade de Austin.
austin_crime	Relatórios de crimes da APD.
austin_afd_incidents	Despachos em tempo real do Corpo de Bombeiros de Austin.
austin_council_votes	Registros de votação do Conselho Municipal — pesquise por tópico, membro, distrito ou data.
austin_city_budget	Orçamento Aberto da Cidade de Austin — dados de despesas por departamento, fundo, ano fiscal.
austin_district_lookup	Dado um endereço: retorna distrito do conselho, distrito escolar, ESD, zona eleitoral, plano de bairro.
austin_tea_schools	Atribuição de escolas TEA + frequência AISD.
austin_libraries	Diretório de filiais da Austin Public Library — encontre uma filial por nome, endereço ou distrito do conselho. Inclui indicadores de comodidades (wifi, computadores, salas de treinamento).
austin_parks	Parques da Cidade de Austin — pesquise por distrito do conselho, endereço ou tipo de parque. Retorna endereço do lote, tipo de parque (Bairro / Cinturão Verde / Piscina / Reserva) e status de desenvolvimento.
austin_fire_stations	Diretório de quartéis de bombeiros AFD + ESD do Condado de Travis — encontre o quartel mais próximo de uma propriedade. Útil para contexto de classificação ISO e subscrição de seguros.
austin_police_data	Ferramenta unificada de relatórios da APD: type=arrests (acusações/datas/demografia), type=use_of_force (nível de força/armas/lesões) ou type=dispatch (incidentes CAD 911 com prioridade + categoria de problema).
austin_restaurant_inspections	Pontuações de inspeção de estabelecimentos de alimentação de Austin / Condado de Travis (0-100). Filtre por nome, endereço, CEP, faixa de pontuação, data.
austin_roadway_work_zones	Construções / fechamentos ativos da Transporte e Obras Públicas da Cidade de Austin.
austin_animal_center	Entradas e resultados do Austin Animal Center — busca de animais perdidos por endereço de encontro + raça, disponibilidade de adoção.
austin_txdot_projects	Projetos de construção / manutenção de rodovias TxDOT no distrito de Austin. Filtre por rodovia, condado, tipo de obra.
austin_trash_schedule	Consulta do dia de coleta de lixo residencial / reciclagem / compostagem por endereço. Lixo + compostagem semanal; reciclagem quinzenal (semana A/B).

Trânsito

Ferramenta	O que faz
austin_next_bus	CapMetro em tempo real ônibus/trilho: encontre uma parada por nome (stop_search), obtenha chegadas ao vivo em uma parada (stop_id) ou veja posições de veículos ao vivo para uma rota (route). Atualizações do feed a cada 15 segundos.

Meio Ambiente

Ferramenta	O que faz
austin_nws_alerts	Alertas ativos do National Weather Service para um local em Austin.
austin_lake_travis_level	Nível do reservatório do Lago Travis (e outros Highland Lakes) + tendência de 30 dias.

Comunidade

Ferramenta	O que faz
austin_local_voices	Pesquisa postagens recentes em um conjunto selecionado de escritores independentes de Austin e boletins comunitários (Eric Webb, Jason Stanford, ATX Writing Club, 365 Things Austin, Camille Styles, Scott Francis, Austin Is Burning). Filtre por palavra-chave, fonte e recência.

Meta

Ferramenta	O que faz
about	Resumo de versão + capacidades.
austin_health	Pinga todos os provedores upstream em paralelo e relata {status, http, latency_ms, last_error} por fonte. Use quando muitas ferramentas estiverem com erro e você precisar saber qual provedor está fora do ar versus qual ferramenta está quebrada.

---

Recursos MCP

Além das ferramentas, o servidor publica documentos de referência estáticos via API resources/* do MCP:

URI	O que é
austin://datasets/index	Cada provedor upstream, notas de cobertura, cadência de atualização, URLs oficiais.
austin://coverage/map	Quais condados / cidades cada ferramenta cobre.
austin://faq	Armadilhas comuns (valores redigidos do WCAD, dados MLS gratuitos vs. restritos, etc.).

Prompts MCP

Modelos publicados pelo servidor que encadeiam ferramentas. Os clientes os exibem como comandos de barra ou fluxos de um clique:

Nome	Argumentos	O que faz
investigate_property	address	Executa austin_property_360 e escreve um resumo voltado ao comprador com riscos + conclusão.
compare_addresses	address_a, address_b	austin_property_360 em paralelo em dois endereços, tabela lado a lado.
neighborhood_brief	zip	Inventário ativo + metadados do bairro para um CEP.
school_lookup	campus_name, district?	Classificação de responsabilidade TEA + resumo de 1 linha.
health_check	(nenhum)	Envolve austin_health com narração.

---

Fontes da Verdade

Cada ferramenta retorna dados de uma fonte oficial e autoritativa. Sem agregadores de terceiros. Sem resumos gerados por IA apresentados como fato. Cada resposta inclui um campo source_url para que você possa verificar o registro subjacente.

Domínio	Fonte
Listagens imobiliárias ativas + bairros	Neuhaus Realty Group (https://neuhausre.com) — apenas ativos + sob contrato, sem comparáveis vendidos, sem login
Registros de propriedades	Travis CAD (True Prodigy API), Williamson + Hays CAD (ArcGIS REST)
Registros fiscais	Travis County Tax Office
Distritos especiais	Texas Comptroller Special Purpose Districts
Permissões + zoneamento + 311 + crime + violações de código + orçamento + votos do conselho + AFD + bibliotecas + parques + estações de bombeiros + prisões do APD / uso de força / despacho CAD + inspeções de restaurantes + permissões de árvores + zonas de obras rodoviárias + entradas/resultados de abrigos de animais	data.austintexas.gov (Socrata SODA API)
Projetos rodoviários do TxDOT	TxDOT Open Data (ArcGIS)
Zonas de inundação	FEMA NFHL + Austin floodplain GIS
Limites de distritos	City of Austin + Travis County ArcGIS open-data services
Escolas	Texas Education Agency + AISD
Níveis de lagos	Texas Water Development Board (Water Data for Texas)
Clima	National Weather Service (api.weather.gov)
Agendas de lixo/reciclagem	Austin Resource Recovery (data.austintexas.gov, Recycling Schedules dataset)
Transporte público	CapMetro GTFS + GTFS-realtime, republicado como JSON pelo portal de dados abertos da Texas DOT (data.texas.gov), atualizado a cada 15s
Conteúdo do blog	neuhausre.com WordPress REST API
Vozes locais de Austin	RSS feeds de 8 escritores independentes de Austin / boletins comunitários (Substack + WordPress)
Geocodificação	U.S. Census geocoder

---

Arquitetura

• Node.js (módulos ES), @modelcontextprotocol/sdk sobre stdio
• Os manipuladores de ferramentas são sem estado por chamada; cada um acessa a fonte autoritativa ao vivo. Um cache opcional em memória LRU+TTL protege algumas consultas estáveis (geocodificador, FEMA NFHL por lat/lng) por 24h para evitar chamadas duplicadas dentro de uma sessão
• As ferramentas imobiliárias chamam um endpoint público gratuito hospedado pela Neuhaus Realty Group (limitado por IP, apenas ativos + sob contrato)
• Sem bancos de dados, sem servidores de autenticação, sem chaves compartilhadas embutidas no binário
• Todas as chamadas de API upstream são HTTPS direto do lado do cliente (Socrata, ArcGIS, NWS, etc.) ou um pass-through fino para o endpoint público da Neuhaus
• Limites de concorrência por fonte (lib/semaphore.js) impedem que o fan-out composto austin_property_360 sature qualquer provedor individual
• AsyncLocalStorage carrega o AbortSignal da solicitação MCP para cada fetch upstream, para que o cancelamento do lado do cliente cancele chamadas em andamento

Resiliência (v0.6.0+)

Cada chamada upstream passa por lib/retry.js, que:

• Adiciona um tempo limite AbortController por tentativa (8-25s dependendo do perfil)
• Repete falhas transitórias (5xx, 429, timeout, rede) com backoff exponencial com jitter
• Retorna 4xx como está (esses são problemas reais de consulta, não transitórios)
• Lança um UpstreamError estruturado em falha final, nomeando a fonte, o tipo, o status, as tentativas e o último erro

Quando uma ferramenta apresenta um UpstreamError ao Claude, a mensagem afirma claramente que o MCP está funcionando corretamente, nomeia qual provedor de dados de terceiros está com problema e sugere o que fazer a seguir (tentar novamente em N segundos, tentar uma ferramenta alternativa). Usuários + LLMs nunca veem um stack trace bruto ou uma mensagem confusa de "erro de ferramenta".

Seis perfis de repetição ajustados ao comportamento upstream: fast (NWS, Census), soda (data.austintexas.gov), arcgis (ArcGIS REST, FEMA, CADs do condado), tcad (Travis CAD via True Prodigy — também tem limite de concorrência personalizado), rss (degradação graciosa por fonte em vozes locais), scraper (Travis Tax HTML).

Adições da v0.10.0

• structuredContent + outputSchema por ferramenta — 23 das 36 ferramentas publicam um esquema de saída baseado em Zod (envelopes estilo busca) para que clientes MCP possam validar, renderizar e gerar código SDK tipado; as ferramentas compostas / de entidade única restantes retornam conteúdo estruturado aberto.
• Encanação de AbortSignal — o cancelamento da solicitação MCP se propaga via AsyncLocalStorage para cada fetch upstream.
• Limites de concorrência por fonte (lib/semaphore.js) — buckets nomeados impedem que o fan-out composto austin_property_360 sobrecarregue qualquer provedor individual.
• Cache LRU + TTL (lib/cache.js) — cache de 24h no geocodificador do Census + consultas de ponto FEMA NFHL.
• Recursos e Prompts do MCP — veja as seções acima.
• GitHub Actions CI — matriz Node 20 + 22, executa testes unitários + handshake MCP a cada push.

Veja CHANGELOG.md para as notas completas da versão v0.10.0, incluindo a renomeação BREAKING do nome da ferramenta para o prefixo austin_*.

---

Contato

Para parcerias, licenciamento, patrocínio ou consultas de imprensa:

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

Construído por Ed Neuhaus — mais sobre como este foi construído: https://edneuhaus.com/projects/local-austin-mcp/