NYC Property Intel

Servidor MCP que dá ao Claude AI acesso a mais de 22 bancos de dados públicos de NYC (violações do DOB, reclamações do HPD, escrituras do ACRIS, vendas do DOF, 311, FDNY, NYPD, despejos, PLUTO) para due diligence imobiliária. Teste gratuito. Experimente sem instalação em nycpropertyintel.com/chat.

GitHub

Experimente este MCPPatrocinado

Documentação

NYC Property Intel

Servidor MCP que dá ao Claude AI acesso a mais de 20 conjuntos de dados de registros públicos de NYC para due diligence imobiliária. Pergunte ao Claude sobre qualquer propriedade em NYC em linguagem simples — violações, ônus, histórico de vendas, propriedade, licenças, estabilização de aluguel, zoneamento, histórico de incêndios, dados de criminalidade e muito mais.

Esta é uma ferramenta de due diligence, não uma ferramenta de avaliação. Ela apenas apresenta dados de registros públicos; não estima valores de propriedade.

Início rápido — Chat na Web (sem configuração)

A maneira mais rápida de experimentar: abra nycpropertyintel.com/chat e pergunte sobre qualquer propriedade em NYC em linguagem simples. 3 consultas gratuitas, sem cadastro — sem instalação, sem token e sem necessidade de cliente Claude.

"What violations does 123 Atlantic Ave, Brooklyn have?"

Guias e consultas gratuitas

Checklist de Due Diligence Imobiliária em NYC — o checklist completo pré-oferta em mais de 20 fontes de dados da cidade
Consulta de Violações HPD em NYC — detalhamento por Classe A/B/C por endereço
Consulta de Violações DOB e ECB em NYC — violações abertas, penalidades do ECB, risco de ônus da Lei Local 153
Consulta de Proprietário de Imóvel em NYC — o proprietário e contatos do HPD por trás de uma LLC
Histórico de Despejos por Endereço em NYC — despejos executados pelo City Marshal, 2017–presente
Verifique se Você Tem um Despejo em seu Registro (NYC) — guia voltado ao inquilino sobre registros judiciais, arquivos de triagem e seus direitos

Início rápido — Claude Code / Desktop (MCP hospedado)

Cadastre-se em nycpropertyintel.com para obter um token de teste gratuito (10 consultas/dia por 30 dias, incluindo até 5 relatórios completos de due diligence). Depois:

Claude Code — execute uma vez no seu terminal:

claude mcp add --transport http nyc-property-intel \
  "https://nyc-property-intel-production.up.railway.app/mcp" \
  --header "Authorization: Bearer YOUR_TOKEN" \
  --scope user

Claude Desktop — adicione a claude_desktop_config.json (Configurações → Desenvolvedor → Editar Config):

{
  "mcpServers": {
    "nyc-property-intel": {
      "type": "http",
      "url": "https://nyc-property-intel-production.up.railway.app/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Depois pergunte ao Claude:

"Look up 350 5th Ave, Manhattan"
"What violations does 123 Atlantic Ave, Brooklyn have?"
"Full due diligence on 123 Atlantic Ave, Brooklyn"

Auto-hospedagem

Pré-requisitos

Python 3.12+
Gerenciador de pacotes uv
PostgreSQL 16+
CLI nycdb (pip install nycdb)

1. Clonar e instalar

git clone https://github.com/ccedacero/nyc-property-intel.git
cd nyc-property-intel
uv sync

2. Configurar o ambiente

cp .env.example .env
# Edit .env:
#   DATABASE_URL=postgresql://nycdb:nycdb@localhost:5432/nycdb
#   NYC_GEOCLIENT_SUBSCRIPTION_KEY=your_key  (optional, improves address resolution)
#   SOCRATA_APP_TOKEN=your_token             (optional, higher rate limits for 311/FDNY/NYPD)

3. Configurar o banco de dados

Opção A: Restaurar a partir de dump (~10 min)

createuser -s nycdb 2>/dev/null; createdb -O nycdb nycdb 2>/dev/null
pg_restore -U nycdb -d nycdb --no-owner --jobs=4 data/nycdb.dump

Opção B: Carregar a partir da fonte (~2,5 horas)

createuser -s nycdb 2>/dev/null; createdb -O nycdb nycdb 2>/dev/null
chmod +x scripts/seed_nycdb.sh
./scripts/seed_nycdb.sh              # all phases
# or incrementally:
./scripts/seed_nycdb.sh --phase A    # core data (~30 min)
./scripts/seed_nycdb.sh --phase B    # sales + DOB (~45 min)
./scripts/seed_nycdb.sh --phase C    # ACRIS + permits (~90 min)

Depois crie índices e visões materializadas:

psql -U nycdb -d nycdb -f scripts/create_indexes.sql
psql -U nycdb -d nycdb -f scripts/create_views.sql

4. Adicionar ao Claude Desktop

{
  "mcpServers": {
    "nyc-property-intel": {
      "command": "uv",
      "args": ["run", "nyc-property-intel"],
      "cwd": "/absolute/path/to/nyc-property-intel",
      "env": {
        "DATABASE_URL": "postgresql://nycdb:nycdb@localhost:5432/nycdb"
      }
    }
  }
}

5. Adicionar ao Claude Code

O .mcp.json na raiz do projeto se registra automaticamente quando você abre este diretório. Ou adicione manualmente a ~/.claude.json:

{
  "mcpServers": {
    "nyc-property-intel": {
      "command": "uv",
      "args": ["run", "nyc-property-intel"],
      "cwd": "/absolute/path/to/nyc-property-intel"
    }
  }
}

18 Ferramentas

Ferramenta	Descrição
`lookup_property`	Resolva qualquer endereço ou BBL de NYC para um perfil completo da propriedade: proprietário, classe de construção, zoneamento, FAR, valor avaliado, dimensões do lote. Sempre chame isso primeiro.
`get_property_issues`	Violações habitacionais do HPD (Classe A/B/C), violações do código de construção do DOB e penalidades monetárias do ECB/OATH. Filtre por gravidade, status e data.
`get_property_history`	Registros de vendas do DOF e transferências de escritura do ACRIS. Trajetória de preços, nomes de compradores/vendedores, tipos de documento desde 2003.
`get_hpd_complaints`	Reclamações de inquilinos ao HPD — indicadores antecipados de problemas no edifício antes que violações formais sejam emitidas.
`get_hpd_litigations`	Casos de tribunal habitacional do HPD, julgamentos abertos e conclusões de assédio contra proprietários de edifícios.
`get_hpd_registration`	Registros de proprietário legal, agente administrador e oficial responsável.
`get_building_permits`	Registros de trabalho do DOB: novas construções, alterações, demolições, licenças de letreiros. Status, estimativa de custo, nome do solicitante.
`get_liens_and_encumbrances`	Entradas da lista de venda de ônus fiscais do DOF e registros de hipotecas do ACRIS. Ônus pendentes, nomes de credores, valores, quitações.
`get_tax_info`	Avaliações fiscais, estimativas de valor de mercado, valor tributável e isenções ativas (421a, J-51, STAR).
`get_rent_stabilization`	Contagens de unidades estabilizadas por ano (2007–2017). Análise de tendência para sinal de desregulamentação.
`search_comps`	Vendas comparáveis por CEP. Filtre por classe de construção, preço, data. Inclui estatísticas de mercado trimestrais.
`search_neighborhood_stats`	Agregados em nível de área: estoque de propriedades, preços medianos de venda, taxas de violação, participação de estabilização de aluguel.
`get_fdny_fire_incidents`	Histórico de incidentes de incêndio e emergência do FDNY. Tipo de incêndio, nível de alarme, propagação, vítimas, duração. 2013–presente, carregado do NYC Open Data.
`get_311_complaints`	Solicitações de serviço 311 no imóvel ou próximas a ele. Ruído, roedores, calor, descarte ilegal e mais de 200 tipos. 2010–presente, carregado do NYC Open Data.
`get_evictions`	Despejos executados por marshal por endereço. Residenciais e comerciais. 2017–presente, carregado do NYC Open Data.
`get_dob_complaints`	Reclamações ao DOB registradas antes das violações formais — o sinal público mais precoce de problemas de construção ou segurança.
`get_nypd_crime`	Reclamações de crimes do NYPD em um raio configurável (padrão 300 m ≈ 3 quarteirões). Detalhamento de crimes graves/contravenções, principais delitos, tendência ano a ano.
`analyze_property`	Resumo completo de due diligence — executa todas as subconsultas simultaneamente. Perfil da propriedade, análise de FAR, finanças, fatores de risco, estabilização de aluguel, vendas comparáveis e observações principais.

Fontes de Dados

Os dados principais (~19 milhões de linhas) são carregados do nycdb. Todos os conjuntos de dados são carregados no PostgreSQL. A API Socrata é usada apenas como fallback.

Conjunto de Dados	Agência	Notas
PLUTO	DCP	Perfis de propriedade, zoneamento, FAR, classe de construção
PAD	DCP	Resolução de endereço para BBL
HPD Violations	HPD	Violações do código habitacional por classe e status
HPD Complaints	HPD	Registros de reclamações de inquilinos
HPD Registrations	HPD	Registro de proprietário/agente/oficial
HPD Litigations	HPD	Casos de tribunal habitacional
DOB Violations	DOB	Violações do código de construção
ECB Violations	OATH/ECB	Penalidades do Environmental Control Board
DOF Rolling Sales	DOF	Vendas recentes de propriedades
DOF Annual Sales	DOF	Vendas históricas 2003–presente
DOF Assessments	DOF	Avaliações fiscais e rolos de avaliação
DOF Exemptions	DOF	Registros de isenção fiscal (421a, J-51, STAR)
DOF Tax Liens	DOF	Lista anual de venda de ônus
Rent Stabilization	DOF	Contagens de unidades estabilizadas por edifício, 2007–2017 (derivadas de contas fiscais do DOF via taxbills.nyc / JustFix)
ACRIS	DOF	Escrituras, hipotecas, ônus, quitações, registros UCC
FDNY Fire Incidents	FDNY	2013–presente
311 Service Requests	311/DOITT	2010–presente
Marshal Evictions	DOI	2017–presente
DOB Complaints	DOB	Carregado do NYC Open Data
NYPD Crime Data	NYPD	2006–presente, raio geoespacial

Arquitetura

src/nyc_property_intel/
  app.py              # FastMCP instance + system prompt
  server.py           # Entry point: lifespan, auth middleware, tool registration
  config.py           # pydantic-settings (reads .env / environment variables)
  db.py               # asyncpg connection pool + query helpers
  auth.py             # Token validation, rate limiting, usage logging
  analytics.py        # PostHog event capture (fire-and-forget)
  geoclient.py        # NYC GeoClient API + PAD fallback for address resolution
  socrata.py          # Socrata Open Data API client — fallback for FDNY, 311, NYPD, evictions
  loops_webhook.py    # Loops.so webhook → auto-provision trial tokens on signup
  tools/
    lookup.py         # lookup_property
    issues.py         # get_property_issues
    history.py        # get_property_history
    hpd_complaints.py # get_hpd_complaints
    hpd_litigations.py# get_hpd_litigations
    hpd_registration.py# get_hpd_registration
    permits.py        # get_building_permits
    liens.py          # get_liens_and_encumbrances
    tax.py            # get_tax_info
    rentstab.py       # get_rent_stabilization
    comps.py          # search_comps
    neighborhood.py   # search_neighborhood_stats
    fdny.py           # get_fdny_fire_incidents
    complaints_311.py # get_311_complaints
    evictions.py      # get_evictions
    dob_complaints.py # get_dob_complaints
    nypd_crime.py     # get_nypd_crime
    analysis.py       # analyze_property
scripts/
  seed_nycdb.sh         # Downloads and loads all nycdb datasets
  create_indexes.sql    # Performance indexes on critical columns
  create_views.sql      # Materialized views for fast property lookup
  manage_tokens.py      # CLI for provisioning and managing customer tokens

Desenvolvimento

uv run pytest tests/test_utils.py -q          # unit tests (no DB needed)
uv run pytest tests/ -m integration -q        # integration tests (needs live DB)
uv run ruff check src/                         # lint
uv run nyc-property-intel                      # run server locally (stdio)

Habitação Justa

O NYC Property Intel fornece dados de construção e propriedade apenas de registros públicos da cidade. Ele não fornece dados demográficos, triagem de inquilinos ou qualquer análise baseada em características protegidas. Consulte nycpropertyintel.com/#fair-housing para a política completa.

Licença

MIT