Area Insights · MCP-Tool
area-insights_get_time_series_data
Get Time Series Data
Call it as area-insights_get_time_series_data on the Area Insights MCP server, https://platform.casafari.com/mcp/area-insights (how to connect).
Over REST: POST /v1/area-insights/time-series (equivalent), POST /market-analytics-api/time-series (equivalent). MCP and REST compared.
What does Get Time Series Data do?
Retrieve time series data for the real estate market.
Each data point in the series represents an aggregated metric (data_point) for a specific period,
defined by the chosen date_interval and property filters.
This tool provides consistent, interval-based historical data for various real estate indicators.
Use Cases
Retrieve historical market information, such as:
- Average property prices.
- Average price per square meter.
- Number of properties sold or rented over time.
- Number of newly listed properties.
- Number of properties available on the market.
- Number of price increases or decreases for listings.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
request_data | MCPTimeSeriesRequestSchema | Yes | Defines filters, time interval, and data metric (data_point) for aggregation. |
Filter highlights
data_point: defines which metric to retrieve (e.g. price, listings, sold count, etc.).date_interval: defines the frequency of data points in the response (WEEK,MONTH,QUARTER,YEAR).custom_location_boundary: spatial boundary (circle or list of location IDs).type_group: group of property types to analyze.business_type:"sale"or"rent".exclude_outliers: optionally exclude statistical outliers from the results.- optional property filters: price range, area, bedrooms, bathrooms, etc.
Important Notes
- If you need to compare different property types, send separate requests for each type group.
- For broader analyses, prefer using
AVERAGE_PRICE_PER_SQMover total price. - You can reuse the same filters with different
data_pointvalues to analyze multiple aspects of the market (e.g. compare new listings vs. sold properties). - Use the
exclude_outliersflag to remove extreme values and improve analytical accuracy.
Returns
[
{
"date_start": "2024-01-01",
"value": 4350.5
}
]Which parameters does area-insights_get_time_series_data take?
request_dataobjecterforderlich21 properties
type_groupZeichenfolgeerforderlichapartment housebusiness_typeZeichenfolgeerforderlichsale rentprice_rangeobjectkann null sein2 Eigenschaften
minintegerkann null seinmaxintegerkann null seinprice_per_sqm_rangeobjectkann null sein2 Eigenschaften
minintegerkann null seinmaxintegerkann null seinrooms_rangeobjectkann null sein2 Eigenschaften
minintegerkann null seinmaxintegerkann null seinbedrooms_rangeobjectkann null sein2 Eigenschaften
minintegerkann null seinmaxintegerkann null seinbathrooms_rangeobjectkann null sein2 Eigenschaften
minintegerkann null seinmaxintegerkann null seintotal_area_rangeobjectkann null sein2 Eigenschaften
minintegerkann null seinmaxintegerkann null seinplot_area_rangeobjectkann null sein2 Eigenschaften
minintegerkann null seinmaxintegerkann null seinconstruction_year_rangeobjectkann null sein2 Eigenschaften
minintegerkann null seinmaxintegerkann null seincharacteristicsobjectkann null sein2 Eigenschaften
must_havestring[]balcony elevator no_elevator garage garden parking storage swimming_pool terrace rental_license furniture rented_out life_annuityexcludestring[]balcony elevator no_elevator garage garden parking storage swimming_pool terrace rental_license furniture rented_out life_annuityconditionsstring[]used ruin very-good new otherprivatebooleanbankbooleanauctionbooleanexclude_outliersbooleanaliasZeichenfolgeerforderlichcustom_location_boundaryobjecterforderlich2 Eigenschaften
location_idsinteger[]circleobject2 Eigenschaften
distanceintegererforderlichtarget_point zu den Immobilien.target_pointobjecterforderlich2 Eigenschaften
latitudenumbererforderlichlongitudenumbererforderlichdata_pointZeichenfolgeerforderlichavg_price avg_price_psqm available_on_market new sold_or_rented price_up price_downdate_intervalZeichenfolgeerforderlichweek month quarter yeardate_rangeobjecterforderlich2 Eigenschaften
minstring (Datum)erforderlichYYYY-MM-DD. If the specified date is not Monday - the closest previous Monday will be selected.maxstring (Datum)kann null seinYYYY-MM-DD. If the specified date is not Sunday - the closest previous Sunday will be selected.Was wird zurückgegeben?
Returned as result.
Antwortstruktur anzeigen (2 Felder)
date_startstring (Datum)erforderlichdate_interval field value. The format follows YYYY-MM-DD.valuenumbererforderlichdata_point field value for the given date_start.How do I call area-insights_get_time_series_data?
Ein Beispiel, das vor der Veröffentlichung auf der Plattform ausgeführt wurde: Es funktioniert so wie es ist. Ihr Assistent füllt Ihre eigenen Werte basierend auf den oben genannten Parametern aus.
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "area-insights_get_time_series_data",
"arguments": {
"request_data": {
"type_group": "apartment",
"business_type": "sale",
"custom_location_boundary": {
"location_ids": [
544116
]
},
"alias": "Berlin",
"data_point": "avg_price_psqm",
"date_interval": "quarter",
"date_range": {
"min": "2024-01-01",
"max": "2025-12-31"
}
}
}
}
}