Casafari MCP

Inteligência de dados imobiliários, construída para agentes de IA. A Casafari é a plataforma de inteligência de dados imobiliários nativa para agentes de IA. Grafo de propriedades deduplicado e limpo. O índice imobiliário mais completo da Europa.

Ver em casafari.com

Servidor MCP hospedado

npx add-mcp 'https://mcp.casafari.com/'

Instala no Claude Code, Codex, Cursor e outros

Documentação

Plataforma Casafari API e MCP

Casafari é a plataforma de inteligência de dados imobiliários nativa para agentes de IA. O índice de propriedades mais completo da Europa: um grafo de propriedades deduplicado e limpo de imóveis residenciais e comerciais, para venda e aluguel, em 16 países.

Cada propriedade no grafo é um único registro, mesclado de todas as fontes que a anunciam e limpo, com seu histórico completo: cada mudança de preço, cada mudança de status, quando entrou no mercado e quando foi removida. Imóveis residenciais e comerciais, para venda e aluguel. Como o grafo de propriedades é construído.

Os servidores MCP da Casafari conectam assistentes e agentes de IA a ele como ferramentas do Model Context Protocol: busca de localizações, comparáveis e avaliações, insights de área e análise de agências e agentes. Eles fazem parte da Plataforma Casafari API e MCP, onde cada produto é seu próprio servidor MCP com sua própria URL e login OAuth.

Os mesmos dados também estão disponíveis por meio de uma API REST (46 operações em https://api.casafari.com). A documentação é organizada por produto, e cada produto lista suas ferramentas MCP e suas operações REST; MCP e REST comparados mostra onde os dois se sobrepõem e onde não.

Já é cliente da API Casafari? Seu token continua funcionando, e a referência da API existente agora está neste site. Entre na sua conta de API para ver seu token.

Endpoints

Um servidor MCP por produto na plataforma (Streamable HTTP, login OAuth 2.1 no navegador, sem chave para copiar):

Location Lookup: https://platform.casafari.com/mcp/locations
Area Insights: https://platform.casafari.com/mcp/area-insights
Comparables: https://platform.casafari.com/mcp/comparables
AgentGraph AI: https://platform.casafari.com/mcp/agentgraph (somente empresas verificadas)
Claro AI: https://platform.casafari.com/mcp/claro

No Claude Code, por exemplo: claude mcp add --transport http casafari-comparables https://platform.casafari.com/mcp/comparables. No Claude ou ChatGPT, adicione um conector personalizado com a URL do produto. Passos para Claude, ChatGPT, Claude Code, Cursor, VS Code, Codex CLI, Gemini CLI, Zed e outros clientes: Conectar e Conectar à Plataforma Casafari.

Já é cliente Casafari? Use os mesmos servidores: cadastre-se em https://platform.casafari.com/console/, e, se tiver contrato, a Casafari configura sua conta no plano Custom. mcp.casafari.com foi descontinuado; use https://platform.casafari.com/mcp/<product>.

Cada servidor publica seu próprio cartão em <server URL>/.well-known/mcp/server-card.json, por exemplo https://platform.casafari.com/mcp/comparables/.well-known/mcp/server-card.json. Login: Autenticação.

Claro AI também é um produto da plataforma; com uma chave de API da plataforma em vez de OAuth, veja Conectar Claro.

Produtos

Produto	Ferramentas MCP	Operações REST	O que responde
Property Sourcing	—	10	Encontre propriedades no grafo de propriedades, onde cada propriedade é um único registro, independentemente de quantas agências e portais a anunciam: busque por filtros estruturados ou em linguagem natural, navegue pelos resultados, leia uma propriedade com todos os lugares onde é anunciada e seu histórico de preços, e resolva um link de portal ou agência ou uma referência para a propriedade à qual pertence. Somente REST.
High Potential Seller Leads	—	2	Imóveis com probabilidade de venda: propriedades ao redor de um ponto cujo preço pedido foi reduzido repetidamente, por quantas reduções e quanto no total, durante todo o tempo no mercado ou desde uma data. Cada lead vincula à sua propriedade e ao seu histórico de preços. Somente REST; Espanha, França, Itália, Alemanha, Grécia e Andorra.
Comparables & Valuation	1	4	Propriedades comparáveis e preços estimados para um imóvel: propriedades no mercado, vendas e aluguéis passados e registros oficiais, correspondidos ao redor de um ponto, endereço ou referência cadastral.
Area Insights	7	6	Insights para uma área: preço, oferta e atividade ao longo do tempo, distribuições por preço, quartos e tempo no mercado, e análise de mercado. Via MCP, também medidas de crescimento e volatilidade e mapas de calor por distrito.
New Market Leads	—	12	Feeds de alertas que acompanham o grafo de propriedades para um conjunto de filtros: novas propriedades, aumentos e reduções de preço, reservas, remoções e vendas. Crie um feed, leia seus alertas ou receba-os em seu webhook.
References	—	10	Os dados de referência a partir dos quais as solicitações são construídas: tipos de propriedade, características e condições, agências, agentes e as fontes das quais o grafo é construído, localizações com typeahead e limites de CEP.
AgentGraph AI	13	—	Encontre as agências e agentes imobiliários que valem a pena ter como parceiros: triagens de área contra perfis de parceiros, perfis completos, mapas de território, briefings de parceiros e listas de acompanhamento.

Claro AI

Claro AI é o agente de busca de expansão de negócios da Casafari para imóveis comerciais em toda a Espanha. É um produto da plataforma: seu próprio servidor MCP e API REST na plataforma, com uma chave da plataforma ou o OAuth da plataforma. Conectar Claro.

Como as ferramentas são nomeadas

Cada servidor nomeia suas ferramentas <server>_<tool>: o prefixo é o último segmento da URL do servidor, o restante é o nome da própria ferramenta, por exemplo comparables_get-comparables, area-insights_get_heatmap ou agentgraph_screen_agencies. As ferramentas do Location Lookup são locations_search e locations_get, e todo servidor também tem account_status. Sempre chame uma ferramenta pelo nome completo, conforme listado pelo servidor.

Uma API para agentes de IA

A Casafari é uma API para agentes de IA em duas formas, no mesmo grafo de propriedades:

Os servidores MCP (um por produto em https://platform.casafari.com/mcp/), para agentes que descobrem as ferramentas e decidem quais chamar: no Claude, ChatGPT e outros clientes MCP, ou do seu próprio código por meio da API OpenAI ou da API Claude.
A API REST (referência), para agentes e aplicativos cujo código faz solicitações fixas.

Estes documentos também são escritos para agentes: cada página é Markdown, e /llms.txt os indexa todos.

Unidades, pagamento e verificação

Cada chamada custa um número fixo de unidades na sua conta da plataforma, o mesmo via MCP e REST. account_status, em todos os servidores, mostra seu plano e saldo. Quando as unidades acabam, uma ferramenta responde com um erro de pagamento que contém um link que uma pessoa abre para pagar; as ferramentas do AgentGraph AI respondem verification_required até que a empresa seja verificada. Limites por plano: Limites.

Comece com uma localização

A maioria das ferramentas de dados aceita uma localização como IDs, um círculo ou um polígono, em vez de um nome: resolva um nome de lugar para IDs com o locations_search do Location Lookup primeiro (https://platform.casafari.com/mcp/locations, gratuito). O AgentGraph AI tem seu próprio agentgraph_find_location para a Alemanha.

Leia estes documentos como Markdown

Cada página tem uma versão Markdown: adicione .md à sua URL ou envie Accept: text/markdown. /llms.txt lista todas as páginas e ferramentas; /llms-full.txt é a referência completa em um único arquivo. Mais em Para agentes de IA.

Perguntas e respostas

Qual é a diferença entre o Casafari MCP e a API REST da Casafari, e qual devo usar?

Use MCP quando um assistente ou agente de IA chama os dados da Casafari como ferramentas; use REST quando seu próprio código os chama via HTTP. Os produtos diferem entre os dois.

Se você é cliente Casafari: a API REST da Casafari (https://api.casafari.com) permanece como está, com 39 operações; POST /login com e-mail e senha retorna um token de acesso e um token de atualização. Property Sourcing, New Market Leads (alertas) e References são somente REST lá. Para MCP, use os servidores da plataforma self-serve como todos os outros: cadastre-se e, se tiver contrato, a Casafari configura sua conta no Custom. Veja MCP e REST comparados e API REST.

Se você é novo na Casafari: na plataforma self-serve, o MCP atende assistentes, que fazem login com OAuth 2.1 e não precisam de chave (Autenticação), para Location Lookup, Area Insights, Comparables & Valuation, AgentGraph AI e Claro AI. O REST atende seu código, com uma chave de API ou um cliente OAuth, para Account, Location Lookup, Area Insights, Property Sourcing, High Potential Seller Leads, Alerts, Comparables & Valuation e Claro AI. Cada operação custa o mesmo número de unidades via REST e MCP.

Veja qual endereço usar e somente MCP e somente REST.

Permalink: /docs/faq/mcp-vs-rest-api

Como funciona a autenticação no Casafari MCP? Ela usa escopos OAuth?

O Casafari MCP faz login com OAuth 2.1 nos servidores MCP da plataforma self-serve, sem chave de API; as APIs REST fazem login com credenciais separadas.

Se você é cliente Casafari: a API REST da Casafari aceita um JWT de e-mail e senha, ou um token para um cliente de API (autenticação REST), como antes. Para MCP, você faz login nos servidores da plataforma self-serve como todos os outros, com uma conta da plataforma.

Se você é novo na Casafari: assistentes fazem login nos servidores MCP da plataforma self-serve com OAuth 2.1 e registro dinâmico de cliente; nenhuma chave é necessária. Quais escopos OAuth esse login usa não são publicados. A API REST da plataforma aceita uma chave de API (cf_sk_…) no cabeçalho X-API-Key ou como Authorization: Bearer <api_key>, ou um cliente OAuth usando credenciais de cliente com o parâmetro resource, cujos tokens duram 15 minutos (chave ou cliente OAuth?).

Veja Autenticação e API REST.

Permalink: /docs/faq/how-authentication-works

Quem pode usar o Casafari MCP e a API Casafari?

Qualquer pessoa pode se cadastrar em platform.casafari.com sem falar com vendas, e é lá que todo assistente se conecta via MCP; clientes Casafari existentes também mantêm seu contrato com a API REST da Casafari.

Se você é cliente Casafari: seu acesso à API REST da Casafari permanece vinculado à sua conta e contrato Casafari, e um token carrega exatamente os direitos dessa conta; uma integração não supervisionada usa um cliente de API que o proprietário da conta cria (autenticação REST). Para MCP, cadastre-se na plataforma self-serve como todos os outros; se tiver contrato, a Casafari configura sua conta no Custom (Conecte seu assistente).

Se você é novo na Casafari: qualquer pessoa pode criar uma conta em https://platform.casafari.com,, começar no plano Free, um teste que não exige cartão, e pagar por uso. Nenhuma verificação de empresa é necessária, exceto para o AgentGraph AI, que detém dados de contato pessoais de agentes imobiliários (verificação). Uma conta Free tem 1 membro e uma conta Agent tem 3 (planos). Passos: como se cadastrar.

Não sabe qual caminho é o seu? Veja qual endereço usar.

Permalink: /docs/faq/who-can-use

Quais são os limites de taxa, cotas e limites de uso da Casafari?

A Casafari não publica números de limite de taxa ou cota para contratos existentes da API REST; a plataforma self-serve mede o uso em unidades, com limites definidos por plano: Free, Agent e Custom, publicados em Limites e janelas de uso.

Se você é cliente Casafari: para números de cota e limite de taxa na API REST da Casafari, entre em contato com a Casafari: https://www.casafari.com/ (cota versus unidades). Via MCP, você usa a plataforma self-serve, onde os limites abaixo se aplicam à sua conta; se tiver contrato, a Casafari a configura no plano Custom, com limites por contrato.

Se você é novo na Casafari: o uso é medido em unidades, o mesmo via REST e MCP; buscas de localização custam 0.

Grátis: 1.000 unidades por 30 dias (teste gratuito); 2 requisições simultâneas, 10 por minuto, 10 locais por dia.
Agente: 1.000 unidades por janela contínua de 3 horas e 4.000 por janela contínua de 7 dias (janelas de uso); 3 requisições simultâneas, 20 por minuto, 50 locais por dia, e um limite rígido de 50.000 unidades por dia, uma proteção contra extração em massa de dados (limites). Uso extra vem apenas de créditos pré-pagos, limitado por padrão a 25.000 unidades (€1.000, excluindo IVA) por período de assinatura.
Contas com créditos (sem plano ou com assinatura cancelada): proteções de requisição do Agente e no máximo 25.000 unidades por dia.
Personalizado: limites conforme contrato; "Fale conosco".

Pela REST, uma janela do Agente esgotada sem créditos responde 429 usage_limit_reached com seu horário de recarga, e ficar sem unidades responde 402 payment_required; o MCP responde um erro de pagamento (sem unidades). Uma proteção de requisição esgotada responde 429 request_limit_reached com Retry-After. Todos os limites estão em Limites e janelas de uso.

Link permanente: /docs/faq/rate-limits-and-quotas

Posso ler estes documentos como Markdown, e existe um llms.txt?

Sim: adicione .md à URL de qualquer página ou envie Accept: text/markdown, e /llms.txt indexa cada página e ferramenta. Nada disso requer chave.

/llms.txt é o índice, e /llms-full.txt contém toda a referência em um único arquivo.
/tools.json fornece o nome, título, esquema de entrada e esquema de saída de cada ferramenta.
Você também encontrará o catálogo de API, o cartão do servidor MCP, a habilidade de agente, o manifesto de recursos agênticos e o sitemap em /sitemap.xml.
Respostas em Markdown são servidas como text/markdown, com um cabeçalho x-markdown-tokens que estima seu tamanho.
Em um navegador que suporte navigator.modelContext, as páginas registram estas ferramentas WebMCP: search_casafari_mcp_docs, get_casafari_tool_reference, get_casafari_rest_operation, get_casafari_connection_config e open_casafari_docs_page.
A plataforma de autoatendimento publica seu próprio https://platform.casafari.com/llms.txt e https://platform.casafari.com/llms-full.txt, além de um OpenAPI para cada produto.

Veja: Para agentes de IA.

Link permanente: /docs/faq/machine-readable-docs

Todas as perguntas