# Area Insights

> **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 its full price and market history. [How the property graph is built](/docs/property-graph).

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.

## How the MCP server describes itself

What `list_servers` returns for this product (the server's own `initialize` instructions):

> Server provides functionality to analyze real estate market.

## MCP tools

| Tool | Title | What it does |
|---|---|---|
| [`ma_get_current_datetime`](/docs/area-insights/get_current_datetime) | Get Current Datetime | Returns the current system date and time. |
| [`ma_get_time_series_data`](/docs/area-insights/get_time_series_data) | Get Time Series Data | Retrieve time series data for the real estate market. |
| [`ma_get_time_series_operations`](/docs/area-insights/get_time_series_operations) | 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… |
| [`ma_get_price_distribution`](/docs/area-insights/get_price_distribution) | Get Price Distribution | Returns a distribution of property prices based on the provided filters. |
| [`ma_get_bedrooms_distribution`](/docs/area-insights/get_bedrooms_distribution) | Get Bedrooms Distribution | Returns a distribution of properties grouped by the number of bedrooms. |
| [`ma_get_time_on_market_distribution`](/docs/area-insights/get_time_on_market_distribution) | Get Time on Market Distribution | Returns a distribution of properties by their time on the market, grouped by price intervals. |
| [`ma_get_heatmap`](/docs/area-insights/get_heatmap) | Get Heatmap | Generate an area insights heatmap showing property distribution and price dynamics across geographic areas. |
| [`ma_get_location_typeahead`](/docs/area-insights/get_location_typeahead) | Get Location Typeahead | Retrieve typeahead suggestions for a given location name. |

## REST API

6 operations in the public OpenAPI description, all under `https://api.casafari.com` with a bearer token ([how to get one](/docs/rest#get-a-token)). The same list with more detail: [Area Insights REST API](/docs/rest/area-insights).

### Time Series

- [`POST /market-analytics-api/time-series`](/docs/rest/area-insights/time-series): Time Series. Returns time series data for the real estate market.

### Distributions

Paths under `/market-analytics-api/distributions`.

- [`POST /market-analytics-api/distributions/bedrooms`](/docs/rest/area-insights/bedrooms-distribution): Bedrooms Distribution. Returns property distribution based on the number of bedrooms.
- [`POST /market-analytics-api/distributions/prices`](/docs/rest/area-insights/price-distribution): Price Distribution. Returns the number of properties distributed across price ranges.
- [`POST /market-analytics-api/distributions/properties`](/docs/rest/area-insights/properties-distribution): Properties Distribution. Returns the properties lightweight data sample and distribution quartiles.
- [`POST /market-analytics-api/distributions/time-on-market`](/docs/rest/area-insights/time-on-market-distribution): Time On Market Distribution. Returns time on market (days and months) distribution by price ranges.

### Analysis

- [`POST /market-analytics-api/analysis`](/docs/rest/area-insights/analysis): Analysis. Market analysis based on the requested property parameters.

## MCP and REST compared

Over MCP: 8 tools. Over REST: 6 operations. Available over both.

- Equivalent: [`ma_get_time_series_data`](/docs/area-insights/get_time_series_data) and [`POST /market-analytics-api/time-series`](/docs/rest/area-insights/time-series).
- Equivalent: [`ma_get_price_distribution`](/docs/area-insights/get_price_distribution) and [`POST /market-analytics-api/distributions/prices`](/docs/rest/area-insights/price-distribution).
- Equivalent: [`ma_get_bedrooms_distribution`](/docs/area-insights/get_bedrooms_distribution) and [`POST /market-analytics-api/distributions/bedrooms`](/docs/rest/area-insights/bedrooms-distribution).
- Equivalent: [`ma_get_time_on_market_distribution`](/docs/area-insights/get_time_on_market_distribution) and [`POST /market-analytics-api/distributions/time-on-market`](/docs/rest/area-insights/time-on-market-distribution).
- Related: [`ma_get_location_typeahead`](/docs/area-insights/get_location_typeahead) and [`POST /api/v1/references/locations/typeahead`](/docs/rest/references/get-locations-typeahead-suggestions-scoped-by-country-code-v1).

Only over MCP: [`ma_get_current_datetime`](/docs/area-insights/get_current_datetime), [`ma_get_time_series_operations`](/docs/area-insights/get_time_series_operations), [`ma_get_heatmap`](/docs/area-insights/get_heatmap).

Only over REST: [`POST /market-analytics-api/distributions/properties`](/docs/rest/area-insights/properties-distribution), [`POST /market-analytics-api/analysis`](/docs/rest/area-insights/analysis).

Details: [MCP and REST compared](/docs/parity#area-insights).

## Ask your assistant

> How has the asking price per m² of flats in Valencia moved over the last three years?

## Questions about this

- [What is Casafari MCP?](/docs/faq/what-is-casafari-mcp)
- [Does Casafari cover Spain and Portugal?](/docs/faq/coverage-spain-portugal)
- [Which products does Casafari MCP offer, and how many tools are there?](/docs/faq/which-products)
- [What is Area Insights?](/docs/faq/what-is-area-insights)
- [How do I analyse how prices in an area have moved over time?](/docs/faq/example-price-trend)