FlatHunt
Busca y compara habitaciones y apartamentos amueblados en Berlín de múltiples proveedores de vivienda. Gratis para inquilinos; las reservas son gestionadas por el proveedor original.
Documentación
El contrato
Un solo servidor. Sin bifurcación de proveedor.
FlatHunt es un gateway delgado y sin estado entre los hosts de MCP y la plataforma de vivienda FlatHunt.
Cada cliente compatible utiliza el mismo endpoint y los mismos esquemas de herramientas. Los metadatos específicos del host se limitan a la autenticación y la compatibilidad de la interfaz de usuario en el borde del protocolo.
Sin acceso directo a la base de datos Las reglas de negocio permanecen en la API de FlatHunt.
Sin almacenamiento de tokens Tu host de MCP es el propietario de la sesión OAuth.
Transferencia al proveedor Las solicitudes y reservas permanecen con el proveedor original.
Conectar
Lleva el endpoint a tu cliente.
Comienza con la búsqueda anónima. Tu cliente debería pedirte que inicies sesión solo cuando una herramienta de favoritos o alertas necesite acceso a la cuenta.
- Abre la configuración de Claude y añade un conector personalizado.
- Pega
https://mcp.flat-hunt.com/mcp. - Para Autenticación, elige Iniciar sesión cuando sea necesario.
- Para el cliente OAuth, elige Registrar automáticamente.
Capacidades
Once herramientas enfocadas.
El descubrimiento público sigue siendo fluido. El estado personal se separa detrás de ámbitos OAuth explícitos.
list_areas
Resuelve distritos y vecindarios de Berlín a IDs de área canónicos.
search_listings
Busca apartamentos amueblados, estudios y habitaciones actualmente disponibles.
get_listing
Recupera información segura y detallada de un anuncio.
compare_listings
Compara de dos a diez anuncios con campos consistentes y compensaciones.
render_listings_widget
Muestra de uno a diez anuncios como una galería interactiva de MCP Apps cuando sea compatible.
list_saved_listings
Lista los favoritos del usuario autenticado.
save_listing
Añade un anuncio a favoritos.
remove_saved_listing
Elimina un anuncio de favoritos.
list_alerts
Lista las búsquedas guardadas y sus IDs de alerta.
create_alert
Crea una búsqueda guardada con nombre a partir de los mismos filtros utilizados para el descubrimiento.
delete_alert
Elimina una o más alertas de búsqueda guardada.
Autenticación
Anónimo primero. OAuth solo cuando aporta valor.
FlatHunt utiliza autenticación mixta. Un token ausente es válido para herramientas públicas de vivienda; las acciones protegidas devuelven un desafío de autorización estándar que el host maneja.
- Código de autorización con PKCE S256
- Registro dinámico de clientes para clientes públicos
- Validación exacta del URI de redirección
- Ámbitos mínimos para alertas y favoritos
Límite de responsabilidad OAuth Descubrimiento estándar
- 1 Tu host de MCP Descubre metadatos, abre la autorización y almacena los tokens resultantes.
- 2 Servidor de autorización de FlatHunt Autentica al usuario, otorga ámbitos y emite tokens vinculados a PKCE.
- 3 Gateway MCP de FlatHunt Verifica el token Bearer y delega solo la acción de usuario solicitada.
Metadatos de recursos protegidos Metadatos del servidor de autorización
Compatibilidad
Portable por diseño. Verificado por superficie.
El descubrimiento de herramientas no es lo mismo que una prueba OAuth completa. FlatHunt publica la distinción para que los integradores sepan qué se ha ejercitado realmente.
ChatGPT Verificado en producción Lectura/escritura OAuth verificada
Conector Claude Disponible DCR/PKCE compatible; prueba del host en curso
Codex, Cursor, VS Code MCP remoto estándar Valida el callback exacto del cliente
Otros hosts Streamable HTTP Protocolo compatible Se requiere validación OAuth específica del host
Los clientes sin renderizado de MCP Apps aún reciben los mismos datos de anuncios y un resultado de texto legible por el modelo. La galería de tarjetas interactivas es una mejora, no una dependencia.
Registro Oficial de MCP
Publicado en el Registro Oficial de MCP.
com.flat-hunt/mcp Ver FlatHunt en el Registro Oficial de MCP
Smithery
Disponible en Smithery para descubrimiento y conexión con clientes MCP compatibles.
Glama
Listado en Glama para descubrimiento de MCP e información de conectores.
MCP.so
Listado en MCP.so como servidor MCP remoto.
Poe
Usa el bot FlatHuntAI en Poe para descubrir apartamentos amueblados en Berlín.
Límites de seguridad y producto
Contexto útil dentro. Autoridad mínima fuera.
01
Solo lectura por defecto
La búsqueda, los detalles, la comparación y el renderizado de tarjetas no cambian los datos del usuario.
02
Las escrituras son explícitas
Solo los favoritos y las alertas de búsqueda guardada mutan el estado de la cuenta, con ámbitos dedicados y anotaciones de herramientas.
03
Sin transacción de alquiler
FlatHunt nunca acepta alquileres ni depósitos. El proveedor original controla la disponibilidad, las solicitudes y los términos finales.
Referencia
Preguntas comunes de integración.
¿Necesitas ayuda con una revisión o un callback específico del cliente?
¿Los usuarios necesitan una cuenta de FlatHunt?
No se necesita cuenta para el descubrimiento de áreas, búsqueda, detalles de anuncios, comparaciones o tarjetas de anuncios. Se requiere una cuenta gratuita solo para favoritos y alertas de búsqueda guardada.
¿Qué transporte debería usar una integración?
Usa Streamable HTTP en https://mcp.flat-hunt.com/mcp. FlatHunt no expone un endpoint SSE heredado, stdio, WebSocket ni de llamada a funciones específico del proveedor.
¿Puede un host conectarse sin OAuth?
Sí. Las herramientas públicas de vivienda funcionan de forma anónima. Si el host admite autenticación diferida, debería conectarse primero e iniciar OAuth solo cuando el usuario invoque una herramienta de cuenta protegida.
¿De dónde provienen las imágenes de anuncios y las solicitudes?
Las tarjetas de anuncios usan URLs de imágenes HTTPS permitidas de proveedores de vivienda integrados. Las solicitudes y reservas se completan en el sitio web del proveedor original, donde se debe confirmar la disponibilidad actual y los términos finales.
Listo para conectar
Un solo endpoint es todo lo que necesitas.
https://mcp.flat-hunt.com/mcp