GeoSampa MCP

O que dá pra perguntar

Linguagem natural — o assistente escolhe a ferramenta certa e cruza os dados.

“Posso construir um prédio de 5 andares com 24 apartamentos na Avenida Paulista, 1578?”
“Qual o zoneamento e a área do lote da Av. Paulista, 1578?”
“Quais os parâmetros de construção numa ZEU? E numa ZER?”
“Tem alguma área de risco de inundação perto da Praça da Sé?”
“Liste os hospitais e escolas públicas cadastrados no GeoSampa.”

7 ferramentas

Construídas sobre o WFS aberto do GeoSampa (~470 camadas) + os parâmetros do Plano Diretor / Lei de Zoneamento.

buscar_lote_por_endereco

Acha o lote por rua + número. Retorna SQL, área, uso e zoneamento.

viabilidade_construtiva

“Posso construir N andares e M apartamentos aqui?” — área × parâmetros da zona.

consultar_lote

Dados de um lote pelo SQL (do carnê do IPTU) + zoneamento.

parametros_zona

Coeficiente de aproveitamento, gabarito e taxa de ocupação de cada zona.

zoneamento

Zona vigente num ponto (latitude/longitude).

listar_camadas / consultar_camada

Descobre e consulta qualquer uma das ~470 camadas do GeoSampa.

Como configurar no Claude

O jeito mais fácil é conectar ao servidor hospedado. Para devs, dá pra rodar localmente.

Endpoint

Servidor remoto: https://geosampa.sarmento.dev/mcp

Opção A — Claude Desktop / Claude.ai (conector remoto)

Abra Settings → Connectors → Add custom connector, dê um nome (“GeoSampa”) e cole a URL:

https://geosampa.sarmento.dev/mcp

Salve e ative. Pronto — pergunte algo como “qual o zoneamento da Av. Paulista, 1578?”

Opção B — Claude Code (1 comando)

claude mcp add --transport http geosampa https://geosampa.sarmento.dev/mcp

Opção C — Local (stdio, para desenvolvedores)

Clone, compile e aponte o Claude Desktop para o binário:

git clone https://github.com/sarment0/geosampa-mcp.git
cd geosampa-mcp
npm install && npm run build

No claude_desktop_config.json:

{
  "mcpServers": {
    "geosampa": {
      "command": "node",
      "args": ["/caminho/para/geosampa-mcp/dist/index.js"]
    }
  }
}

⚠️ Sobre potencial construtivo: a estimativa de viabilidade é preliminar e não vinculante. Baseia-se no Quadro 3 da LPUOS (Lei 16.402/2016, consolidada com a Lei 18.081/2024). Não substitui a Consulta de Lote/Certidão oficial da Prefeitura nem a análise de um arquiteto ou engenheiro habilitado.