Area Insights · MCP tool
ma_get_price_distribution
Get Price Distribution
Read-only42 parametersTyped response
Over REST: POST /market-analytics-api/distributions/prices (equivalent). MCP and REST compared.
Description
Returns a distribution of property prices based on the provided filters. Each record represents a price interval and the number of properties within that interval.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
request_data | MCPPriceDistributionRequestSchema | Yes | Configuration for price distribution filtering. |
Filter highlights
type_group: group of estate types (e.g., apartment, house)business_type:"sale"or"rent"price_range: numeric price range filterexclude_outliers: optional flag to exclude statistical outliers
Returns
[
{
"lower_bound": 100000,
"upper_bound": 150000,
"properties_count": 42,
"is_mean": false
}
]| Field | Type | Description |
|---|---|---|
lower_bound | int | Lower price boundary |
upper_bound | int | Upper price boundary |
properties_count | int | Number of properties in the range |
is_mean | bool | Indicates whether the range includes the mean price |
Example Request
{
"custom_location_boundary": {
"circle": {
"target_point": {"latitude": 48.8566, "longitude": 2.3522},
"distance": 10000
}
},
"type_group": "apartment",
"business_type": "sale",
"price_range": {"min": 100000, "max": 500000},
"exclude_outliers": true
}Parameters
request_dataobjectrequired17 properties
type_groupstringrequiredEstate type group.
apartment housebusiness_typestringrequiredOperation type for which the property is available.
sale rentprice_rangeobjectnullable2 properties
minintegernullable1–2147483647
maxintegernullable1–2147483647
price_per_sqm_rangeobjectnullable2 properties
minintegernullable1–2147483647
maxintegernullable1–2147483647
rooms_rangeobjectnullable2 properties
minintegernullable1–15000
maxintegernullable1–15000
bedrooms_rangeobjectnullable2 properties
minintegernullable0–15000
maxintegernullable0–15000
bathrooms_rangeobjectnullable2 properties
minintegernullable1–15000
maxintegernullable1–15000
total_area_rangeobjectnullable2 properties
minintegernullable1–1000000
maxintegernullable1–1000000
plot_area_rangeobjectnullable2 properties
minintegernullable1–1000000
maxintegernullable1–1000000
construction_year_rangeobjectnullable2 properties
minintegernullable1–3000
maxintegernullable1–3000
characteristicsobjectnullable2 properties
must_havestring[]Include only properties that have all these characteristics.
balcony elevator no_elevator garage garden parking storage swimming_pool terrace rental_license furniture rented_out life_annuityexcludestring[]Exclude properties that contain any of these characteristics.
balcony elevator no_elevator garage garden parking storage swimming_pool terrace rental_license furniture rented_out life_annuityconditionsstring[]Property conditions, as returned by the GET /api/v1/references/conditions endpoint.
used ruin very-good new otherat least 1 item
privatebooleanWhether the property is listed by a private individual, as opposed to an agent or a professional.
bankbooleanWhether the property is owned by the bank.
auctionbooleanWhether the property is the subject of an auction.
default false
exclude_outliersbooleanExclude properties that are significantly underpriced or overpriced compared to similar properties.
default true
custom_location_boundaryobjectrequired2 properties
location_idsinteger[]List of location IDs.
1–10 items1–2147483647
circleobjectCircle boundary to search within.
2 properties
distanceintegerrequiredMaximum distance in meters from the requested
target_point to the properties.50–50000
target_pointobjectrequiredTarget point coordinates to search around.
2 properties
latitudenumberrequired-90–90
longitudenumberrequired-180–180
Response
Returned as result.
Show the response shape (4 fields)
lower_boundintegerrequiredThe lower price bound of the distribution unit.
upper_boundintegerrequiredThe upper price bound of the distribution unit.
properties_countintegerrequiredThe number of properties that participated in the distribution.
is_meanbooleanrequiredIndicates whether the mean value is within this distribution unit.
Example call
Required arguments only, with placeholder values. Your assistant fills them in from the parameters above.
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "ma_get_price_distribution",
"arguments": {
"request_data": {
"type_group": "apartment",
"business_type": "sale",
"custom_location_boundary": {
"location_ids": [
1
]
}
}
}
}
}