# Casafari API and MCP Platform > Casafari is the AI agent-native real estate data intelligence platform. The most complete property index in Europe: a deduplicated, cleaned property graph of residential and commercial property, for sale and for rent, in 16 countries. Every property is one record with every price change, status change and delisting. To connect an AI assistant, new users use the self-serve Casafari API and MCP Platform: one MCP server per product (Streamable HTTP, OAuth 2.1 sign-in in the browser, no key to copy; you can create an account at the first sign-in, Free plan, no card). Comparables: https://platform.casafari.com/mcp/comparables; the others: https://platform.casafari.com/mcp/locations, https://platform.casafari.com/mcp/area-insights, https://platform.casafari.com/mcp/agentgraph (verified businesses only), https://platform.casafari.com/mcp/claro. In Claude Code: `claude mcp add --transport http casafari-comparables https://platform.casafari.com/mcp/comparables`. In Claude or ChatGPT: add a custom connector with the product's URL. https://mcp.casafari.com/ is only for existing Casafari clients, who sign in with their Casafari account. Their gateway has 22 MCP tools in 3 products, and their REST API 46 operations at https://api.casafari.com (bearer token from POST /login). Every page below is Markdown. ## Self-serve platform (new users) The Casafari API and MCP Platform at https://platform.casafari.com is self-serve: sign up at https://platform.casafari.com/console/ with no card, then connect an AI assistant over MCP (OAuth 2.1 in the browser, dynamic client registration, no key) or call REST at `https://platform.casafari.com/v1/` with an API key (`cf_sk_...`, sent as `Authorization: Bearer`) or an OAuth client from the console. Live products: Location Lookup, Area Insights, Comparables, AgentGraph AI and Claro AI over MCP; Location Lookup, Area Insights, Comparables, Alerts and Account over REST. Existing Casafari clients keep `mcp.casafari.com` and `api.casafari.com`; there is no linking or migration. - REST OpenAPI: https://platform.casafari.com/v1/openapi.json (one per product at https://platform.casafari.com/v1//openapi.json) - Plans: Free (1,000 units for 30 days, no card); Agent (EUR 70 a month or EUR 588 a year, excluding VAT); Custom (contact Casafari). Extra usage is prepaid credits. - [Connect to the Casafari Platform](https://developers.casafari.com/docs/connect-platform.md): MCP servers, OAuth, API keys and a first call - [Limits and usage windows](https://developers.casafari.com/docs/limits.md): rate limits, usage windows and what happens at a limit, per plan - [Use cases](https://developers.casafari.com/docs/use-cases.md): what to build, step by step, and which steps are self-serve - [FAQ](https://developers.casafari.com/docs/faq.md): plans, units, credits, keys, OAuth and existing clients - [Platform Terms of Use](https://developers.casafari.com/legal/platform-terms.md): version 1.4, governed by the laws of England and Wales - [Platform Privacy Notice](https://developers.casafari.com/legal/platform-privacy.md): version 1.5 On the gateway (existing clients), MCP tools are named `_`. Call `list_servers` before using a product for the first time, and resolve place names to location ids with `ma_get_location_typeahead`. The tools an account sees depend on its subscription. Not everything exists over both interfaces: the comparison page lists what is MCP only and what is REST only. ## Docs - [Introduction](https://developers.casafari.com/docs.md): endpoint, products, naming, access - [The property graph](https://developers.casafari.com/docs/property-graph.md): how Casafari builds one record per property from agency websites and portals, its history, asset classes and countries, and where it shows in the API - [Use cases](https://developers.casafari.com/docs/use-cases.md): what you can do with Casafari data, one page per outcome with the tools and REST operations to call: Value and compare; Understand an area; Find leads; Screen investments; Property data in your product; Agency partnerships in Germany - [Connect](https://developers.casafari.com/docs/connect.md): the platform's per-product MCP servers for new users, in Claude, ChatGPT, Claude Code, Cursor, VS Code and any MCP client; mcp.casafari.com for existing Casafari clients - [Connect Claro](https://developers.casafari.com/docs/claro/connect.md): Claro AI's MCP server on the platform, with a platform key or OAuth, in Claude Code, claude.ai, ChatGPT, Cursor, VS Code and any client - [Connect to the Casafari Platform](https://developers.casafari.com/docs/connect-platform.md): for new users, the per-product MCP servers with OAuth, API keys for REST, first calls and usage - [Moving from the existing Casafari API](https://developers.casafari.com/docs/moving-from-existing-api.md): existing clients keep their access; the Platform is for new users, with no linking or migration - [Authentication](https://developers.casafari.com/docs/authentication.md): OAuth 2.1 discovery, registration, PKCE, refresh, client credentials - [What is MCP (Model Context Protocol)?](https://developers.casafari.com/docs/what-is-mcp.md): MCP servers, clients and agents, how a call works, MCP vs API - [MCP security](https://developers.casafari.com/docs/security.md): OAuth 2.1 with PKCE, audience-bound tokens, rights on every call, read-only tools, prompt injection - [MCP server examples](https://developers.casafari.com/docs/examples.md): real estate questions and the tools that answer them - [Use Casafari from the OpenAI API and the Claude API](https://developers.casafari.com/docs/openai-and-claude-api.md): AI API integration with an access token and working code - [REST API](https://developers.casafari.com/docs/rest.md): base URL, bearer-token sign-in, every operation by product - [MCP and REST compared](https://developers.casafari.com/docs/parity.md): per product, what exists over MCP, over REST or both, and the gaps - [Limits and usage windows](https://developers.casafari.com/docs/limits.md): rate limits, usage windows, page limits and sign-up limits per plan, and what happens at a limit - [Existing API customers](https://developers.casafari.com/docs/existing-api-customers.md): the existing Casafari API (static token, v1 and v2), its reference, and where to see your token - [For AI agents](https://developers.casafari.com/docs/agents.md): machine-readable entry points - [All tools](https://developers.casafari.com/docs/tools.md): every MCP tool with its title - [FAQ](https://developers.casafari.com/docs/faq.md): every question about the Casafari API and MCP Platform in one page, each with a permalink ## Products - [Property Sourcing](https://developers.casafari.com/docs/property-sourcing.md): Find properties in the property graph, where every property is one record however many agencies and portals advertise it: search by structured filters or in plain language, page through the results, read one property with everywhere it is advertised and its price history, and resolve a portal or agency link or a reference to the property it belongs to. REST only. (10 REST operations) - [High Potential Seller Leads](https://developers.casafari.com/docs/seller-leads.md): Homes likely to sell: properties around a point whose asking price was cut repeatedly, by how many cuts and how much in total, over their whole time on the market or since a date. Each lead links to its property and its price history. REST only; Spain, France, Italy, Germany, Greece and Andorra. (2 REST operations) - [Comparables & Valuation](https://developers.casafari.com/docs/comparables-valuation.md): Comparable properties and estimated prices for a home: properties on the market, past sales and rentals, and official registry records, matched around a point, an address or a cadastral reference. (1 MCP tool · 4 REST operations) - [Area Insights](https://developers.casafari.com/docs/area-insights.md): Insights for an area: price, supply and activity over time, distributions by price, bedrooms and time on market, and market analysis. Over MCP also growth and volatility measures and heatmaps by district. (8 MCP tools · 6 REST operations) - [New Market Leads](https://developers.casafari.com/docs/alerts.md): Alert feeds that follow the property graph for a set of filters: new properties, price rises and cuts, reservations, delistings and sales. Create a feed, read its alerts, or have them delivered to your webhook. (12 REST operations) - [References](https://developers.casafari.com/docs/references.md): The reference data requests are built from: property types, features and conditions, agencies, agents and the sources the graph is built from, locations with typeahead, and zip-code boundaries. (10 REST operations) - [AgentGraph AI](https://developers.casafari.com/docs/agentgraph.md): Find the real estate agencies and agents worth partnering with: area screens against partner profiles, full profiles, territory maps, partner briefs and watchlists. (13 MCP tools) - [Claro AI](https://developers.casafari.com/docs/claro.md): Casafari's business expansion search agent: commercial premises across Spain from a brief in plain words, and separately Germany, commercial plots; a platform product with its own MCP server and REST API on the platform, with a platform API key or OAuth, metered in platform units. (9 MCP tools · 11 REST operations) - [Gateway](https://developers.casafari.com/docs/gateway.md): The gateway's own tool: lists the tool groups your account can use, with each group's usage instructions. ## Get access - [Sign up on the self-serve platform](https://platform.casafari.com/console/): new users, Free plan with no card, then the per-product MCP servers or REST - [Property Data API](https://www.casafari.com/products/property-data-api/): product overview and access request form for the REST API - [Property Data MCP for AI agents](https://www.casafari.com/products/property-data-mcp-ai-agents/): product overview and access request form for the MCP server - [Casafari website](https://www.casafari.com/): company, products and platform overview ## Optional ### Full reference, one file per product - [Property Sourcing: full reference](https://developers.casafari.com/docs/property-sourcing/llms-full.txt): the product page, its MCP tools and its REST operations in one plain-text file - [High Potential Seller Leads: full reference](https://developers.casafari.com/docs/seller-leads/llms-full.txt): the product page, its MCP tools and its REST operations in one plain-text file - [Comparables & Valuation: full reference](https://developers.casafari.com/docs/comparables-valuation/llms-full.txt): the product page, its MCP tools and its REST operations in one plain-text file - [Area Insights: full reference](https://developers.casafari.com/docs/area-insights/llms-full.txt): the product page, its MCP tools and its REST operations in one plain-text file - [New Market Leads: full reference](https://developers.casafari.com/docs/alerts/llms-full.txt): the product page, its MCP tools and its REST operations in one plain-text file - [References: full reference](https://developers.casafari.com/docs/references/llms-full.txt): the product page, its MCP tools and its REST operations in one plain-text file - [AgentGraph AI: full reference](https://developers.casafari.com/docs/agentgraph/llms-full.txt): the product page, its MCP tools and its REST operations in one plain-text file - [Claro AI: full reference](https://developers.casafari.com/docs/claro/llms-full.txt): the product page, its MCP tools and its REST operations in one plain-text file - [Gateway: full reference](https://developers.casafari.com/docs/gateway/llms-full.txt): the product page, its MCP tools and its REST operations in one plain-text file - [Full reference index](https://developers.casafari.com/llms-full.txt): this list plus the guides ### MCP tools - [list_servers](https://developers.casafari.com/docs/gateway/list_servers.md): List Servers. List the tool groups available to you. - [comps_get-comparables](https://developers.casafari.com/docs/comparables-valuation/get-comparables.md): Get Comparables. Retrieves comparable real estate properties and AI-powered market valuations using the Casafari Comparables Engine. - [ma_get_current_datetime](https://developers.casafari.com/docs/area-insights/get_current_datetime.md): Get Current Datetime. Returns the current system date and time. - [ma_get_time_series_data](https://developers.casafari.com/docs/area-insights/get_time_series_data.md): Get Time Series Data. Retrieve time series data for the real estate market. - [ma_get_time_series_operations](https://developers.casafari.com/docs/area-insights/get_time_series_operations.md): Get Time Series Operations. Performs analytical time-series operations (e.g., mean, delta_pct, CAGR, cv, std, etc.) for a single geographic or analytical segment using real-estate historical data. - [ma_get_price_distribution](https://developers.casafari.com/docs/area-insights/get_price_distribution.md): Get Price Distribution. Returns a distribution of property prices based on the provided filters. - [ma_get_bedrooms_distribution](https://developers.casafari.com/docs/area-insights/get_bedrooms_distribution.md): Get Bedrooms Distribution. Returns a distribution of properties grouped by the number of bedrooms. - [ma_get_time_on_market_distribution](https://developers.casafari.com/docs/area-insights/get_time_on_market_distribution.md): Get Time on Market Distribution. Returns a distribution of properties by their time on the market, grouped by price intervals. - [ma_get_heatmap](https://developers.casafari.com/docs/area-insights/get_heatmap.md): Get Heatmap. Generate an area insights heatmap showing property distribution and price dynamics across geographic areas. - [ma_get_location_typeahead](https://developers.casafari.com/docs/area-insights/get_location_typeahead.md): Get Location Typeahead. Retrieve typeahead suggestions for a given location name. - [agentgraph_find_location](https://developers.casafari.com/docs/agentgraph/find_location.md): Find a German location. Finds German cities, districts and states by name and returns their location ids, kinds and parent areas. - [agentgraph_list_profiles](https://developers.casafari.com/docs/agentgraph/list_profiles.md): Partner profiles. Lists the partner profiles the screens match against, with each one's exact rules, priority and what the listing data cannot show. - [agentgraph_screen_agencies](https://developers.casafari.com/docs/agentgraph/screen_agencies.md): Screen agencies in an area. Ranks the real estate agencies active in a German area against partner profiles: franchise offices losing momentum and growing independent agencies (solo brokers and small teams… - [agentgraph_screen_agents](https://developers.casafari.com/docs/agentgraph/screen_agents.md): Screen agents in an area. Ranks the individual agents named on listings in a German area against partner profiles: top agents in a small area, top performers with a capped territory, agents in traditional… - [agentgraph_agency_profile](https://developers.casafari.com/docs/agentgraph/agency_profile.md): Agency in full. One agency's figures, quarter by quarter, its team (named agents on its listings), its places, contacts, and every partner profile it matches, benchmarked against its main city… - [agentgraph_agent_profile](https://developers.casafari.com/docs/agentgraph/agent_profile.md): Agent in full. One agent's own figures, quarter by quarter, their agency, career across agencies (where Casafari's directory has it), contacts, and every partner profile they match, benchmarked… - [agentgraph_partner_brief](https://developers.casafari.com/docs/agentgraph/partner_brief.md): Partner brief. A one-page brief on one agency or agent for the person who will approach them: key figures against the area, the partner signals they meet, listing quality (photos, descriptions,… - [agentgraph_territory_map](https://developers.casafari.com/docs/agentgraph/territory_map.md): Territory map. One row per district or municipality of a German region (state, district or city): active homes, exits in 12 months, number of brokers, exits and active homes per broker, the… - [agentgraph_save_to_watchlist](https://developers.casafari.com/docs/agentgraph/save_to_watchlist.md): Save to watchlist. Saves agencies or agents (ids from a screen) to your organisation's shared watchlist, each measured in the area you give. - [agentgraph_remove_from_watchlist](https://developers.casafari.com/docs/agentgraph/remove_from_watchlist.md): Remove from watchlist. Removes entries from your organisation's watchlist by id. - [agentgraph_watchlist](https://developers.casafari.com/docs/agentgraph/watchlist.md): Watchlist. Your organisation's watched agencies and agents, with their area, latest priority, active homes and momentum against the area. - [agentgraph_watchlist_changes](https://developers.casafari.com/docs/agentgraph/watchlist_changes.md): What changed. Changes on your watchlist since a date (default: the last 7 days), most important first within each day: priority and profile changes, momentum turning, price cuts, slower exits,… - [agentgraph_area_benchmark](https://developers.casafari.com/docs/agentgraph/area_benchmark.md): Area benchmark. What normal looks like for brokers in a German area: percentiles of active homes, exits, days on market, price cuts and momentum, how the market splits between independents,… ### Claro AI MCP tools (platform route https://platform.casafari.com/mcp/claro) - [search_premises](https://developers.casafari.com/docs/claro/search_premises.md): Search commercial premises. Find shops, restaurant premises, offices, warehouses and other commercial premises for rent or sale anywhere in Spain. - [refine_search](https://developers.casafari.com/docs/claro/refine_search.md): Refine a search. Change part of an earlier search in plain words ("bigger, at least 200 m²", "Barcelona too", "drop the corner") and run it again, as a new search with its own search_id and pages. - [get_premises](https://developers.casafari.com/docs/claro/get_premises.md): Get one premises. One premises in full by the id a search returned: its data, facts read from its text with the sentence each came from (fact_sources), its coordinates (exact, or approximate:… - [compare_premises](https://developers.casafari.com/docs/claro/compare_premises.md): Compare premises. 2 to 10 premises side by side, by the ids a search returned. - [market_snapshot](https://developers.casafari.com/docs/claro/market_snapshot.md): What premises ask in a place. What commercial premises of a kind ask in a place anywhere in Spain, from every active property of that kind and place (each unit counted once): the asking price per m² as a… - [explain_location](https://developers.casafari.com/docs/claro/explain_location.md): Location figures. Footfall index (an index of pedestrian activity within a 5-minute walk that compares places with each other; not a head count, never people or visitors a day; split into weekday… - [brief_from_file](https://developers.casafari.com/docs/claro/brief_from_file.md): Read a brief from a file. The premises requirements a file states (a site brief, a location profile, a requirements sheet): a PDF, a photo or scan (JPG, PNG, WebP, HEIC), a Word, Excel or PowerPoint file… - [search_plots](https://developers.casafari.com/docs/claro/search_plots.md): Search commercial plots (Germany). Find plots of land for sale or rent in Germany for a commercial building, from Casafari's property graph. Scope: Germany, commercial plots. - [get_plot](https://developers.casafari.com/docs/claro/get_plot.md): Get one plot (Germany). One plot in full by the id search_plots returned: its data, commercial-use level, the facts read from its text with the quote each came from (fact_sources), an excerpt, the… Scope: Germany, commercial plots. ### REST API operations - [POST /login](https://developers.casafari.com/docs/rest/authentication/login.md): Login. - [GET /refresh-token](https://developers.casafari.com/docs/rest/authentication/refresh-token.md): Refresh Token. - [POST /v1/property-sourcing/searches](https://developers.casafari.com/docs/rest/property-sourcing/search-properties.md): Search properties. Structured search of the property graph: one request body for every country. - [POST /v1/property-sourcing/searches/describe](https://developers.casafari.com/docs/rest/property-sourcing/search-properties-by-description.md): Search properties by description. Plain-language search: say what you look for as tags (up to 20 phrases) or one description (split into phrases at commas, semicolons and "and"), in the places… - [GET /v1/property-sourcing/searches/{cursor}](https://developers.casafari.com/docs/rest/property-sourcing/next-page-of-a-search.md): Next page of a search. The next page of a search: follow the next URL a search returned. - [GET /v1/property-sourcing/properties/{property_id}](https://developers.casafari.com/docs/rest/property-sourcing/get-a-property.md): Get a property. One property by its prop_ id: the search result's fields plus bathrooms, areas, construction year, energy rating, condition, features, address, description… - [POST /v1/property-sourcing/properties/resolve](https://developers.casafari.com/docs/rest/property-sourcing/resolve-a-link-or-reference-to-its-property.md): Resolve a link or reference to its property. Send exactly one of url (a portal or agency link to one home), reference (the reference an agency gives the home) or listing_id, and get back the property it… - [POST /api/v1/properties/match-by-listings](https://developers.casafari.com/docs/rest/property-sourcing/get-property-by-listing-ids-v1.md): Get property by listing IDs (v1). Returns a mapping properties IDs to listing IDs. - [POST /api/v1/properties/search](https://developers.casafari.com/docs/rest/property-sourcing/search-properties-v1.md): Search properties (v1). - [GET /api/v1/properties/search/{property_id}](https://developers.casafari.com/docs/rest/property-sourcing/get-property-by-id-v1.md): Get property by ID (v1). Returns a property object. - [POST /api/v1/properties/smart-links](https://developers.casafari.com/docs/rest/property-sourcing/create-a-smart-link-beta-v1.md): Create a smart link (BETA) (v1). Generates a smart link that provides detailed property information with customizable components, branding, and user/company information overrides. - [POST /api/v2/properties/search](https://developers.casafari.com/docs/rest/property-sourcing/search-properties-v2.md): Search properties (v2). - [GET /v1/seller-leads](https://developers.casafari.com/docs/rest/seller-leads/list-seller-leads.md): List seller leads. Homes around a point whose asking price was cut repeatedly: at least min_price_cuts cuts (default 1) adding up to at least min_price_cut_pct percent (default… - [GET /v1/seller-leads/{lead_id}](https://developers.casafari.com/docs/rest/seller-leads/get-a-seller-lead.md): Get a seller lead. One lead by its lead_ id: the home, with the same fields as GET /v1/property-sourcing/properties/{property_id}, and its dated price and status history. - [POST /api/v1/comparables/search](https://developers.casafari.com/docs/rest/comparables-valuation/search-comparables-v1.md): Search comparables (v1). Returns comparable properties by the given parameters. - [POST /api/v2/comparables/ai-builder](https://developers.casafari.com/docs/rest/comparables-valuation/initialize-an-ai-builder-session-v2.md): Initialize an AI Builder session (v2). Initializes an AI Builder session from a saved CMA (valuation) and returns the generated report ID along with the URL of the AI Builder session. - [POST /api/v2/comparables/search](https://developers.casafari.com/docs/rest/comparables-valuation/search-comparables-v2.md): Search comparables (v2). Returns comparable properties by the given parameters. - [POST /api/v1/valuation/comparables-prices](https://developers.casafari.com/docs/rest/comparables-valuation/search-estimated-prices-v1.md): Search estimated prices (v1). Returns estimated prices by the given parameters. - [POST /market-analytics-api/time-series](https://developers.casafari.com/docs/rest/area-insights/time-series.md): Time Series. Returns time series data for the real estate market. - [POST /market-analytics-api/distributions/bedrooms](https://developers.casafari.com/docs/rest/area-insights/bedrooms-distribution.md): Bedrooms Distribution. Returns property distribution based on the number of bedrooms. - [POST /market-analytics-api/distributions/prices](https://developers.casafari.com/docs/rest/area-insights/price-distribution.md): Price Distribution. Returns the number of properties distributed across price ranges. - [POST /market-analytics-api/distributions/properties](https://developers.casafari.com/docs/rest/area-insights/properties-distribution.md): Properties Distribution. Returns the properties lightweight data sample and distribution quartiles. - [POST /market-analytics-api/distributions/time-on-market](https://developers.casafari.com/docs/rest/area-insights/time-on-market-distribution.md): Time On Market Distribution. Returns time on market (days and months) distribution by price ranges. - [POST /market-analytics-api/analysis](https://developers.casafari.com/docs/rest/area-insights/analysis.md): Analysis. Market analysis based on the requested property parameters. - [GET /api/v1/listing-alerts/feeds](https://developers.casafari.com/docs/rest/alerts/get-feeds-list-v1.md): Get feeds list (v1). Returns all alerts feeds for currently authenticated user. - [POST /api/v1/listing-alerts/feeds](https://developers.casafari.com/docs/rest/alerts/create-feed-v1.md): Create feed (v1). Create alerts feed for currently authenticated user. - [GET /api/v1/listing-alerts/feeds/{id}](https://developers.casafari.com/docs/rest/alerts/get-alerts-by-feed-v1.md): Get alerts by feed (v1). Returns paginated list of alerts (by feed ID) for currently authenticated user. - [DELETE /api/v1/listing-alerts/feeds/{id}](https://developers.casafari.com/docs/rest/alerts/delete-feed-v1.md): Delete feed (v1). Delete alerts feed (by feed ID) for currently authenticated user. - [PUT /api/v1/listing-alerts/feeds/{id}/update](https://developers.casafari.com/docs/rest/alerts/update-feed-v1.md): Update feed (v1). Update alerts feed by id. - [POST /api/v1/listing-alerts/search](https://developers.casafari.com/docs/rest/alerts/search-alerts-v1.md): Search alerts (v1). Returns paginated list of alerts (by requested parameters) for currently authenticated user. - [GET /alerts-api/feeds](https://developers.casafari.com/docs/rest/alerts/list-feeds.md): List feeds. Returns a paginated list of feeds, sorted newest first. - [POST /alerts-api/feeds](https://developers.casafari.com/docs/rest/alerts/create-feed.md): Create feed. Create a new alert feed that delivers matching real estate events to your webhook URL. - [GET /alerts-api/feeds/{feed_id}](https://developers.casafari.com/docs/rest/alerts/get-feed.md): Get feed. Returns the feed configuration in the same format as it was originally created. - [DELETE /alerts-api/feeds/{feed_id}](https://developers.casafari.com/docs/rest/alerts/delete-feed.md): Delete feed. Permanently removes the feed. - [PUT /alerts-api/webhooks](https://developers.casafari.com/docs/rest/alerts/set-webhook-url.md): Set webhook URL. Sets (or replaces) the delivery URL for all your alert feeds. - [POST /alerts-api/webhooks/rotate-secret](https://developers.casafari.com/docs/rest/alerts/rotate-signing-secret.md): Rotate signing secret. Issues a new current signing secret. - [GET /api/v1/references/agencies](https://developers.casafari.com/docs/rest/references/get-agencies-v1.md): Get agencies (v1). Returns a list of all possible agencies with user restrictions. - [GET /api/v1/references/agents](https://developers.casafari.com/docs/rest/references/get-agents-v1.md): Get agents (v1). Returns a list of all possible agents with user restrictions. - [GET /api/v1/references/conditions](https://developers.casafari.com/docs/rest/references/get-conditions-v1.md): Get conditions (v1). Returns a list of all possible estate conditions. - [GET /api/v1/references/features](https://developers.casafari.com/docs/rest/references/get-features-v1.md): Get features (v1). Returns a list of all possible property features. - [POST /api/v1/references/locations](https://developers.casafari.com/docs/rest/references/get-locations-v1.md): Get locations (v1). Returns a list of all possible locations with user restrictions. - [GET /api/v1/references/locations/by-coordinates](https://developers.casafari.com/docs/rest/references/get-location-by-passed-coordinates-v1.md): Get location by passed coordinates (v1). Returns a location for the given coordinates with user restrictions. - [POST /api/v1/references/locations/typeahead](https://developers.casafari.com/docs/rest/references/get-locations-typeahead-suggestions-scoped-by-country-code-v1.md): Get locations typeahead suggestions scoped by country code (v1). Returns location typeahead suggestions within the given country (ES or PT). - [GET /api/v1/references/sources](https://developers.casafari.com/docs/rest/references/get-sources-v1.md): Get sources (v1). Returns a list of all domains for the requested location. - [GET /api/v1/references/types](https://developers.casafari.com/docs/rest/references/get-types-v1.md): Get types (v1). Returns a list of all possible estate types. - [POST /api/v1/references/zipcode-boundary](https://developers.casafari.com/docs/rest/references/get-zipcode-boundary-by-zipcode-and-country-code-v1.md): Get zipcode boundary by zipcode and country code (v1). Get zipcode boundary by zipcode and country code. ### Claro AI REST operations (https://platform.casafari.com/v1/claro) - [POST /v1/search](https://developers.casafari.com/docs/rest/claro/search-premises.md): Search commercial premises. Find shops, restaurant premises, offices, warehouses and other commercial premises for rent or sale anywhere in Spain. - [POST /v1/search/refine](https://developers.casafari.com/docs/rest/claro/refine-search.md): Refine a search. Change part of an earlier search in plain words ("bigger, at least 200 m²", "Barcelona too", "drop the corner") and run it again, as a new search with its own… - [GET /v1/premises/{id}](https://developers.casafari.com/docs/rest/claro/get-premises.md): Get one premises. One premises in full by the id a search returned: its data, facts read from its text with the sentence each came from (fact_sources), its coordinates (exact,… - [POST /v1/compare](https://developers.casafari.com/docs/rest/claro/compare-premises.md): Compare premises. 2 to 10 premises side by side, by the ids a search returned. - [POST /v1/location](https://developers.casafari.com/docs/rest/claro/explain-location.md): Location figures. Footfall index (an index of pedestrian activity within a 5-minute walk that compares places with each other; not a head count, never people or visitors a day;… - [POST /v1/market](https://developers.casafari.com/docs/rest/claro/market-snapshot.md): What premises ask in a place. What commercial premises of a kind ask in a place anywhere in Spain, from every active property of that kind and place (each unit counted once): the asking… - [POST /v1/brief/file](https://developers.casafari.com/docs/rest/claro/brief-file.md): Read a brief from a file. The premises requirements a file states: a site brief, a location profile or a requirements sheet, as a PDF, a photo or scan (JPG, PNG, WebP, HEIC), a Word,… - [POST /v1/plots/search](https://developers.casafari.com/docs/rest/claro/search-plots.md): Search commercial plots (Germany). Find plots of land for sale or rent in Germany for a commercial building, from Casafari's property graph. Scope: Germany, commercial plots. - [GET /v1/plots/{id}](https://developers.casafari.com/docs/rest/claro/get-plot.md): Get one plot (Germany). One plot in full by the id search_plots returned: its data, commercial-use level, the facts read from its text with the quote each came from (fact_sources),… Scope: Germany, commercial plots. - [PUT /v1/stores](https://developers.casafari.com/docs/rest/claro/stores.md): Your own stores. PUT replaces the list: text/csv with a header naming name, lat and lon (latitude/longitude also work; comma, semicolon or tab separated), or JSON {"stores":… - [GET /v1/health](https://developers.casafari.com/docs/rest/claro/health.md): Service status and data vintages. ### Existing Casafari API operations (static token) - [API v1 reference](https://developers.casafari.com/docs/existing-api-customers/v1.md): 22 operations at https://api.casafari.com/v1; description as JSON: https://developers.casafari.com/docs/existing-api-customers/v1/openapi.json - [API v2 reference](https://developers.casafari.com/docs/existing-api-customers/v2.md): 3 operations at https://api.casafari.com/v2; description as JSON: https://developers.casafari.com/docs/existing-api-customers/v2/openapi.json - [GET /v1/references/agencies](https://developers.casafari.com/docs/existing-api-customers/v1/get-agencies.md): Get agencies - [GET /v1/references/agents](https://developers.casafari.com/docs/existing-api-customers/v1/get-agents.md): Get agents - [GET /v1/references/conditions](https://developers.casafari.com/docs/existing-api-customers/v1/get-conditions.md): Get conditions - [GET /v1/references/features](https://developers.casafari.com/docs/existing-api-customers/v1/get-features.md): Get features - [POST /v1/references/locations](https://developers.casafari.com/docs/existing-api-customers/v1/get-locations.md): Get locations - [GET /v1/references/locations/by-coordinates](https://developers.casafari.com/docs/existing-api-customers/v1/get-location-by-passed-coordinates.md): Get location by passed coordinates - [POST /v1/references/locations/typeahead](https://developers.casafari.com/docs/existing-api-customers/v1/get-locations-typeahead-suggestions-scoped-by-country-code.md): Get locations typeahead suggestions scoped by country code - [GET /v1/references/sources](https://developers.casafari.com/docs/existing-api-customers/v1/get-sources.md): Get sources - [GET /v1/references/types](https://developers.casafari.com/docs/existing-api-customers/v1/get-types.md): Get types - [POST /v1/references/zipcode-boundary](https://developers.casafari.com/docs/existing-api-customers/v1/get-zipcode-boundary-by-zipcode-and-country-code.md): Get zipcode boundary by zipcode and country code - [GET /v1/listing-alerts/feeds](https://developers.casafari.com/docs/existing-api-customers/v1/get-feeds-list.md): Get feeds list - [POST /v1/listing-alerts/feeds](https://developers.casafari.com/docs/existing-api-customers/v1/create-feed.md): Create feed - [GET /v1/listing-alerts/feeds/{id}](https://developers.casafari.com/docs/existing-api-customers/v1/get-alerts-by-feed.md): Get alerts by feed - [DELETE /v1/listing-alerts/feeds/{id}](https://developers.casafari.com/docs/existing-api-customers/v1/delete-feed.md): Delete feed - [PUT /v1/listing-alerts/feeds/{id}/update](https://developers.casafari.com/docs/existing-api-customers/v1/update-feed.md): Update feed - [POST /v1/listing-alerts/search](https://developers.casafari.com/docs/existing-api-customers/v1/search-alerts.md): Search alerts - [POST /v1/comparables/search](https://developers.casafari.com/docs/existing-api-customers/v1/search-comparables.md): Search comparables - [POST /v1/properties/match-by-listings](https://developers.casafari.com/docs/existing-api-customers/v1/get-property-by-listing-ids.md): Get property by listing IDs - [POST /v1/properties/search](https://developers.casafari.com/docs/existing-api-customers/v1/search-properties.md): Search properties - [GET /v1/properties/search/{property_id}](https://developers.casafari.com/docs/existing-api-customers/v1/get-property-by-id.md): Get property by ID - [POST /v1/properties/smart-links](https://developers.casafari.com/docs/existing-api-customers/v1/create-a-smart-link-beta.md): Create a smart link (BETA) - [POST /v1/valuation/comparables-prices](https://developers.casafari.com/docs/existing-api-customers/v1/search-estimated-prices.md): Search estimated prices - [POST /v2/comparables/ai-builder](https://developers.casafari.com/docs/existing-api-customers/v2/initialize-an-ai-builder-session.md): Initialize an AI Builder session - [POST /v2/comparables/search](https://developers.casafari.com/docs/existing-api-customers/v2/search-comparables.md): Search comparables - [POST /v2/properties/search](https://developers.casafari.com/docs/existing-api-customers/v2/search-properties.md): Search properties ### Data Export - [Data Export](https://developers.casafari.com/docs/data-export.md): bulk delivery as Avro files in a Google Cloud Storage bucket per country - [Property](https://developers.casafari.com/docs/data-export/property.md): Every field of the Property entity in the export files, with its type and meaning. - [Listing](https://developers.casafari.com/docs/data-export/listing.md): Every field of the Listing entity in the export files, with its type and meaning. - [Alert](https://developers.casafari.com/docs/data-export/alert.md): Every field of the Alert entity in the export files, with its type and meaning. - [Location](https://developers.casafari.com/docs/data-export/location.md): Every field of the Location entity in the export files, with its type and meaning. - [ListingPhoto](https://developers.casafari.com/docs/data-export/listing-photo.md): Every field of the ListingPhoto entity in the export files, with its type and meaning. ### FAQ - [What is Casafari?](https://developers.casafari.com/docs/faq/what-is-casafari.md): Casafari is a real estate data intelligence platform whose data is a deduplicated, cleaned property graph, with one record per property and its full history. - [What is Casafari MCP?](https://developers.casafari.com/docs/faq/what-is-casafari-mcp.md): Casafari MCP lets an AI assistant or agent use Casafari's real estate data through remote MCP servers that sign in with OAuth 2.1: for new users, one per product at platform.casafari.com. - [What is the Casafari REST API?](https://developers.casafari.com/docs/faq/what-is-casafari-rest-api.md): The Casafari REST API is the HTTP interface to Casafari's real estate data, for your own code and applications rather than an assistant's tool calls. - [What is platform.casafari.com, the Casafari self-serve platform?](https://developers.casafari.com/docs/faq/what-is-the-self-serve-platform.md): platform.casafari.com is Casafari's self-serve platform: new users sign up on their own, connect over MCP or REST, and pay by usage. - [What is the Casafari MCP server URL?](https://developers.casafari.com/docs/faq/mcp-server-url.md): For new users, the Casafari MCP server URL is one URL per product on the self-serve platform, under https://platform.casafari.com/mcp/, for example https://platform.casafari.com/mcp/comparables; https://mcp.casafari.com/ is only for existing Casafari clients. - [What is the base URL of the Casafari REST API?](https://developers.casafari.com/docs/faq/rest-base-url.md): The Casafari REST API base URL is https://api.casafari.com for existing clients; on the self-serve platform each product has its own base, https://platform.casafari.com/v1/. - [What is the difference between Casafari MCP and the Casafari REST API, and which should I use?](https://developers.casafari.com/docs/faq/mcp-vs-rest-api.md): Use MCP when an AI assistant or agent calls Casafari's data as tools; use REST when your own code calls it over HTTP. - [What is the Casafari MCP gateway, and what does `list_servers` do?](https://developers.casafari.com/docs/faq/gateway-and-list-servers.md): The gateway is the Casafari MCP server at https://mcp.casafari.com/: it signs you in, checks your rights on every call and forwards each tool; list_servers is the gateway's own tool. - [Which AI assistants and MCP clients work with Casafari MCP?](https://developers.casafari.com/docs/faq/supported-clients.md): Any MCP client that supports remote MCP servers with OAuth sign-in works, including Claude, ChatGPT, Claude Code, Cursor, VS Code and your own agent; new users add a platform.casafari.com product URL. - [Which address do I use: mcp.casafari.com, api.casafari.com or platform.casafari.com?](https://developers.casafari.com/docs/faq/which-address-do-i-use.md): New users start at platform.casafari.com, Casafari's self-serve platform; existing Casafari clients keep using mcp.casafari.com and api.casafari.com. - [I already have Casafari MCP or API access. Does anything change for me?](https://developers.casafari.com/docs/faq/existing-client-what-changes.md): No: the Casafari MCP server, the Casafari REST API, your Casafari account, your tokens and your contract stay exactly as they are. - [Where is the documentation and sign-in for the existing Casafari API?](https://developers.casafari.com/docs/faq/existing-api-reference.md): The existing Casafari API is documented in this hub under Existing API customers and REST API, with a public OpenAPI description. - [My assistant says 'Request limit reached for this product.' Is that the same as running out of units?](https://developers.casafari.com/docs/faq/existing-quota-vs-units.md): No: Request limit reached for this product. - [Who can use Casafari MCP and the Casafari API?](https://developers.casafari.com/docs/faq/who-can-use.md): Existing Casafari clients use their account's MCP subscription or API contract, and anyone new can sign up at platform.casafari.com without talking to sales. - [How do I get access to Casafari MCP or the API, and is there a free trial?](https://developers.casafari.com/docs/faq/how-to-get-access.md): New users sign up at platform.casafari.com, where the Free plan is a 30-day trial of 1,000 units with no card; existing Casafari clients get access through Casafari. - [How do I sign up for Casafari MCP or the API without talking to sales?](https://developers.casafari.com/docs/faq/how-to-sign-up.md): Create an account yourself at https://platform.casafari.com, Casafari's self-serve platform; the Free plan needs no card, and you do not need to talk to sales to start. - [How much does Casafari MCP or the Casafari API cost?](https://developers.casafari.com/docs/faq/pricing.md): Casafari MCP and API pricing depends on your route: existing contracts have no published prices, while the self-serve platform sets fixed prices for plans and credits. - [What plans does the Casafari self-serve platform offer: Free, Agent and Custom?](https://developers.casafari.com/docs/faq/plans.md): The Casafari self-serve platform offers three plans: Free, a 30-day trial of 1,000 units; Agent, a monthly or yearly subscription; and Custom, an invoiced plan for higher volume. - [Is there a free trial for Casafari MCP or the API, and what does it include?](https://developers.casafari.com/docs/faq/free-trial.md): Yes: the Free plan on the Casafari self-serve platform is a trial of 1,000 units for 30 days, and it needs no card. - [Is the Agent plan the same as AgentGraph AI?](https://developers.casafari.com/docs/faq/agent-plan-vs-agentgraph.md): No: the Agent plan is a subscription on the Casafari self-serve platform, while AgentGraph AI is a product for finding real estate agencies and agents worth partnering with. - [What are units on the Casafari platform, and how many does each request cost?](https://developers.casafari.com/docs/faq/what-are-units.md): A unit is the self-serve platform's billing atom: every operation costs a fixed whole number of units, the same over MCP and REST, from 0 to 2,500. - [What are Casafari credits, and how do I buy more units?](https://developers.casafari.com/docs/faq/what-are-credits.md): Casafari credits are prepaid units on the self-serve platform at €0.04 a unit, bought as any whole number of euros from €20, with discounts on larger purchases. - [What are the 3-hour and weekly usage windows on the Agent plan, and what does the console show?](https://developers.casafari.com/docs/faq/usage-windows.md): The Agent plan meters usage in two rolling windows, 1,000 units per 3 hours and 4,000 units per 7 days; credits pay for extra usage. - [Do location lookups cost units on the Casafari platform?](https://developers.casafari.com/docs/faq/location-lookup-free.md): No: place lookups in Location Lookup cost 0 units on the Casafari self-serve platform, during the Free trial and afterwards. - [How do I see my usage and how many units I have left?](https://developers.casafari.com/docs/faq/check-usage-and-balance.md): On the Casafari self-serve platform, check usage with the account_status tool on any platform MCP server, the REST call GET /v1/account, or the console. - [My AI agent says payment is required or I'm out of units. What do I do?](https://developers.casafari.com/docs/faq/agent-ran-out-of-units.md): On the self-serve platform, a payment error carries a payment link: a person opens it and pays, or waits for a usage window to refill, then the agent retries. - [How should my code handle a 402 from the Casafari API?](https://developers.casafari.com/docs/faq/handle-402-in-code.md): Treat a 402 payment_required from the self-serve platform as a pause: pass the upgrade_url to a person, poll the payment link until it completes, then retry the request. - [Can my AI agent pay for more Casafari usage by itself?](https://developers.casafari.com/docs/faq/can-agent-pay-itself.md): No: an AI agent cannot pay for more Casafari usage by itself; a person opens the payment link and pays, and the agent continues once the payment completes. - [Which products does Casafari offer over MCP and REST, and how many tools are there?](https://developers.casafari.com/docs/faq/which-products.md): Casafari clients get 22 MCP data tools in 3 products plus 39 REST operations; new users of the self-serve platform get nine products today, with tool counts not published. - [What is the Location Lookup product on the Casafari platform?](https://developers.casafari.com/docs/faq/what-is-location-lookup.md): Location Lookup is the self-serve platform's place-lookup product: it searches places, fetches one, lists its children or resolves coordinates, and every lookup costs 0 units. - [What is Area Insights?](https://developers.casafari.com/docs/faq/what-is-area-insights.md): Area Insights is Casafari's product for analysing an area: price, supply and activity over time; distributions by price, bedrooms and time on market; and market analysis. - [What does Comparables & Valuation do?](https://developers.casafari.com/docs/faq/what-is-comparables-valuation.md): Comparables & Valuation returns comparable properties and estimated prices for a home, drawing on properties on the market, past sales and rentals, and official registry records. - [What is AgentGraph AI?](https://developers.casafari.com/docs/faq/what-is-agentgraph.md): AgentGraph AI finds the real estate agencies and agents in Germany worth partnering with, using area screens against partner profiles, full profiles, territory maps, partner briefs and watchlists. - [Why does AgentGraph AI need a verified business, and how does verification work?](https://developers.casafari.com/docs/faq/agentgraph-verified-business.md): AgentGraph AI holds personal contact data of real estate agents, so on the self-serve platform only a verified business may call its tools; no other product needs verification. - [Can I search properties over Casafari MCP, or only over REST?](https://developers.casafari.com/docs/faq/properties-over-mcp.md): No: Property Sourcing, Casafari's property search, has no MCP tool; it is REST only, both for Casafari clients and on the self-serve platform. - [What is Property Sourcing, and can I search properties on the self-serve platform?](https://developers.casafari.com/docs/faq/what-is-property-sourcing.md): Property Sourcing is Casafari's REST product for searching properties; Casafari clients have it on the Casafari REST API, and new users have it on the self-serve platform. - [What are High Potential Seller Leads, and are they on the self-serve platform?](https://developers.casafari.com/docs/faq/what-are-high-potential-seller-leads.md): High Potential Seller Leads is a self-serve, REST-only Casafari product for Spain, France, Italy, Germany, Greece and Andorra: Free, Agent and Custom include it, as they do Property Sourcing. - [Can I get alerts (new properties, price cuts, sales) over Casafari MCP?](https://developers.casafari.com/docs/faq/alerts-over-mcp.md): No: Alerts has no MCP tool on either route, so Casafari clients use the existing Casafari REST API and new users use REST on the self-serve platform. - [What are the References operations for?](https://developers.casafari.com/docs/faq/what-is-references.md): References is a set of 10 REST-only operations on the existing Casafari REST API that return the reference data other requests are built from. - [Which tools exist only over MCP, and which operations only over REST?](https://developers.casafari.com/docs/faq/mcp-only-and-rest-only.md): AgentGraph AI is MCP only, and Alerts and Property Sourcing are REST only everywhere; Comparables & Valuation has both, for Casafari clients and on the self-serve platform. - [How are Casafari MCP tools named?](https://developers.casafari.com/docs/faq/tool-naming.md): Tools on the Casafari MCP server follow the pattern _, such as comps_get-comparables or ma_get_heatmap. - [Which countries does Casafari cover?](https://developers.casafari.com/docs/faq/which-countries.md): Casafari's API permissions list exactly 16 markets, and the documentation names no others. - [Does Casafari cover Spain and Portugal?](https://developers.casafari.com/docs/faq/coverage-spain-portugal.md): Yes, Spain (ES) and Portugal (PT) are two of the 16 markets in Casafari's API permissions, and several tools mention them by name. - [Does Casafari cover Germany?](https://developers.casafari.com/docs/faq/coverage-germany.md): Yes: Germany (DE) is one of the 16 markets in Casafari's API permissions, and AgentGraph AI, the product for agencies and agents, is described for Germany. - [What if the country I need is not on the list?](https://developers.casafari.com/docs/faq/country-not-listed.md): If your market is not one of the 16 in Casafari's API permissions, this documentation does not cover it, and it publishes no roadmap. - [Does every tool cover all 16 countries?](https://developers.casafari.com/docs/faq/per-tool-coverage.md): There is no per-tool country list: each tool covers what its own description says, and only three places in the documentation name a market. - [How do I connect Casafari MCP to Claude?](https://developers.casafari.com/docs/faq/connect-claude.md): In Claude, add a custom connector under Customize → Connectors with the URL of a Casafari MCP server, for new users a platform product such as https://platform.casafari.com/mcp/comparables, then sign in with OAuth when Claude asks. - [Why can't I add a custom connector in Claude?](https://developers.casafari.com/docs/faq/claude-custom-connector-greyed-out.md): On Claude's Team and Enterprise plans only an organisation owner can add a custom connector: an owner adds each product's https://platform.casafari.com/mcp/ URL once, then each member connects with their own account. - [How do I connect Casafari MCP to ChatGPT?](https://developers.casafari.com/docs/faq/connect-chatgpt.md): In ChatGPT, turn on Developer mode and create a connector with the URL of a Casafari MCP server, for new users a platform product such as https://platform.casafari.com/mcp/comparables; choose OAuth, then sign in and approve. - [How do I add Casafari MCP to Claude Code?](https://developers.casafari.com/docs/faq/connect-claude-code.md): Claude Code adds a Casafari MCP server with claude mcp add --transport http and its URL, for new users claude mcp add --transport http casafari-comparables https://platform.casafari.com/mcp/comparables; then authenticate with OAuth from /mcp. - [How do I add Casafari MCP to Cursor?](https://developers.casafari.com/docs/faq/connect-cursor.md): In Cursor, add a Casafari MCP server's URL to ~/.cursor/mcp.json, for new users a platform product such as https://platform.casafari.com/mcp/comparables; it signs in with OAuth, with no key in the file. - [How do I add Casafari MCP to VS Code?](https://developers.casafari.com/docs/faq/connect-vscode.md): In VS Code, add a Casafari MCP server's URL as an http server in .vscode/mcp.json, for new users a platform product such as https://platform.casafari.com/mcp/comparables; it signs in with OAuth, with no key in the file. - [How do I connect any other MCP client, or build my own agent on Casafari MCP?](https://developers.casafari.com/docs/faq/connect-other-client.md): Point any remote MCP client with OAuth at a Casafari MCP server's URL, for new users a platform product such as https://platform.casafari.com/mcp/comparables; it registers itself and signs in with OAuth 2.1, with no API key. - [How do I check that Casafari MCP is connected and working?](https://developers.casafari.com/docs/faq/verify-connection.md): Ask your assistant to call the server's check tool: account_status on a platform.casafari.com server, or list_servers on the Casafari MCP server for existing clients; an answer means the connection works. - [How do I make my first call to the Casafari REST API?](https://developers.casafari.com/docs/faq/first-rest-call.md): Get a credential and send it: Casafari clients log in to the Casafari REST API for a JWT; new users send an API key from the self-serve platform. - [Where is the OpenAPI spec for the Casafari API?](https://developers.casafari.com/docs/faq/openapi-per-product.md): Casafari publishes OpenAPI descriptions for both APIs: a public file for the Casafari REST API, and the self-serve platform's, per product and in one file at https://platform.casafari.com/v1/openapi.json. - [How does authentication work on Casafari MCP? Does it use OAuth scopes?](https://developers.casafari.com/docs/faq/how-authentication-works.md): Casafari MCP uses OAuth 2.1 sign-in with no API key; the Casafari MCP server uses no OAuth scopes, and REST signs in with separate credentials. - [How does a client discover Casafari's authorization server?](https://developers.casafari.com/docs/faq/oauth-discovery.md): An MCP client discovers Casafari's authorization server from the MCP server it connects to; on the Casafari MCP server that takes two hops, starting from a 401 response. - [Can my MCP client register itself with Casafari?](https://developers.casafari.com/docs/faq/dynamic-client-registration.md): Yes: an MCP client acting for a signed-in person can register itself, both on the Casafari MCP server and on the self-serve platform's MCP servers. - [How does an agent sign in when no person is there to approve?](https://developers.casafari.com/docs/faq/unattended-agents.md): An unattended agent uses the OAuth client credentials grant with a client set up in advance for the account; the self-serve platform's REST API also accepts an API key. - [What happens when my Casafari access token expires?](https://developers.casafari.com/docs/faq/token-expiry-refresh.md): What to do depends on the credential: refresh the token where a refresh token exists, otherwise request a new token or sign in again. - [How do I authenticate with the Casafari REST API?](https://developers.casafari.com/docs/faq/rest-authentication.md): Existing Casafari clients sign in to api.casafari.com with email and password or an API client; new self-serve users authenticate on platform.casafari.com with an API key or OAuth client. - [Do I need an API key for Casafari MCP?](https://developers.casafari.com/docs/faq/api-key.md): No, you don't need an API key for Casafari MCP: assistants sign in with OAuth 2.1, both on the Casafari MCP server and on the self-serve platform's MCP servers. - [Should I use an API key or an OAuth client for the Casafari REST API?](https://developers.casafari.com/docs/faq/api-key-or-oauth-client.md): Both an API key and an OAuth client authenticate the self-serve platform's REST API; both are created in the console, and they differ in how each is sent. - [Where do I create a Casafari API key, and can I revoke it?](https://developers.casafari.com/docs/faq/create-api-key.md): Create a Casafari API key in the self-serve platform's console at https://platform.casafari.com/console; the key, starting cf_sk_, is shown only once, so store it immediately. - [How do I get an OAuth access token for the Casafari REST API with client credentials?](https://developers.casafari.com/docs/faq/oauth-client-credentials-rest.md): Create an OAuth client in the console at platform.casafari.com, then request a token at https://platform.casafari.com/oauth/token with the client credentials grant and resource set to the product's URL. - [Where should I keep my Casafari API key, and can I paste it into an AI assistant?](https://developers.casafari.com/docs/faq/keep-api-key-safe.md): Keep a Casafari API key in your server's environment, never in an AI assistant: assistants connect to the self-serve platform's MCP servers with OAuth 2.1 and need no key. - [What are Casafari's rate limits, quotas and usage limits?](https://developers.casafari.com/docs/faq/rate-limits-and-quotas.md): Casafari publishes no rate-limit or quota figures for existing contracts; the self-serve platform meters usage in units, with limits set per plan: Free, Agent and Custom, published on Limits and usage windows. - [Why is a tool missing from `tools/list`, or a call refused?](https://developers.casafari.com/docs/faq/tool-missing-or-refused.md): On the Casafari MCP server, a missing or refused tool means your subscription doesn't cover it; on the self-serve platform, tools are listed and a refusal carries a link. - [Which Casafari errors should I retry, and which not?](https://developers.casafari.com/docs/faq/which-errors-to-retry.md): On the Casafari MCP server and REST API, retry only 5xx errors with backoff; on the self-serve platform, retry refused calls only after payment, a window refill or verification. - [Which errors does the Casafari REST API return, and which should I retry?](https://developers.casafari.com/docs/faq/rest-errors-and-retries.md): On the Casafari REST API, retry only 5xx errors with backoff; the self-serve platform's REST API returns application/problem+json errors, such as 402 payment_required, that need action before a retry. - [How do I value a home or find comparables with Casafari?](https://developers.casafari.com/docs/faq/example-valuation.md): Request comparables around an address or a point, as in Casafari's example: a 3-bedroom flat near Avenida da Liberdade, Lisbon, with comparables within 1 km. - [How do I analyse how prices in an area have moved over time?](https://developers.casafari.com/docs/faq/example-price-trend.md): Resolve the place to a location id, fetch a price time series from Area Insights, then compute growth and volatility with time-series operations. - [How do I see how properties are distributed by price, bedrooms or time on market, or get a heatmap?](https://developers.casafari.com/docs/faq/example-distributions-heatmap.md): Area Insights offers distributions of properties by price, bedrooms and time on market, plus a heatmap that shows one metric for each district. - [Can I build a market report with Casafari MCP or the REST API?](https://developers.casafari.com/docs/faq/example-market-report.md): Yes: Casafari supplies the figures over MCP or REST and your assistant or code writes the report, though the hub documents data operations, not report formats or exports. - [How do I find agencies or agents to partner with in a German city?](https://developers.casafari.com/docs/faq/example-find-agencies-germany.md): Use AgentGraph AI over MCP: find the location, review the partner profiles, screen agencies or agents, open a profile, get a partner brief, then watch the ones you choose. - [How do I look up one property and its price history?](https://developers.casafari.com/docs/faq/example-property-lookup.md): Use Property Sourcing over REST: on the Casafari REST API with a Casafari client account, or on the self-serve platform as a new user; no MCP tool looks up one property. - [How do I turn a place name into a location id?](https://developers.casafari.com/docs/faq/location-ids.md): Use a location lookup to turn a place name into location ids, then pass those ids to the operations that need them. - [How do I get alerts delivered to a webhook?](https://developers.casafari.com/docs/faq/alerts-webhook.md): Over REST, create an alert feed, set your webhook URL and rotate the signing secret when needed; Alerts has no MCP tool on either route. - [How do I build on the Casafari REST API?](https://developers.casafari.com/docs/faq/build-on-rest.md): Read the OpenAPI description, authenticate, then call lookups before the product operations you need; the address and credentials differ for Casafari clients and new users. - [What is the Casafari property graph, and where does the data come from?](https://developers.casafari.com/docs/faq/what-is-the-property-graph.md): The property graph is Casafari's data model: it collects property advertisements from agency websites and portals as they appear and change, then structures, cleans, deduplicates and merges them into one record per property. - [Why is Casafari the most complete property index in Europe?](https://developers.casafari.com/docs/faq/why-most-complete-property-index.md): By Casafari's own count, its property graph covers at least 40% more deduplicated properties and tracks 7 times more property advertisements than any standalone platform or portal. - [Why does Casafari count properties and not advertisements?](https://developers.casafari.com/docs/faq/count-properties-not-advertisements.md): Each record in the graph already merges every source that advertises the property, so counting advertisements would count the same home several times. - [Does Casafari keep price and status history?](https://developers.casafari.com/docs/faq/price-and-status-history.md): Yes, every property record carries its full dated history of price changes, status changes, appearances and removals in sale_price_history and rent_price_history. - [Does Casafari cover rentals and commercial property?](https://developers.casafari.com/docs/faq/rentals-and-commercial.md): Yes: the property graph covers residential and commercial property, for sale and for rent, in a single schema and location tree. - [How often is Casafari's data updated?](https://developers.casafari.com/docs/faq/data-refresh-frequency.md): Casafari monitors more than 10,000 real estate sources, refreshing the top portals every hour and all other sources daily, according to the API and MCP team's published statement (https://developers.casafari.com/docs/rest). - [Is there an SLA, and what are the contract terms?](https://developers.casafari.com/docs/faq/sla-and-contract-terms.md): Casafari publishes no standard SLA or uptime figure; contract clients' service levels can be set in an Order Form, and the self-serve platform runs under its published Platform Terms of Use. - [Can I read these docs as Markdown, and is there an llms.txt?](https://developers.casafari.com/docs/faq/machine-readable-docs.md): Yes: add .md to any page's URL or send Accept: text/markdown, and /llms.txt indexes every page and tool. ### Use cases and product FAQs - [Property Sourcing FAQ](https://developers.casafari.com/docs/property-sourcing/faq.md): 14 questions about Property Sourcing - [Property Sourcing use cases](https://developers.casafari.com/docs/property-sourcing/use-cases.md) - [Deduplicated buyer shortlist from a plain-language brief](https://developers.casafari.com/docs/property-sourcing/use-cases/deduplicated-buyer-shortlist-from-a-brief.md): Turn a client's brief into one deduplicated property record per home with Casafari's describe search, matched tags and price per sqm. - [Price-per-sqm value screen across European markets](https://developers.casafari.com/docs/property-sourcing/use-cases/price-per-sqm-value-screen-across-markets.md): Use one Casafari search body per country, sorted by price per sqm, then read energy rating, condition and price history before bidding. - [Resolve client-forwarded links to one property record](https://developers.casafari.com/docs/property-sourcing/use-cases/resolve-client-forwarded-links.md): Resolve a portal or agency link or reference to one Casafari property record, then see every place the home is advertised and at what price. - [Shared-mandate and competitor mapping for an office](https://developers.casafari.com/docs/property-sourcing/use-cases/shared-mandate-and-competitor-mapping.md): Search an office's area with Casafari, use listings_count and expand=listings to map exclusive versus shared mandates and which agencies hold them. - [New-supply digest for a farm area](https://developers.casafari.com/docs/property-sourcing/use-cases/new-supply-digest-for-a-farm-area.md): Poll Casafari daily with sort=newest for your farm area, diff first_seen and property ids, and send a deduplicated digest of new homes. - [Grounded property tool for an AI assistant](https://developers.casafari.com/docs/property-sourcing/use-cases/grounded-property-tool-for-an-ai-assistant.md): Expose Casafari's describe search, property read and resolve as tools; the agent learns them from /openapi.json and /llms.txt and handles 402 and 429. - [Short-let investor filter with rental licence](https://developers.casafari.com/docs/property-sourcing/use-cases/short-let-investor-filter.md): Combine Casafari's features and exclude_features filters with price-per-sqm sorting to find homes with a rental licence, terrace and parking. - [High Potential Seller Leads FAQ](https://developers.casafari.com/docs/seller-leads/faq.md): 14 questions about High Potential Seller Leads - [High Potential Seller Leads use cases](https://developers.casafari.com/docs/seller-leads/use-cases.md) - [Street-level mandate prospecting list](https://developers.casafari.com/docs/seller-leads/use-cases/street-level-mandate-prospecting-list.md): List homes within 300 metres of a point with at least two price cuts totalling 10% using High Potential Seller Leads, then read each property's dated history. - [Weekly newly-motivated homes alert for an office](https://developers.casafari.com/docs/seller-leads/use-cases/weekly-newly-motivated-homes-alert.md): Run High Potential Seller Leads weekly with since set to the last run, diff lead ids and push newly reduced homes to each office's CRM. - [Investor negotiation ranking by price erosion](https://developers.casafari.com/docs/seller-leads/use-cases/investor-negotiation-ranking.md): List High Potential Seller Leads around a target point, rank them by price_cuts.percentage and read each lead's dated history before bidding. - [Pricing-conversation evidence pack for a valuation meeting](https://developers.casafari.com/docs/seller-leads/use-cases/pricing-conversation-evidence-pack.md): Pull High Potential Seller Leads within 300 metres of an owner's home and show how many neighbours cut, by how much and since when, with dated histories. - [Rent-cut radar for letting agents and landlords](https://developers.casafari.com/docs/seller-leads/use-cases/rent-cut-radar-for-letting-agents-and-landlords.md): Use High Potential Seller Leads with operation=rent around a point to list rentals with repeated rent reductions before setting your own rent. - [Compliant seller-prospecting workflow for an AI agent](https://developers.casafari.com/docs/seller-leads/use-cases/compliant-seller-prospecting-workflow-for-an-ai-agent.md): Let an AI agent call High Potential Seller Leads (no names, phones or emails), read the property record, and leave consent and channel checks to a human. - [Stale-stock monitor around a development](https://developers.casafari.com/docs/seller-leads/use-cases/stale-stock-monitor-around-a-development.md): Run High Potential Seller Leads monthly around each development to track the count and average percentage of price cuts on competing homes nearby. - [Claro API and MCP: developer FAQ](https://developers.casafari.com/docs/claro/faq.md): 24 developer questions about the Claro API and MCP: base URL, keys, transport, paging, limits, errors, data meaning and content terms - [Claro API and MCP use cases for developers](https://developers.casafari.com/docs/claro/use-cases.md) - [Score every match with your own model](https://developers.casafari.com/docs/claro/use-cases/score-every-match-with-your-own-model.md): Pull every match with its raw data, matched sentences and location figures with source and vintage, and score them with your own model. - [Load every matching premises into your CRM nightly](https://developers.casafari.com/docs/claro/use-cases/nightly-pipeline-into-crm-or-bi.md): Run a saved brief each night, page through every match on fixed cursors, key rows on pm_ ids and reconcile the load against exact counts. - [Location figures for any point in Spain](https://developers.casafari.com/docs/claro/use-cases/location-figures-for-any-point.md): Send any lat and lon in Spain to explain_location and get the footfall index, residents by age, households, spending power and nearby places with vintages. - [Keyword search from a form with no model](https://developers.casafari.com/docs/claro/use-cases/keyword-search-from-a-form.md): Map a simple form to criteria.keywords and exclude_keywords with no brief and check false; every match returns the sentence and phrase that triggered it. - [Compare a shortlist for a committee dossier](https://developers.casafari.com/docs/claro/use-cases/compare-a-shortlist-for-a-dossier.md): Call compare_premises with the shortlist's ids, then get_premises with insights, segments and assessment for each finalist, citing only the sentences returned. - [Embed the search box with a publishable key](https://developers.casafari.com/docs/claro/use-cases/embed-the-search-box-with-a-publishable-key.md): Load the embeddable box with a pub_ key sent in the body as text/plain, from the issued origins only, 50 results a page; keep the secret key on the server. - [Turn a brief document into a search](https://developers.casafari.com/docs/claro/use-cases/brief-from-a-file.md): Send the file as base64 to brief_from_file, show the brief and each requirement's quote for the user to confirm, then pass the brief to search_premises. - [Find commercial plots in Germany by stated use](https://developers.casafari.com/docs/claro/use-cases/germany-commercial-plots.md): Germany, commercial plots: search_plots and get_plot return plots of land for a commercial building with a commercial-use level and its quote, never premises. - [Keep candidates away from your own stores](https://developers.casafari.com/docs/claro/use-cases/keep-candidates-away-from-your-own-stores.md): Upload your store coordinates with PUT /v1/claro/stores and search with own_stores_away_m so no candidate sits within N metres of a store you run. - [Chart asking rent per m² by district](https://developers.casafari.com/docs/claro/use-cases/asking-rent-benchmark-by-district.md): Call market_snapshot with a place, type and operation to chart the asking price per m² distribution, size bands, districts and a three-year monthly average. ### Use cases - [How do I value a property with comparables?](https://developers.casafari.com/docs/use-cases/value-a-property-with-comparables.md): Get comparable properties, market statistics and fair, fast-sell and out-of-market price estimates for a home with one call to comps_get-comparables. - [How much rent can I ask for this property?](https://developers.casafari.com/docs/use-cases/estimate-rental-price.md): Estimate a fair monthly rent from rental comparables and area rent trends with comps_get-comparables (operation rent) and Area Insights time series. - [How do I value a property in Spain from its cadastral reference?](https://developers.casafari.com/docs/use-cases/valuation-by-cadastral-reference-spain.md): Pass a Spanish cadastral reference to comps_get-comparables and get comparables, registry records and price estimates without typing an address. - [How do I find comparables for a shop, office, warehouse or plot?](https://developers.casafari.com/docs/use-cases/value-commercial-property-or-plot.md): Use comps_get-comparables with investment or plot type groups, total_area or plot_area, to price commercial units and land from comparable properties. - [How do I turn comparables into a client-ready CMA report?](https://developers.casafari.com/docs/use-cases/cma-report-for-clients.md): Run comps_get-comparables, open the casafari_link CMA page, start an AI Builder session from valuation_id and share selected properties with a smart link. - [How have asking prices per m² moved in an area over time?](https://developers.casafari.com/docs/use-cases/price-per-sqm-trend-in-an-area.md): Build a price-per-m² series for a city or district and compute growth, CAGR and volatility with ma_get_time_series_data and ma_get_time_series_operations. - [Which districts of a city are the most expensive, the busiest or growing fastest?](https://developers.casafari.com/docs/use-cases/compare-neighbourhoods-heatmap.md): Rank every district of a city by price per m², supply, new properties or price cuts with ma_get_heatmap, then measure growth per district. - [Is it a buyer's or a seller's market in this area?](https://developers.casafari.com/docs/use-cases/supply-and-demand-in-an-area.md): Track new properties, properties sold or rented, stock on the market and price rises versus cuts over time with Casafari Area Insights time series. - [How long will a property take to sell or rent in this area?](https://developers.casafari.com/docs/use-cases/how-long-to-sell-time-on-market.md): See average days on market by price band with ma_get_time_on_market_distribution and compare with comparables' average_time_on_the_market. - [What does a 2-bedroom apartment cost in this area, and how are prices spread?](https://developers.casafari.com/docs/use-cases/price-by-bedrooms-and-price-bands.md): Get properties_count, average price and price per m² by bedroom count, and the number of properties per price band, with Casafari Area Insights. - [How do I build a monthly local market report with Casafari data?](https://developers.casafari.com/docs/use-cases/local-market-report.md): Combine Area Insights time series, operations, distributions and heatmap into a repeatable market report for any area, by assistant or by script. - [How do I analyse a zip code or postcode area with Casafari?](https://developers.casafari.com/docs/use-cases/analyse-a-postcode-area.md): Turn a zip code into a boundary with POST /api/v1/references/zipcode-boundary, then run comparables, property search and alerts on that polygon. - [How do I find properties newly advertised by private owners?](https://developers.casafari.com/docs/use-cases/private-seller-leads.md): Catch for-sale-by-owner properties as they appear with a New Market Leads feed filtered to private sellers, or search alerts and properties by private. - [How do I find properties with price reductions, especially repeated cuts?](https://developers.casafari.com/docs/use-cases/price-cut-leads-motivated-sellers.md): Get an alert on every price cut, find properties long on the market and count consecutive reductions in sale_price_history to spot motivated sellers. - [How do I get real-time property alerts for my filters delivered to a webhook?](https://developers.casafari.com/docs/use-cases/new-property-alerts-to-webhook.md): Create a New Market Leads feed, set a signed webhook, rotate its secret and manage feeds with the /alerts-api operations of the Casafari REST API. - [How do I track what competing agencies are selling, reserving and removing in my area?](https://developers.casafari.com/docs/use-cases/monitor-competitor-agencies.md): Follow competitors' properties, exclusivity and status changes with References agencies and agents, property search filters and New Market Leads alerts. - [How do I find bank-owned and auction properties in an area?](https://developers.casafari.com/docs/use-cases/bank-owned-and-auction-properties.md): Search and get alerts for bank and auction properties with the bank and auction filters of Property Sourcing and New Market Leads, with area price context. - [How do I find properties priced below the area's market value?](https://developers.casafari.com/docs/use-cases/find-underpriced-properties.md): Benchmark an area's price per m², search for properties under it and confirm with comps_get-comparables' fair_market_price versus asking price. - [What gross rental yield can I expect in this area, and which properties beat it?](https://developers.casafari.com/docs/use-cases/rental-yield-by-area.md): Compute area gross yield from Area Insights rent and sale price per m², filter properties by gross_yield and read gross_yield on comparables. - [How do I look up one property and see every price and status change?](https://developers.casafari.com/docs/use-cases/property-price-and-status-history.md): Fetch a property by id with GET /api/v1/properties/search/{property_id} and read sale_price_history, rent_price_history and status changes with dates. - [How do I resolve a portal or agency ad id to the property it belongs to?](https://developers.casafari.com/docs/use-cases/match-advertisements-to-one-property.md): Deduplicate your feed or CRM: POST /api/v1/properties/match-by-listings maps advertisement ids to one property record with all its sources and history. - [How do I build property search into my application with the Casafari REST API?](https://developers.casafari.com/docs/use-cases/property-search-api-for-your-app.md): Authenticate, load reference values, search the property graph with structured filters and share selections: the Property Sourcing REST workflow. - [Which agencies in a German city are worth partnering with?](https://developers.casafari.com/docs/use-cases/find-partner-agencies-germany.md): Screen the agencies active in a German area against partner profiles, open full profiles and get a one-page partner brief with AgentGraph AI over MCP. - [Which individual agents in a German area should I recruit or partner with?](https://developers.casafari.com/docs/use-cases/recruit-agents-germany.md): Rank named agents against profiles such as top performer with a capped territory or early-phase broker, view careers and get a brief with AgentGraph AI. - [Where should my brokerage open or grow next in Germany?](https://developers.casafari.com/docs/use-cases/where-to-open-an-office-germany.md): Score every district of a German region by active homes, exits, brokers, franchise versus independent share and opportunity with agentgraph_territory_map. - [How do I get notified when a watched agency or agent changes?](https://developers.casafari.com/docs/use-cases/watch-agencies-and-agents-germany.md): Save agencies and agents to a shared watchlist, re-measured daily, and ask agentgraph_watchlist_changes what changed: momentum, price cuts, moves, silence. ### More - [All MCP tool schemas as JSON](https://developers.casafari.com/tools.json) - [MCP tool catalogue as OpenAPI](https://developers.casafari.com/mcp/openapi.json): the same tools, one POST path per tool - [Casafari API (Deutsch)](https://de.casafari.com/produkte/apis-immobiliendaten/): Immobiliendaten-API - [Casafari MCP (Deutsch)](https://de.casafari.com/produkte/casafari-mcp-immobiliendaten-fuer-ki-agenten/): Immobiliendaten für KI-Agenten - [Casafari API (Español)](https://es.casafari.com/productos/api/): API de datos inmobiliarios - [Casafari MCP (Español)](https://es.casafari.com/productos/casafari-mcp-datos-inmobiliarios-para-agentes-de-ia/): datos inmobiliarios para agentes de IA - [Casafari API (Français)](https://fr.casafari.com/produits/apis-casafari-donnees-immobilieres/): API de données immobilières - [Casafari MCP (Français)](https://fr.casafari.com/produits/casafari-mcp-donnees-immobilieres-pour-les-agents-ia/): données immobilières pour les agents IA - [Casafari API (Italiano)](https://it.casafari.com/prodotti/api/): API di dati immobiliari - [Casafari MCP (Italiano)](https://it.casafari.com/prodotti/casafari-mcp-dati-immobiliari-per-agenti-ia/): dati immobiliari per agenti IA - [Casafari API (Português)](https://pt.casafari.com/produtos/apis/): API de dados imobiliários - [Casafari MCP (Português)](https://pt.casafari.com/produtos/casafari-mcp-dados-imobiliarios-para-agentes-de-ia/): dados imobiliários para agentes de IA - [How to obtain a credential](https://www.casafari.com/auth.md) - [MCP server card](https://mcp.casafari.com/.well-known/mcp/server-card.json)