Casafari MCP: dati immobiliari per gli agenti IA
Casafari MCP mette a disposizione server MCP di prodotto (Area Insights, Comparables & Valuation, Claro e Cadastre) più il server gratuito Location Lookup, permettendo ad assistenti e agenti IA come Claude, ChatGPT, Cursor e Gemini CLI di interrogare direttamente i dati immobiliari di CASAFARI in linguaggio naturale.
Casafari MCP è l'architettura che mette a disposizione server MCP di prodotto su platform.casafari.com (Area Insights, Comparables & Valuation, Claro e Cadastre) più il server gratuito Location Lookup, permettendo ad assistenti e agenti IA, tra cui Claude, ChatGPT, Cursor e Gemini CLI, di interrogare direttamente i dati immobiliari di CASAFARI in linguaggio naturale. Con un accesso sicuro in OAuth 2.1 e un piano Free da 1.000 token attivabile senza carta di credito, sviluppatori e professionisti possono consultare prezzi, tendenze e comparabili verificati su un grafo immobiliare di 16 paesi (Stati Uniti: ingresso in corso, Stati selezionati, solo immobili commerciali, con Claro AI) .
A chi serve Casafari MCP
Una catena di caffetterie italiana interessata ad espandersi sul mercato spagnolo doveva valutare la fattibilità dell'apertura di un nuovo punto vendita a Valencia. Utilizzando Claude collegato al connettore Claro AI, l'agente IA ha passato al setaccio 546 locali commerciali disponibili in zona per selezionare una rosa finale di sei candidati ideali con requisiti specifici di metratura e dehors, il tutto nell'arco di un pomeriggio (developers.casafari.com, 16-17 ottobre 2026).
Casafari MCP si rivolge a tre profili principali:
- Sviluppatori di software ed agenti IA: chi sta realizzando un assistente intelligente o un flusso di lavoro automatizzato non deve più scrivere client REST personalizzati per integrare le informazioni immobiliari. Lo standard aperto Model Context Protocol (modelcontextprotocol.io), introdotto da Anthropic nel novembre 2024, consente di esporre dati e strumenti all'IA in modo standardizzato.
- Team dati e analisti di mercato: gli esperti che analizzano l'andamento del settore possono studiare serie storiche, distribuzioni di prezzo e variazioni dello stock immobiliare direttamente all'interno della propria interfaccia di chat abituale, traducendo concetti complessi in grafici e tabelle in pochi istanti.
- Agenti immobiliari, periti e investitori: professionisti della mediazione, valutatori e fondi di investimento possono richiedere valutazioni e comparabili puntuali con fonte verificata per supportare decisioni d'acquisto o stime di stima professionale. Un approfondimento su come Porta da Frente Christie's usa l'IA agentica con i dati CASAFARI illustra l'impatto di questi strumenti nell'operatività quotidiana.
Dal punto di vista della copertura geografica, il grafo immobiliare di CASAFARI pulisce e de-duplica annunci residenziali e commerciali, in vendita e in affitto, in 16 paesi, Italia compresa (si consulti la guida su i paesi coperti dai dati CASAFARI). Ciascun server risponde a esigenze specifiche: se i dati generali sul mercato residenziale sono disponibili per tutti i paesi coperti, Claro AI analizza i locali commerciali in Spagna e Germania e i terreni commerciali in Germania.
Quali server MCP mette a disposizione CASAFARI
L'architettura di Casafari MCP comprende server MCP di prodotto (Area Insights, Comparables & Valuation, Claro e Cadastre) più il server gratuito Location Lookup da cui tutti dipendono. Si utilizza il medesimo conto in token e la stessa autenticazione OAuth 2.1, collegando esclusivamente i connettori utili alle proprie attività.
Location Lookup: da un nome di luogo al location_id
Attraverso l'URL `https://platform.casafari.com/mcp/locations`, il server Location Lookup converte i nomi di comuni, quartieri e zone geografiche nel rispettivo codice identificativo univoco (`location_id`), utilizzato dagli altri server dell'infrastruttura. Le interrogazioni su questo server sono sempre gratuite e consumano 0 token. Tra le domande tipiche formulate da un professionista italiano si annoverano:
- "Qual è il location_id del quartiere Vomero a Napoli?"
- "Trova le zone di Bologna che contengono la parola Bolognina."
Area Insights: tendenze, distribuzioni e heatmap di una zona
Il server Area Insights, raggiungibile all'indirizzo `https://platform.casafari.com/mcp/area-insights`, mette a disposizione 7 strumenti dedicati all'analisi macro e microeconomica (developers.casafari.com, 23 ottobre 2026). Consente di estrarre serie storiche del prezzo al metro quadro, analisi di distribuzione dei valori di offerta, mappa termica dei valori e consistenza dello stock sia in vendita che in locazione. Maggiori informazioni sulle funzionalità sono disponibili nella pagina di Area Insights oppure nella documentazione di Area Insights (in inglese). Esempi di domande adatte ad Area Insights:
- "Come è cambiato il prezzo medio al m² degli appartamenti in vendita a Torino negli ultimi 24 mesi?"
- "Mostrami la distribuzione dei canoni dei bilocali a Milano."
- "Quali quartieri di Roma presentano il maggior volume di stock in affitto?"
Comparables & Valuation: comparabili e prezzo stimato intorno a un punto
Accessibile tramite `https://platform.casafari.com/mcp/comparables`, il server Comparables & Valuation permette di identificare gli immobili comparabili e di calcolare la stima del prezzo intorno a un indirizzo, a coordinate geografiche o a un riferimento catastale spagnolo. Ogni immobile presente nell'archivio corrisponde a un singolo record consolidato nel grafo immobiliare, completo della cronologia dei prezzi e dei cambi di stato nel tempo (developers.casafari.com, 23 ottobre 2026). Per un quadro dettagliato, è possibile visitare la sezione su valutazioni e comparabili CASAFARI o consultare la documentazione di Comparables & Valuation (in inglese). Esempi di domande per questo server:
- "Trova comparabili per un trilocale di 90 m² in via Sarpi a Milano."
- "Qual è il prezzo stimato di una villa con giardino a Como, in zona Lago?"
Claro AI: locali commerciali in Spagna e Germania, terreni commerciali in Germania
Raggiungibile all'indirizzo `https://platform.casafari.com/mcp/claro`, il server Claro AI mette a disposizione 9 strumenti specializzati nella ricerca di immobili commerciali (negozi, locali per la ristorazione, uffici, capannoni) in vendita e in affitto in Spagna e Germania, oltre a terreni commerciali in Germania (developers.casafari.com, 23 ottobre 2026). Le medesime funzionalità sono disponibili anche nell'interfaccia dell'app Claro su expansion.casafari.com. Claro AI analizza le richieste espresse in linguaggio naturale e restituisce un conteggio esatto delle opzioni idonee. Ogni criterio viene classificato come soddisfatto, non soddisfatto o non specificato nell'annuncio, fornendo la citazione testuale della fonte senza effettuare inferenze arbitrarie. Integra inoltre le metriche di Location Intelligence, come l'indice di passaggio pedonale entro 5 minuti a piedi (un indice comparativo di frequenza della zona, non un conteggio fisico di persone), la popolazione residente e la capacità di spesa della zona. Per maggiori dettagli è possibile leggere la documentazione di Claro (in inglese) e visionare i report di esempio scritti da Claude con Claro (in inglese). Esempi di ricerche con Claro AI:
- "Cerca locali di 80-150 m² per una caffetteria nel centro di Valencia, dotati di spazio per dehors."
- "Trova capannoni in affitto a Madrid con canone inferiore a 12 € al m²."
- "Identifica terreni commerciali tra 1.500 e 6.000 m² in Baviera adatti a un centro revisioni auto."
Cadastre: catasto ufficiale spagnolo
Accessibile tramite `https://platform.casafari.com/mcp/cadastre`, il server Cadastre consente di interrogare il catasto ufficiale spagnolo (Catastro) per tutta la Spagna, escluse Navarra e i Paesi Baschi che mantengono i propri catasti autonomi. Il server offre quattro strumenti dedicati: `find` (converte un riferimento catastale, un indirizzo o coordinate in candidati ordinati; in caso di ambiguità restituisce più opzioni senza mai tirare a indovinare), `get_property` (scheda catastale di un'unità a 20 caratteri o di una parcella a 14 caratteri: destinazione d'uso, superficie costruita, superficie del lotto e unità della parcella), `reference_value` (valore dell'immobile tipo di riferimento della zona per l'anno indicato, espresso in euro e in euro al m²; si tratta del valore dell'immobile tipo della zona e NON del valore di riferimento ufficiale dell'immobile) e `area_values` (tutte le zone di un comune con il valore dell'immobile tipo e i valori minimo, mediano e massimo per anno). Ogni dato riporta la provenienza (fonte, data, livello: unità, parcella o zona). Non contiene dati sui proprietari. Ogni chiamata richiede 5 token.
- "Trova i dati catastali per l'indirizzo Calle Gran Vía 10 a Madrid."
- "Qual è la scheda dell'unità catastale con riferimento 9876543VK4797S0001WX?"
- "Mostrami il valore dell'immobile tipo della zona e la distribuzione dei valori per il comune di Siviglia."
Come si collega Casafari MCP a Claude, ChatGPT, Gemini CLI, Claude Code e Cursor
La configurazione di un server Casafari MCP richiede tre passaggi principali:
Aggiunta del connettore
nel proprio client IA (connettore personalizzato per Claude, modalità sviluppatore per ChatGPT, oppure file di configurazione per Cursor, Claude Code o Gemini CLI) si inserisce l'URL specifico del server, ad esempio `https://platform.casafari.com/mcp/area-insights`.
Autenticazione via browser
alla prima richiesta si apre la finestra del browser per completare l'accesso sicuro con protocollo OAuth 2.1. L'account viene creato automaticamente sul piano Free senza dover inserire carte di credito o copiare manualmente chiavi API.
Invio della prima domanda
completata l'autenticazione, l'assistente IA può iniziare a rispondere alle interrogazioni sui dati di mercato.
Il trasporto dati avviene tramite il protocollo Streamable HTTP. Tra gli altri client compatibili figurano VS Code, Codex CLI, Devin Desktop, Zed, Cline, JetBrains Junie, Kiro, Warp e goose.
Per le istruzioni tecniche passo-passo è possibile consultare la guida completa per collegare un client MCP (in inglese) su platform.casafari.com. Per spunti sull'impiego degli assistenti in agenzia, si rimanda all'articolo con consigli per usare ChatGPT in agenzia.
Quanto costa Casafari MCP: i piani in token
I consumi e l'accesso ai server Casafari MCP sono regolati da una struttura di piani basata su token (developers.casafari.com, 23 ottobre 2026):
- Piano Free: include 1.000 token gratuiti per 30 giorni, senza obbligo di inserire carte di credito.
- Piano Agent: costa 49 € al mese con fatturazione mensile oppure 468 € all'anno (39 € al mese) con fatturazione annuale (prezzi IVA esclusa) e mette a disposizione 1.500 token al mese (con un massimo di 600 token ogni 3 ore).
- Piano Custom: destinato a team strutturati e volumi elevate di query, definito su contratto personalizzato (si richiede dalla piattaforma: come funziona il piano Custom, in inglese).
In caso di superamento delle soglie previste dal piano, è possibile acquistare token prepagati di ricarica. Le ricerche su Location Lookup non consumano token. Per i dettagli sui consumi delle singole operazioni si rimanda alla guida su domande frequenti su piani e token (in inglese).
Sicurezza: OAuth 2.1 e strumenti in sola lettura
L'infrastruttura d'autenticazione si fonda sullo standard OAuth 2.1 per tutti i server MCP di prodotto e per il server Location Lookup. L'utente autorizza l'accesso direttamente tramite browser: l'assistente IA riceve un access token temporaneo e l'utente non deve mai incollare chiavi segrete all'interno delle conversazioni.
Gli strumenti dati messi a disposizione dai server MCP operano in sola lettura. Gli assistenti IA possono consultare ed elaborare le informazioni del grafo immobiliare, ma per il resto non dispongono di permessi per modificare, aggiungere o cancellare dati all'interno dell'account utente. Le autorizzazioni concesse possono essere revocate in qualsiasi momento accedendo alla console di gestione su platform.casafari.com.
Già cliente dell'API REST? Non cambia nulla
L'introduzione dei server MCP di prodotto e del server gratuito Location Lookup si affianca alle API REST tradizionali ospitate su api.casafari.com, che rimangono operative e invariate.
La scelta tra le due modalità dipende dal tipo di integrazione da realizzare: le API REST sono orientate allo sviluppo di funzionalità software tradizionali, integrazioni con CRM e pipeline di dati in background; i server MCP sono progettati per l'interazione diretta in linguaggio naturale con agenti e assistenti IA.
I clienti interessati alle integrazioni tradizionali possono fare riferimento alla documentazione per le API di dati immobiliari CASAFARI ed esplorare il codice sorgente dei connettori sul repository pubblico casafari-mcp su GitHub.
Testimonianze
Le API ci permettono di ottenere informazioni in tempo reale, riuscendo a identificare rapidamente le variazioni nel stock di immobili in vendita. Tutte queste informazioni sono fondamentali nel processo di monitoraggio del mercato, sia per scopi di intelligence sia per l’acquisizione di immobili / transazioni.
Avendo accesso a un database di dati utili e strutturati per il nostro motore di IA, siamo riusciti a scalare il nostro portale immobiliare più rapidamente. I principali vantaggi sono la velocità e l’aggiornamento dei dati utilizzati, che ci permette di mantenere gli annunci immobiliari sempre sincronizzati con il mercato e mostrare ai nostri clienti nuovi annunci ogni giorno sulla piattaforma.
Siamo prossimi alla soglia dei 20.000 utenti registrati in meno di sei mesi di attività, e sicuramente poter contare sull’API di CASAFARI per aggiungere annunci al nostro portafoglio è stato uno dei motivi di questo traguardo.
Prezzi di compravendita registrati, da fonte ufficiale
CASAFARI dispone dei prezzi di compravendita registrati in Italia: ciò che gli immobili hanno realmente spuntato, secondo l'Agenzia delle Entrate, e non soltanto il prezzo a cui erano stati proposti. Il tuo agente di IA lavora con gli stessi dati di mercato che alimentano gli strumenti di CASAFARI.
- Comparabili: gli immobili venduti con un prezzo di chiusura reale portano un tag viola e vengono aggiunti in automatico quando la valutazione li individua.
- Valutazione (CMA): la stima moltiplica il prezzo medio al m² dei comparabili che selezioni per la superficie dell'immobile, quindi i comparabili con prezzo registrato contribuiscono al valore.
- Studio di mercato: consulta il prezzo medio di chiusura del tipo di immobile che stai valutando nella zona che scegli, accanto ai prezzi richiesti attuali.
- Cronologia: tutte le compravendite registrate intorno all'immobile e come è cambiato il prezzo medio di chiusura nella zona.
Fonte ufficiale: Agenzia delle Entrate.
Domande frequenti
Che cos'è Casafari MCP e a cosa serve?
Casafari MCP è un insieme di server basati sullo standard Model Context Protocol (MCP) che consentono agli assistenti IA, come Claude, ChatGPT o Cursor, di accedere direttamente ai dati immobiliari di CASAFARI. Mette a disposizione server MCP di prodotto (Area Insights, Comparables & Valuation, Claro e Cadastre) oltre al server gratuito Location Lookup, da interrogare in linguaggio naturale senza scrivere codice. È stato sviluppato per team dati, sviluppatori di agenti e professionisti del settore immobiliare che desiderano integrare dati di mercato verificati nelle proprie conversazioni con l'IA (developers.casafari.com/docs/connect, 23 ottobre 2026).
Casafari MCP funziona per il mercato immobiliare italiano?
Sì, i server Location Lookup, Area Insights e Comparables & Valuation supportano pienamente l'Italia, poiché attingono al grafo immobiliare di CASAFARI che copre 16 paesi (Stati Uniti: ingresso in corso, Stati selezionati, solo immobili commerciali, con Claro AI). È possibile cercare comuni o quartieri italiani e richiedere analisi sulle tendenze dei prezzi e sui dati comparabili. Il server Claro AI, invece, gestisce i locali commerciali in Spagna e Germania e i terreni commerciali in Germania.
Quanto costa Casafari MCP e serve una carta di credito per provarlo?
Il piano Free offre 1.000 token validi per 30 giorni e non richiede alcuna carta di credito per l'attivazione. Per esigenze continuative, il piano Agent costa 49 € al mese con fatturazione mensile oppure 468 € all'anno (39 € al mese) con fatturazione annuale (IVA esclusa), con 1.500 token al mese e un massimo di 600 token ogni 3 ore, mentre per i team con volumi elevati è disponibile il piano Custom a contratto. I consumi oltre la soglia del piano si gestiscono con token prepagati, mentre le interrogazioni sul server Location Lookup consumano sempre 0 token (developers.casafari.com/docs/faq, 23 ottobre 2026).
Come collego Casafari MCP a Claude o a ChatGPT?
Il collegamento richiede tre semplici passaggi: si aggiunge un connettore personalizzato in Claude oppure si attiva la modalità sviluppatore in ChatGPT inserendo l'URL del server desiderato su https://platform.casafari.com/mcp/<prodotto>. Successivamente si effettua l'accesso nel browser tramite OAuth 2.1, che crea automaticamente l'account sul piano Free. Una volta completata l'autenticazione, è possibile formulare subito la prima domanda in chat senza dover copiare o gestire chiavi API. La procedura dettagliata per ciascun client è consultabile nella guida completa per collegare un client MCP (in inglese) su developers.casafari.com/docs/connect.
Che differenza c'è tra Casafari MCP e l'API REST di CASAFARI?
L'API REST e i server MCP offrono accesso allo stesso grafo immobiliare, ma sono pensati per modalità di lavoro differenti. L'API REST su api.casafari.com è la scelta ideale per integrare dati immobiliari all'interno di software gestionali, CRM e pipeline automatizzate di backend. I server MCP, invece, permettono di interrogare i dati in linguaggio naturale direttamente dagli assistenti IA senza scrivere codice di integrazione. I clienti che utilizzano già le API di dati immobiliari CASAFARI possono affiancare i server MCP senza alcuna modifica ai propri sistemi esistenti.
L'assistente IA può modificare i dati del mio account CASAFARI?
Gli strumenti dati messi a disposizione dai server Casafari MCP funzionano in sola lettura. L'assistente IA può interrogare ed elaborare i dati di mercato, ma per il resto non ha alcun permesso per creare, modificare o eliminare informazioni all'interno dell'account. L'autenticazione avviene tramite protocollo OAuth 2.1 nel browser fornendo un access token temporaneo, e le autorizzazioni concesse possono essere revocate in qualsiasi momento dalla console su platform.casafari.com.
Provi Casafari MCP con 1.000 token gratuiti
Si accede a platform.casafari.com, si aggiunge l'URL di un server all'assistente e si pone la prima domanda. Senza carta.