FlatHunt
Pesquise e compare quartos mobiliados e apartamentos em Berlim de vários provedores de moradia. Gratuito para inquilinos; as reservas são feitas pelo provedor original.
Documentação
O contrato
Um servidor. Sem fork de fornecedor.
O FlatHunt é um gateway fino e sem estado entre hosts MCP e a plataforma de moradia FlatHunt.
Todo cliente compatível usa o mesmo endpoint e os mesmos esquemas de ferramentas. Metadados específicos do host são limitados à autenticação e à compatibilidade de UI na borda do protocolo.
Sem acesso direto ao banco de dados As regras de negócio permanecem na API do FlatHunt.
Sem armazenamento de tokens Seu host MCP é o dono da sessão OAuth.
Transferência para o provedor Aplicações e reservas permanecem com o provedor original.
Conecte
Traga o endpoint para o seu cliente.
Comece com a busca anônima. Seu cliente deve pedir que você faça login apenas quando uma ferramenta de favoritos ou alertas precisar de acesso à conta.
- Abra as configurações do Claude e adicione um conector personalizado.
- Cole
https://mcp.flat-hunt.com/mcp. - Em Autenticação, escolha Entrar quando necessário.
- Em Cliente OAuth, escolha Registrar automaticamente.
Capacidades
Onze ferramentas focadas.
A descoberta pública permanece sem atrito. O estado pessoal é separado atrás de escopos OAuth explícitos.
list_areas
Resolva distritos e bairros de Berlim para IDs de área canônicos.
search_listings
Busque apartamentos mobiliados, estúdios e quartos atualmente disponíveis.
get_listing
Recupere informações seguras e detalhadas para um anúncio.
compare_listings
Compare de dois a dez anúncios com campos consistentes e trade-offs.
render_listings_widget
Mostre de um a dez anúncios como uma galeria interativa de MCP Apps quando suportado.
list_saved_listings
Liste os favoritos do usuário conectado.
save_listing
Adicione um anúncio aos favoritos.
remove_saved_listing
Remova um anúncio dos favoritos.
list_alerts
Liste buscas salvas e seus IDs de alerta.
create_alert
Crie uma busca salva nomeada a partir dos mesmos filtros usados para descoberta.
delete_alert
Exclua um ou mais alertas de busca salva.
Autenticação
Anônimo primeiro. OAuth apenas quando agrega valor.
O FlatHunt usa autenticação mista. Um token ausente é válido para ferramentas públicas de moradia; ações protegidas retornam um desafio de autorização padrão que o host gerencia.
- Código de Autorização com PKCE S256
- Registro Dinâmico de Cliente para clientes públicos
- Validação exata do URI de redirecionamento
- Escopos mínimos para alertas e favoritos
Fronteira de responsabilidade OAuth Descoberta padrão
- 1 Seu host MCP Descobre metadados, abre a autorização e armazena os tokens resultantes.
- 2 Servidor de autorização do FlatHunt Autentica o usuário, concede escopos e emite tokens vinculados a PKCE.
- 3 Gateway MCP do FlatHunt Verifica o token Bearer e delega apenas a ação solicitada pelo usuário.
Metadados de recurso protegido Metadados do servidor de autorização
Compatibilidade
Portátil por design. Verificado por superfície.
A descoberta de ferramentas não é o mesmo que um teste OAuth completo. O FlatHunt publica a distinção para que integradores saibam o que foi realmente exercitado.
ChatGPT Verificado em produção Leitura/escrita OAuth verificada
Conector Claude Disponível DCR/PKCE suportado; smoke do host em andamento
Codex, Cursor, VS Code MCP remoto padrão Valide o callback exato do cliente
Outros hosts Streamable HTTP Compatível com protocolo Validação OAuth específica do host necessária
Clientes sem renderização de MCP Apps ainda recebem os mesmos dados de anúncios e um resultado de texto legível por modelo. A galeria interativa de cards é um aprimoramento, não uma dependência.
Registro Oficial MCP
Publicado no Registro Oficial MCP.
com.flat-hunt/mcp Ver FlatHunt no Registro Oficial MCP
Smithery
Disponível no Smithery para descoberta e conexão com clientes MCP compatíveis.
Glama
Listado no Glama para descoberta MCP e informações de conectores.
MCP.so
Listado no MCP.so como um servidor MCP remoto.
Poe
Use o bot FlatHuntAI no Poe para descobrir apartamentos mobiliados em Berlim.
Limites de segurança e produto
Contexto útil dentro. Autoridade mínima fora.
01
Somente leitura por padrão
Busca, detalhes, comparação e renderização de cards não alteram dados do usuário.
02
Gravações são explícitas
Apenas favoritos e alertas de busca salva alteram o estado da conta, com escopos dedicados e anotações de ferramentas.
03
Sem transação de aluguel
O FlatHunt nunca aceita aluguel ou depósitos. O provedor original controla disponibilidade, aplicações e termos finais.
Referência
Perguntas comuns de integração.
Precisa de ajuda com uma revisão ou callback específico do cliente?
Os usuários precisam de uma conta FlatHunt?
Nenhuma conta é necessária para descoberta de áreas, busca, detalhes de anúncios, comparações ou cards de anúncios. Uma conta gratuita é necessária apenas para favoritos e alertas de busca salva.
Qual transporte uma integração deve usar?
Use Streamable HTTP em https://mcp.flat-hunt.com/mcp. O FlatHunt não expõe um endpoint legado de SSE, stdio, WebSocket ou chamada de função específica de fornecedor.
Um host pode conectar sem OAuth?
Sim. Ferramentas públicas de moradia funcionam anonimamente. Se o host suportar autenticação preguiçosa, ele deve conectar primeiro e iniciar OAuth apenas quando o usuário invocar uma ferramenta de conta protegida.
De onde vêm as imagens e aplicações dos anúncios?
Cards de anúncios usam URLs HTTPS de imagens na lista de permissões de provedores de moradia integrados. Aplicações e reservas são concluídas no site do provedor original, onde disponibilidade atual e termos finais devem ser confirmados.
Pronto para conectar
Um endpoint é tudo que você precisa.
https://mcp.flat-hunt.com/mcp