Area Insights · MCP-Tool
area-insights_get_heatmap
Get Heatmap
Call it as area-insights_get_heatmap on the Area Insights MCP server, https://platform.casafari.com/mcp/area-insights (how to connect).
Over REST: POST /v1/area-insights/heatmap (equivalent). MCP and REST compared.
What does Get Heatmap do?
Generate an area insights heatmap showing property distribution and price dynamics across geographic areas.
This tool aggregates active real estate listings for the child locations of the given location_id
(e.g., districts of a city), returning the selected data_point metric for each of them.
It supports a wide range of property filters, including estate type, price range,
construction year, and location hierarchy.
Use Cases
Retrieve geographic insights for real estate analytics:
- Visualize market activity intensity across a city or region.
- Identify hotspots of high property density or high average price.
- Compare neighborhoods based on average price per sqm.
- Analyze supply distribution and property trends over time.
- Combine with time-series data to understand historical evolution by area.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
request_data | MCPHeatMapRequestSchema | Yes | Defines filters, metrics, and date range for heatmap generation. |
Important Notes
- Only ACTIVE listings are included.
- The tool automatically resolves child locations (e.g., neighborhoods within a city).
- If no matching data is found, a
ToolErrorwill be raised. - Use returned data for map visualization or spatial analytics dashboards.
Returns
[
{
"location_id": 12345,
"location_name": "Lisbon",
"value": 5200.5
}
]Each item represents one geographic unit with aggregated metric value.
Which parameters does area-insights_get_heatmap take?
request_dataobjecterforderlich19 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_outliersbooleanlocation_idintegererforderlichdata_pointZeichenfolgeerforderlichavg_price avg_price_psqm available_on_market new sold_or_rented price_up price_downdate_rangeobjecterforderlich2 Eigenschaften
minstring (Datum)erforderlichYYYY-MM-DD. If the specified date is not Monday - the closest previous Monday will be selectedmaxstring (Datum)kann null seinYYYY-MM-DD. If the specified date is not Sunday - the closest previous Sunday will be selectedWas wird zurückgegeben?
Returned as result.
Antwortstruktur anzeigen (3 Felder)
location_idintegererforderlichlocation_nameZeichenfolgeerforderlichvaluenumbererforderlichHow do I call area-insights_get_heatmap?
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_heatmap",
"arguments": {
"request_data": {
"type_group": "apartment",
"business_type": "sale",
"location_id": 544116,
"data_point": "avg_price_psqm",
"date_range": {
"min": "2025-01-01",
"max": "2025-12-31"
}
}
}
}
}