# Casafari MCP > 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. Reach it, with comparables and valuations, area insights and agency and agent analysis, as 22 MCP tools in 3 products at https://mcp.casafari.com/ (Streamable HTTP, OAuth 2.1 with a Casafari account), and 39 REST operations at https://api.casafari.com (bearer token from POST /login). Every page below is Markdown. MCP tools are named `_` as the gateway exposes them. 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://platform.casafari.com/docs.md): endpoint, products, naming, access - [The property graph](https://platform.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 - [Connect](https://platform.casafari.com/docs/connect.md): Claude, ChatGPT, Claude Code, Cursor, VS Code and any MCP client - [Authentication](https://platform.casafari.com/docs/authentication.md): OAuth 2.1 discovery, registration, PKCE, refresh, client credentials - [REST API](https://platform.casafari.com/docs/rest.md): base URL, bearer-token sign-in, every operation by product - [MCP and REST compared](https://platform.casafari.com/docs/parity.md): per product, what exists over MCP, over REST or both, and the gaps - [For AI agents](https://platform.casafari.com/docs/agents.md): machine-readable entry points - [All tools](https://platform.casafari.com/docs/tools.md): every MCP tool with its title - [FAQ](https://platform.casafari.com/docs/faq.md): every question about Casafari MCP in one page, each with a permalink ## Products - [Properties](https://platform.casafari.com/docs/properties.md): Search the property graph, where every property is one record with its price and status history. Over REST: search by structured filters, fetch a property and its history by id, resolve a portal or agency ad id to the property it belongs to, create shareable links. (5 REST operations) - [Comparables & Valuation](https://platform.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://platform.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) - [Alerts](https://platform.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://platform.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://platform.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) - [Gateway](https://platform.casafari.com/docs/gateway.md): The gateway's own tool: lists the tool groups your account can use, with each group's usage instructions. ## MCP tools - [list_servers](https://platform.casafari.com/docs/gateway/list_servers.md): List Servers. List the tool groups available to you. - [comps_get-comparables](https://platform.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://platform.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://platform.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://platform.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://platform.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://platform.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://platform.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://platform.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://platform.casafari.com/docs/area-insights/get_location_typeahead.md): Get Location Typeahead. Retrieve typeahead suggestions for a given location name. - [agentgraph_find_location](https://platform.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://platform.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://platform.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://platform.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://platform.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://platform.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://platform.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://platform.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://platform.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://platform.casafari.com/docs/agentgraph/remove_from_watchlist.md): Remove from watchlist. Removes entries from your organisation's watchlist by id. - [agentgraph_watchlist](https://platform.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://platform.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://platform.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,… ## REST API operations - [POST /login](https://platform.casafari.com/docs/rest/authentication/login.md): Login. - [GET /refresh-token](https://platform.casafari.com/docs/rest/authentication/refresh-token.md): Refresh Token. - [POST /api/v1/properties/match-by-listings](https://platform.casafari.com/docs/rest/properties/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://platform.casafari.com/docs/rest/properties/search-properties-v1.md): Search properties (v1). - [GET /api/v1/properties/search/{property_id}](https://platform.casafari.com/docs/rest/properties/get-property-by-id-v1.md): Get property by ID (v1). Returns a property object. - [POST /api/v1/properties/smart-links](https://platform.casafari.com/docs/rest/properties/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://platform.casafari.com/docs/rest/properties/search-properties-v2.md): Search properties (v2). - [POST /api/v1/comparables/search](https://platform.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://platform.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://platform.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://platform.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://platform.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://platform.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://platform.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://platform.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://platform.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://platform.casafari.com/docs/rest/area-insights/analysis.md): Analysis. Market analysis based on the requested property parameters. - [GET /api/v1/listing-alerts/feeds](https://platform.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://platform.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://platform.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://platform.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://platform.casafari.com/docs/rest/alerts/update-feed-v1.md): Update feed (v1). Update alerts feed by id. - [POST /api/v1/listing-alerts/search](https://platform.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://platform.casafari.com/docs/rest/alerts/list-feeds.md): List feeds. Returns a paginated list of feeds, sorted newest first. - [POST /alerts-api/feeds](https://platform.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://platform.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://platform.casafari.com/docs/rest/alerts/delete-feed.md): Delete feed. Permanently removes the feed. - [PUT /alerts-api/webhooks](https://platform.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://platform.casafari.com/docs/rest/alerts/rotate-signing-secret.md): Rotate signing secret. Issues a new current signing secret. - [GET /api/v1/references/agencies](https://platform.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://platform.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://platform.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://platform.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://platform.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://platform.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://platform.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://platform.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://platform.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://platform.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. ## Data Export - [Data Export](https://platform.casafari.com/docs/data-export.md): bulk delivery as Avro files in a Google Cloud Storage bucket per country - [Property](https://platform.casafari.com/docs/data-export/property.md): Every field of the Property entity in the export files, with its type and meaning. - [Listing](https://platform.casafari.com/docs/data-export/listing.md): Every field of the Listing entity in the export files, with its type and meaning. - [Alert](https://platform.casafari.com/docs/data-export/alert.md): Every field of the Alert entity in the export files, with its type and meaning. - [Location](https://platform.casafari.com/docs/data-export/location.md): Every field of the Location entity in the export files, with its type and meaning. - [ListingPhoto](https://platform.casafari.com/docs/data-export/listing-photo.md): Every field of the ListingPhoto entity in the export files, with its type and meaning. ## Get access - [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 ## FAQ - [What is Casafari MCP?](https://platform.casafari.com/docs/faq/what-is-casafari-mcp.md): Casafari MCP is a single remote MCP server, https://mcp.casafari.com/, that gives an AI assistant or agent access to Casafari's real estate data: 22 data tools across 3 products. - [What is Casafari?](https://platform.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 the Casafari MCP server URL?](https://platform.casafari.com/docs/faq/mcp-server-url.md): The Casafari MCP server URL is https://mcp.casafari.com/. - [What is the difference between Casafari MCP and the Casafari REST API?](https://platform.casafari.com/docs/faq/mcp-vs-rest-api.md): Casafari MCP and the REST API serve the same property graph, but MCP serves assistants and agents and uses OAuth 2.1, while REST offers 39 operations and signs in with email and password. - [What is the Casafari MCP gateway, and what does `list_servers` do?](https://platform.casafari.com/docs/faq/gateway-and-list-servers.md): The gateway is the Casafari MCP server: it signs you in, checks your rights on every call, and forwards each tool to the service that owns it; list_servers is a tool of the gateway itself. - [Which AI assistants and MCP clients work with Casafari MCP?](https://platform.casafari.com/docs/faq/supported-clients.md): Casafari MCP works with any client that supports remote MCP servers over Streamable HTTP with OAuth. - [Which countries does Casafari cover?](https://platform.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://platform.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://platform.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://platform.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://platform.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. - [Which products does Casafari MCP offer, and how many tools are there?](https://platform.casafari.com/docs/faq/which-products.md): Casafari MCP offers 22 data tools across 3 products behind the gateway, plus list_servers. - [What is Area Insights?](https://platform.casafari.com/docs/faq/what-is-area-insights.md): Area Insights is Casafari's product for analysing an area rather than a single home: price, supply and activity over time; distributions by price, bedrooms and time on market; and market analysis. - [What does Comparables & Valuation do?](https://platform.casafari.com/docs/faq/what-is-comparables-valuation.md): Comparables & Valuation returns comparable properties and estimated prices for a home, matched around a point, an address or a cadastral reference. - [What is AgentGraph AI?](https://platform.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. - [Can I search properties over Casafari MCP?](https://platform.casafari.com/docs/faq/properties-over-mcp.md): No. - [Can I get alerts (new properties, price cuts, sales) over Casafari MCP?](https://platform.casafari.com/docs/faq/alerts-over-mcp.md): No. - [What are the References operations for?](https://platform.casafari.com/docs/faq/what-is-references.md): References is the REST-only set of 10 operations that return the reference data other requests are built from: property types, features, conditions, agencies, agents, sources, locations and zip-code boundaries. - [Which tools exist only over MCP, and which operations only over REST?](https://platform.casafari.com/docs/faq/mcp-only-and-rest-only.md): Three Area Insights tools and all 13 AgentGraph AI tools are available only over MCP; Properties, Alerts, References, the comparables AI builder, and two Area Insights operations are available only over REST. - [How are Casafari MCP tools named?](https://platform.casafari.com/docs/faq/tool-naming.md): Casafari MCP tools follow the pattern _, such as comps_get-comparables or ma_get_heatmap. - [Who can use Casafari MCP?](https://platform.casafari.com/docs/faq/who-can-use.md): Anyone with a Casafari account that has an MCP subscription can use Casafari MCP. - [How do I get access to Casafari MCP, and is there a free trial?](https://platform.casafari.com/docs/faq/how-to-get-access.md): Contact Casafari through the "Contact us" button on its MCP page (https://www.casafari.com/products/property-data-mcp-ai-agents/), since access requires a Casafari account with an MCP subscription. - [Do I need an API key for Casafari MCP?](https://platform.casafari.com/docs/faq/api-key.md): No, Casafari MCP doesn't use an API key: you sign in with OAuth 2.1 through your Casafari account, and the token you get carries that account's rights. - [How do I connect Casafari MCP to Claude?](https://platform.casafari.com/docs/faq/connect-claude.md): In Claude, go to Settings → Connectors, choose Add custom connector, name it Casafari, paste https://mcp.casafari.com/ as the URL, and connect. - [How do I connect Casafari MCP to ChatGPT?](https://platform.casafari.com/docs/faq/connect-chatgpt.md): In ChatGPT, turn on Developer mode, create a connector with https://mcp.casafari.com/ as the MCP server URL, choose OAuth, then sign in with your Casafari account and approve. - [How do I add Casafari MCP to Claude Code?](https://platform.casafari.com/docs/faq/connect-claude-code.md): Run claude mcp add --transport http casafari https://mcp.casafari.com/, then run /mcp in Claude Code and choose Authenticate for casafari. - [How do I add Casafari MCP to Cursor?](https://platform.casafari.com/docs/faq/connect-cursor.md): Add a casafari entry with the URL https://mcp.casafari.com/ under mcpServers in ~/.cursor/mcp.json, or in .cursor/mcp.json within a project. - [How do I add Casafari MCP to VS Code?](https://platform.casafari.com/docs/faq/connect-vscode.md): In .vscode/mcp.json, add a casafari server under servers with "type": "http" and the URL https://mcp.casafari.com/. - [How do I connect any other MCP client or my own agent?](https://platform.casafari.com/docs/faq/connect-other-client.md): Point the client at https://mcp.casafari.com/ and let it register itself and sign in with PKCE. - [How do I check that Casafari MCP is connected and working?](https://platform.casafari.com/docs/faq/verify-connection.md): Ask your assistant which Casafari products you can use: it should call list_servers and name the products your subscription covers. - [How does authentication work on Casafari MCP? Does it use OAuth scopes?](https://platform.casafari.com/docs/faq/how-authentication-works.md): Casafari MCP is an OAuth 2.1 resource server with no OAuth scopes: a token carries exactly the rights of the Casafari account that signed in. - [How does a client discover Casafari's authorization server?](https://platform.casafari.com/docs/faq/oauth-discovery.md): A client discovers it in two hops: the WWW-Authenticate header on a 401 response points to the protected resource metadata at https://mcp.casafari.com/.well-known/oauth-protected-resource, and that document points to the authorization server at… - [Can my MCP client register itself with Casafari?](https://platform.casafari.com/docs/faq/dynamic-client-registration.md): Yes, a client that acts for a signed-in person can register itself once at the registration endpoint; a client with no person to sign in cannot, and uses credentials Casafari issues instead. - [How does an agent sign in when no person is there to approve?](https://platform.casafari.com/docs/faq/unattended-agents.md): An agent that runs with no person present signs in with the client credentials grant, using a client_id and client_secret that Casafari issues for the account. - [What happens when my access token expires?](https://platform.casafari.com/docs/faq/token-expiry-refresh.md): When your access token expires, exchange the refresh token at the token endpoint with grant_type=refresh_token, your client_id, and resource; the expires_in value in the token response is the authoritative lifetime. - [How do I authenticate with the Casafari REST API?](https://platform.casafari.com/docs/faq/rest-authentication.md): Authenticate with the Casafari REST API by sending your email and password as JSON to POST https://api.casafari.com/login. - [What are Casafari MCP's rate limits and quotas?](https://platform.casafari.com/docs/faq/rate-limits-and-quotas.md): The documentation publishes no rate-limit or quota figures; the only documented limit is per product, and once a product's quota is used up, its tools return Request limit reached for this product. - [Why is a tool missing from `tools/list`, or a call refused?](https://platform.casafari.com/docs/faq/tool-missing-or-refused.md): If a tool is missing from tools/list or a call is refused, your account's subscription does not cover that tool, so retrying will not help. - [Which Casafari MCP errors should I retry, and which not?](https://platform.casafari.com/docs/faq/which-errors-to-retry.md): Retry only 5xx responses, using exponential backoff; every other documented error calls for a fix on your side, not a retry. - [How do I value a home or find comparables with Casafari MCP?](https://platform.casafari.com/docs/faq/example-valuation.md): To value a home or find comparables, ask your assistant for comparables around an address, 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://platform.casafari.com/docs/faq/example-price-trend.md): Resolve the place to a location id with ma_get_location_typeahead, fetch the series with ma_get_time_series_data, then calculate growth and volatility with ma_get_time_series_operations. - [How do I see how properties are distributed by price, bedrooms or time on market, or get a heatmap?](https://platform.casafari.com/docs/faq/example-distributions-heatmap.md): Area Insights has a tool for each distribution (ma_get_price_distribution, ma_get_bedrooms_distribution and ma_get_time_on_market_distribution) plus ma_get_heatmap, which shows a metric for each district. - [Can I build a market report with Casafari MCP?](https://platform.casafari.com/docs/faq/example-market-report.md): Yes: Casafari MCP supplies the figures and your assistant writes the report, though the hub documents tools, not report formats or exports. - [How do I find agencies or agents to partner with in a German city?](https://platform.casafari.com/docs/faq/example-find-agencies-germany.md): Use AgentGraph AI: 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://platform.casafari.com/docs/faq/example-property-lookup.md): Use the REST API: GET /api/v1/properties/search/{property_id} returns a single property with its history, and POST /api/v1/properties/match-by-listings resolves an ad id from a portal or agency to its property. - [How do I turn a place name into a location id?](https://platform.casafari.com/docs/faq/location-ids.md): Use ma_get_location_typeahead to turn an English place name into location ids. - [How do I get alerts delivered to a webhook?](https://platform.casafari.com/docs/faq/alerts-webhook.md): Use the REST API: create a feed with POST /alerts-api/feeds, set your webhook URL with PUT /alerts-api/webhooks, and rotate its signing secret with POST /alerts-api/webhooks/rotate-secret. - [How do I build my own application or agent on Casafari MCP?](https://platform.casafari.com/docs/faq/build-on-mcp.md): Connect to https://mcp.casafari.com/ over Streamable HTTP, complete OAuth 2.1 (discovery, registration, PKCE authorization, and token), then call list_servers and read each tool's schema in /tools.json. - [How do I build on the Casafari REST API?](https://platform.casafari.com/docs/faq/build-on-rest.md): The Casafari REST API lives at https://api.casafari.com. - [What is the Casafari property graph, and where does the data come from?](https://platform.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://platform.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://platform.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://platform.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://platform.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://platform.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://docs.api.casafari.com/llms.txt). - [How much does Casafari MCP cost?](https://platform.casafari.com/docs/faq/pricing.md): Casafari doesn't publish prices for Casafari MCP or the REST API. - [Is there an SLA, and what are the contract terms?](https://platform.casafari.com/docs/faq/sla-and-contract-terms.md): Casafari publishes no standard SLA or uptime figure: its Terms and Conditions allow service levels to be set for each customer in an Order Form, and its Terms of Use do not promise uninterrupted service. - [Can I read these docs as Markdown, and is there an llms.txt?](https://platform.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. ## Optional - [Full reference in one file](https://platform.casafari.com/llms-full.txt) - [All MCP tool schemas as JSON](https://platform.casafari.com/tools.json) - [MCP tool catalogue as OpenAPI](https://platform.casafari.com/mcp/openapi.json): the same tools, one POST path per tool - [Data Export description (OpenAPI, from the API team's docs)](https://docs.api.casafari.com/static/specs/data_export.openapi.json) - [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 - [REST API description (OpenAPI 3.1.0, from the API itself)](https://docs.api.casafari.com/openapi.json) - [How to obtain a credential](https://www.casafari.com/auth.md) - [MCP server card](https://mcp.casafari.com/.well-known/mcp/server-card.json)