ceny-nieruchomosci-mcp

Actual sale prices of flats, houses or building plots near a place in Poland, from notarial deeds (official Rejestr Cen Nieruchomości). Returns median price per m², interquartile range, typical total price and area, breakdown by rooms, yearly trend and recent transactions. place: address "Poznań, Garbary 10", street "Kraków, Długa", town "Swarzędz" or "lat,lon".

{
  "type": "object",
  "properties": {
    "place": {
      "type": "string",
      "description": "Address, street, town or 'lat,lon' in Poland"
    },
    "kind": {
      "type": "string",
      "enum": [
        "flat",
        "house",
        "plot"
      ],
      "description": "flat = mieszkanie (default), house = dom, plot = działka niezabudowana"
    },
    "radius_m": {
      "type": "integer",
      "minimum": 100,
      "maximum": 1500,
      "description": "Search radius in metres (default 500 for flats, 1500 for houses/plots)"
    },
    "months": {
      "type": "integer",
      "minimum": 1,
      "maximum": 120,
      "description": "Look back this many months (default 24)"
    },
    "rooms": {
      "type": "integer",
      "minimum": 1,
      "maximum": 5,
      "description": "Only flats with this many rooms (5 = 5+)"
    },
    "min_area": {
      "type": "number",
      "description": "Minimum area m²"
    },
    "max_area": {
      "type": "number",
      "description": "Maximum area m²"
    },
    "market": {
      "type": "string",
      "enum": [
        "any",
        "primary",
        "secondary"
      ],
      "description": "primary = od dewelopera, secondary = rynek wtórny (when recorded)"
    },
    "examples": {
      "type": "integer",
      "minimum": 0,
      "maximum": 25,
      "description": "How many recent transactions to list (default 8)"
    }
  },
  "required": [
    "place"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Everything public about one land parcel (działka) in Poland: parcel id, area and land-use class from the land register (EGiB), local zoning plan (MPZP) and zoning symbol, utility networks on or near the plot (water, sewer, gas, power, heat, telecom – GESUT), flood hazard (ISOK maps), nature protection areas (GDOŚ) and plot prices nearby (RCN). query: parcel id "302109_4.0001.100", "obręb number" like "Bnin 100" or "obręb Bnin działka 100 gmina Kórnik", an address "Kórnik, Poznańska 1" (the parcel under the address point) or "lat,lon".

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Parcel id, 'obręb number', address or 'lat,lon'"
    },
    "commune": {
      "type": "string",
      "description": "Gmina / powiat name to pick the right parcel when 'obręb number' matches several"
    },
    "prices": {
      "type": "boolean",
      "description": "Include plot prices nearby (default true)"
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Resolve a Polish address, street or town to coordinates using the official address register (GUGiK). Useful to check which place property_prices will use.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "e.g. 'Gdańsk, Długa 5'"
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Where the data comes from, licence and caveats.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}