Borough

Servidor MCP

Conecte agentes de IA a dados imobiliários de NYC via o Model Context Protocol

O que é o Borough MCP?

O Borough fornece um servidor Model Context Protocol (MCP) que permite que agentes de IA consultem dados imobiliários de NYC por meio de chamadas de ferramentas em linguagem natural.

Em vez de escrever código para chamar a API REST, você pode fazer perguntas ao seu assistente de IA, como:

• "Encontre apartamentos de 2 quartos em Williamsburg por menos de $4.000/mês"
• "Compare aluguéis entre Park Slope, Astoria e East Village"
• "Obtenha detalhes sobre a propriedade 4961849"

O servidor MCP expõe 10 ferramentas que mapeiam os endpoints da API REST do Borough, com o mesmo acesso baseado em níveis, limites de taxa e aplicação de cotas.

Como Funciona

AI Agent (Claude, Cursor, VS Code)
  ↓ MCP tool call
Borough MCP Server (https://borough.qwady.app/mcp)
  ↓ internal REST call with your API key
Borough REST API (/v1/search/rentals, /v1/property/:id, etc.)
  ↓
Response formatted for AI consumption

Sessões MCP autenticadas são mapeadas para os níveis do Borough, portanto as mesmas restrições de ferramentas, limites de taxa e cotas mensais se aplicam como na API REST.

Métodos de Autenticação

O Borough MCP suporta dois padrões de conexão:

Método	Melhor para	Configuração
Fluxo de conector baseado em OAuth	Claude Connectors e outros clientes MCP compatíveis com OAuth	Descoberto automaticamente via /.well-known/: cole a URL do MCP e complete a autenticação do Borough
Bearer Token	Arquivos de configuração MCP diretos e clientes CLI	cabeçalho Authorization: Bearer BOROUGH-<key>

OAuth é o método recomendado para clientes MCP que o suportam. O acesso MCP de nível gratuito está disponível por meio do fluxo de autenticação do Borough, e chaves de API pagas do Borough habilitam ferramentas MCP adicionais.

Compacto e ciente de localização por padrão

O Borough MCP é otimizado para clientes de chat:

• ferramentas de busca e listagem de edifícios retornam conjuntos de resultados pequenos por padrão
• as respostas das ferramentas são projeções compactas em vez de cargas brutas completas da API
• nomes exatos de bairros como Chelsea, Astoria ou Park Slope podem ser resolvidos diretamente sem precisar procurar IDs manualmente primeiro (cada nome resolvido custa uma requisição extra à API; passe IDs de área numéricos para evitar isso)
• list_areas é o caminho mais seguro quando você quer fixar um ID de área preciso antes de pesquisar
• se uma localização for ambígua, o Borough retorna uma lista curta de esclarecimentos em vez de uma carga de fallback grande
• os resultados de busca e listagem de edifícios incluem campos orientados a renderização, como price, displayPrice, geoPoint, leadPhotoUrl e renderHints
• a renderização de fotos ainda depende do cliente nesta versão, pois o Borough retorna URLs de fotos, não blocos de imagem MCP inline

Ferramentas Disponíveis

Ferramenta	Nível	Descrição
search_rentals	Gratuito	Pesquise listagens de aluguel por nome exato ou ID de área com resultados compactos e prontos para renderização
search_sales	Gratuito	Pesquise listagens de vendas por nome exato ou ID de área com resultados compactos e prontos para renderização
list_areas	Gratuito	Resolve boroughs e vizinhanças por nome ou fixa IDs de área precisos antes de pesquisar
get_market_snapshot	Gratuito (autenticado)	Estatísticas de mercado atuais para um bairro por ID ou nome
get_market_trends	Gratuito (autenticado)	Tendências históricas de preços (até 365 dias) por ID ou nome
compare_neighborhoods	Gratuito (autenticado)	Comparação lado a lado de 1 a 5 áreas por ID ou nome
get_property	Iniciante	Detalhes da listagem incluindo comodidades, taxas, open houses e pontuações do edifício
get_property_by_url	Iniciante	Consulte a listagem pelo caminho da URL
get_building	Iniciante	Detalhes do edifício (comodidades, políticas, pontuações)
get_building_listings	Iniciante	Resumos de listagem compactos e amigáveis para cartões/mapas de um edifício

Próximos Passos

Conecte-se em 2 minutos Documentação detalhada das ferramentas