Borough
Borough le brinda a Claude acceso autenticado a datos inmobiliarios de la ciudad de Nueva York, incluyendo búsqueda de alquileres y ventas, descubrimiento de áreas, detalles de edificios y propiedades, y análisis de mercado.
Documentación
Servidor MCP
Conecta agentes de IA a datos inmobiliarios de NYC mediante el Model Context Protocol
¿Qué es Borough MCP?
Borough proporciona un servidor Model Context Protocol (MCP) que permite a los agentes de IA consultar datos inmobiliarios de NYC mediante llamadas a herramientas en lenguaje natural.
En lugar de escribir código para llamar a la API REST, puedes hacer preguntas a tu asistente de IA como:
- "Encuéntrame apartamentos de 2 habitaciones en Williamsburg por menos de $4,000/mes"
- "Compara alquileres entre Park Slope, Astoria y East Village"
- "Obtén detalles de la propiedad 4961849"
El servidor MCP expone 10 herramientas que se corresponden con los endpoints de la API REST de Borough, con el mismo acceso por niveles, límites de tasa y aplicación de cuotas.
Cómo 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
Las sesiones MCP autenticadas se asignan a los niveles de Borough, por lo que se aplican las mismas restricciones de herramientas, límites de tasa y cuotas mensuales que en la API REST.
Métodos de Autenticación
Borough MCP admite dos patrones de conexión:
| Método | Mejor para | Configuración |
|---|---|---|
| Flujo de conector basado en OAuth | Conectores de Claude y otros clientes MCP compatibles con OAuth | Se descubre automáticamente mediante /.well-known/: pega la URL de MCP y completa la autenticación de Borough |
| Bearer Token | Archivos de configuración MCP directos y clientes CLI | cabecera Authorization: Bearer BOROUGH-<key> |
OAuth es el método recomendado para clientes MCP que lo admiten. El acceso MCP de nivel gratuito está disponible a través del flujo de autenticación de Borough, y las claves de API de Borough de pago habilitan herramientas MCP adicionales.
Compacto y consciente de la ubicación por defecto
Borough MCP está optimizado para clientes de chat:
- las herramientas de búsqueda y listado de edificios devuelven conjuntos de resultados pequeños por defecto
- las respuestas de las herramientas son proyecciones compactas en lugar de cargas útiles completas de la API
- los nombres exactos de vecindarios como
Chelsea,AstoriaoPark Slopese pueden resolver directamente sin buscar IDs manualmente primero (cada nombre resuelto cuesta una solicitud API adicional; pasa IDs de área numéricos para evitarlo) list_areases la vía más segura cuando quieres fijar un ID de área preciso antes de buscar- si una ubicación es ambigua, Borough devuelve una breve lista de aclaración en lugar de una carga útil de respaldo grande
- los resultados de búsqueda y listado de edificios incluyen campos orientados a la representación como
price,displayPrice,geoPoint,leadPhotoUrlyrenderHints - la representación de fotos sigue dependiendo del cliente en esta versión porque Borough devuelve URLs de fotos, no bloques de imágenes MCP en línea
Herramientas Disponibles
| Herramienta | Nivel | Descripción |
|---|---|---|
search_rentals | Gratis | Busca listados de alquiler por nombre exacto o ID de área con resultados compactos y aptos para representación |
search_sales | Gratis | Busca listados de venta por nombre exacto o ID de área con resultados compactos y aptos para representación |
list_areas | Gratis | Resuelve boroughs y vecindarios por nombre o fija IDs de área precisos antes de buscar |
get_market_snapshot | Gratis (autenticado) | Estadísticas de mercado actuales para un vecindario por ID o nombre |
get_market_trends | Gratis (autenticado) | Tendencias históricas de precios (hasta 365 días) por ID o nombre |
compare_neighborhoods | Gratis (autenticado) | Comparación lado a lado de 1-5 áreas por ID o nombre |
get_property | Starter | Detalle del listado incluyendo comodidades, tarifas, jornadas de puertas abiertas y puntuaciones del edificio |
get_property_by_url | Starter | Busca un listado por ruta de URL |
get_building | Starter | Detalle del edificio (comodidades, políticas, puntuaciones) |
get_building_listings | Starter | Resúmenes de listados compactos y aptos para tarjetas/mapas de un edificio |