Deweloperuch MCP

Estimate the value of a flat of a given area at a point (lat, lng) in Poland from nearby transaction prices of the Real Estate Price Register (RCN), via deweloperuch.pl. The result is approximate: a comparison with nearby sales, not a professional appraisal. Use it when the user asks what a flat may be worth or whether its price is market. Needs coordinates — it does not geocode an address: take them from the user, from deweloperuch_search_locations (a street or district: an approximate point) or from the user's own data. Every call is a request to the site: do not value many points in a series. Two kinds of prices must not be mixed: developers' asking prices (deweloperuch_search_investments, deweloperuch_get_investment, deweloperuch_get_offer, deweloperuch_get_market_statistics), RCN transaction prices (deweloperuch_estimate_property_value, deweloperuch_get_transaction_statistics, deweloperuch_rank_locations, deweloperuch_get_building) — what flats actually sold for, from the Real Estate Price Register. deweloperuch.pl is a free community project queried politely (one request at a time, results cached): if a result is an error starting with STOP, stop using the deweloperuch_* tools, retry nothing, look for no workaround and tell the user that market data is temporarily unavailable. Result shape: { lat, lng, area_m2, estimated_value (PLN, or null when the site gave no estimate — read the hint), low_confidence? (true when fewer than 5 comparable transactions: quote the estimate only as indicative, with the caveat from hint), price_per_m2?, radius_m?, period_months? (where and how long ago the comparables are from), stats?: { count, median_price_per_m2, average_price_per_m2, min_price_per_m2, max_price_per_m2 }, comparables_total, comparables_returned, comparables_omitted, truncated, hint?, source, comparables: [{ address?, date?, price, area_m2, price_per_m2, floor?, distance_m (rounded by the site to 50 m), market ('primary' | 'secondary'), building_slug? (for deweloperuch_get_building) }] } — the list key is `comparables`, the nearest first, at most `limit` of them (0 = only the estimate and stats). Do not assume estimated_value = price_per_m2 × area_m2: the site may ignore a fractional area.

A building of the Real Estate Price Register (RCN): address, coordinates, the site's average prices and the flats sold in it with the date, price, price per m², market, kind and parties of each transaction. These are the prices the flats sold for, not developers' asking prices. building_slug is the last part of the address of the building's page with transaction prices on deweloperuch.pl, e.g. 23-marca-79c-sopot — comparables of deweloperuch_estimate_property_value carry one in building_slug; when you have none, ask the user for the link of that page. building_url is that page. Order: the unit with the newest transaction first, each unit's transactions oldest first. Do not average transactions whose classification is not 'regular' (share, enforcement, discount…) with regular sales: they are not ordinary sales at a market price; non_regular_transactions counts them. Limits: buildings with flats only, not houses. Returns at most `limit` units (default 10); truncated and units_omitted say whether and how many were left out, units_total and transactions_total count the whole building. The newest months are often incomplete (the register lags). include_trend=true adds the mean price per m² of transactions around the building (radius radius_km) in the latest 12 quarters — one more request. Buyers and sellers appear only as a type, never by name. Two kinds of prices must not be mixed: developers' asking prices (deweloperuch_search_investments, deweloperuch_get_investment, deweloperuch_get_offer, deweloperuch_get_market_statistics), RCN transaction prices (deweloperuch_estimate_property_value, deweloperuch_get_transaction_statistics, deweloperuch_rank_locations, deweloperuch_get_building) — what flats actually sold for, from the Real Estate Price Register. deweloperuch.pl is a free community project queried politely (one request at a time, results cached): if a result is an error starting with STOP, stop using the deweloperuch_* tools, retry nothing, look for no workaround and tell the user that market data is temporarily unavailable. Fields ending in _url are pages of deweloperuch.pl: give them to the user as links. Result shape: { building_slug, name? (the address as the register writes it; absent when it gives none — the place is then in city), building_url, city, city_slug, street?, lat, lng, avg_price?, avg_area_m2?, avg_price_per_m2? (the site's averages; a value of 0 or less is omitted), first_transaction_date, last_transaction_date, units_total, transactions_total, non_regular_transactions? (e.g. { share: 1 }), units: [{ floor?, rooms?, area_m2, transactions: [{ date, price, price_per_m2, currency? (absent = PLN), market ('primary' | 'secondary'), classification ('regular' | 'share' | 'bulk' | 'government' | 'enforcement' | 'discount' | 'anomaly_low' | 'anomaly_high'), buyer, seller ('natural_person' | 'legal_person'), share? (only when a share was sold) }] }], units_returned, units_omitted, truncated, hint?, neighbourhood_trend?: { radius_km?, total, returned, truncated, quarters: [{ period, avg_price_per_m2?, transactions? }] }, source } — the list key is `units`.

An investment (developer project): city, street, coordinates, developer, the average prices of active offers, the number of offers and the list of offers (active first, then archived). Use it to see the flats of one project. investment_slug comes from deweloperuch_search_investments. investment_url and developer_url are the investment's and developer's pages on deweloperuch.pl: give them to the user as links. Limits: returns at most `limit` offers (default 20); offers_returned, truncated and offers_omitted say what was left out — offers_total is the site's count (also archived). With a large investment do not raise the limit without need. include_history=true adds the price history of every returned offer: the result is longer and takes one more request. For a single offer use deweloperuch_get_offer. These are developers' asking prices. Two kinds of prices must not be mixed: developers' asking prices (deweloperuch_search_investments, deweloperuch_get_investment, deweloperuch_get_offer, deweloperuch_get_market_statistics), RCN transaction prices (deweloperuch_estimate_property_value, deweloperuch_get_transaction_statistics, deweloperuch_rank_locations, deweloperuch_get_building) — what flats actually sold for, from the Real Estate Price Register. deweloperuch.pl is a free community project queried politely (one request at a time, results cached): if a result is an error starting with STOP, stop using the deweloperuch_* tools, retry nothing, look for no workaround and tell the user that market data is temporarily unavailable. Result shape: { investment_slug, name, status ('active' | 'archived'), investment_url?, city, city_slug, street?, lat?, lng?, currency?, developer: { developer_slug, name, website?, description? }, developer_url?, avg_price?, avg_area_m2?, avg_price_per_m2? (active offers, PLN), offers_active?, offers_total?, offers: [{ offer_id, name, status, price?, currency?, area_m2?, price_per_m2?, price_change_since_start? (PLN; negative = cheaper), price_change_since_start_pct?, creation_date?, last_event_date?, last_change_date?, price_history?: [{ date?, kind ('offer' | 'archived' | 'restored'), price? }] }], offers_returned, offers_omitted, truncated, source } — the list key is `offers`; `kind: offer` is every asking-price entry of the history, the first price and each change.

Statistics of the developers' offer market in one city: the number of offers, investments and developers, the distribution of prices (PLN), prices per m² (PLN/m²) and areas (m²) as min, p25, median, p75 and max, and the largest developers by number of offers (developer_slug, offers, investments, median_price_per_m2, developer_url; developer_slug is an identifier — the developer's name is not part of the result). Optionally only offers within a price and area range. Use it when the question is about a city's market (typical prices, who has the most offers), not about particular flats. Limits: active offers only (no archived) and one city only (city_slug from deweloperuch_search_locations; polska does not work). The figures are computed here from the site's compact list of the city's active offers (the list itself never leaves; Warsaw's is 1.3 MB, so a call can take a few seconds) and can differ slightly from the site's own offer totals. These are developers' asking prices, not transaction prices. Two kinds of prices must not be mixed: developers' asking prices (deweloperuch_search_investments, deweloperuch_get_investment, deweloperuch_get_offer, deweloperuch_get_market_statistics), RCN transaction prices (deweloperuch_estimate_property_value, deweloperuch_get_transaction_statistics, deweloperuch_rank_locations, deweloperuch_get_building) — what flats actually sold for, from the Real Estate Price Register. deweloperuch.pl is a free community project queried politely (one request at a time, results cached): if a result is an error starting with STOP, stop using the deweloperuch_* tools, retry nothing, look for no workaround and tell the user that market data is temporarily unavailable. Fields ending in _url are pages of deweloperuch.pl: give them to the user as links. Result shape: { city_slug, offers (matching active offers), investments, developers, price?, price_per_m2?, area_m2? (each { min, p25, median, p75, max }), top_developers: [{ developer_slug, offers, investments, median_price_per_m2?, developer_url? }], developers_returned, developers_omitted, truncated, hint? (also explains an empty result), list_url? (the same offers on deweloperuch.pl), source } — the list key is `top_developers`.

One offer with its full price history, investment and developer. Use it to see how a flat's asking price changed. Needs offer_id and investment_slug (both come from deweloperuch_get_investment; investment_slug also from deweloperuch_search_investments): offer_id alone is not enough. investment_url and developer_url are the investment's and developer's pages on deweloperuch.pl: give them to the user as links. price_flags (as of today; prices from `offer` and `restored` events, a withdrawal ends the price in effect; an archived offer is judged up to the day it was withdrawn): lowest_price_30d and lowest_price_90d are the lowest price in effect over the last 30 and 90 days, including one set before the window; price_changes is the number of price changes; largest_drop_pct and largest_rise_pct are the largest single drop and rise as a % of the previous price; suspicious_reduction=true when the latest drop came within 30 days after a rise and the new price is not below the lowest of the 30 days before it (a 'promotion' after a price increase). These are developers' asking prices, not transaction prices. Two kinds of prices must not be mixed: developers' asking prices (deweloperuch_search_investments, deweloperuch_get_investment, deweloperuch_get_offer, deweloperuch_get_market_statistics), RCN transaction prices (deweloperuch_estimate_property_value, deweloperuch_get_transaction_statistics, deweloperuch_rank_locations, deweloperuch_get_building) — what flats actually sold for, from the Real Estate Price Register. deweloperuch.pl is a free community project queried politely (one request at a time, results cached): if a result is an error starting with STOP, stop using the deweloperuch_* tools, retry nothing, look for no workaround and tell the user that market data is temporarily unavailable. Result shape: { offer_id, name, status ('active' | 'archived'), price? (PLN, asking), currency?, area_m2?, price_per_m2?, price_change_since_start? (PLN; negative = cheaper), price_change_since_start_pct?, creation_date?, last_event_date?, last_change_date?, investment_slug, investment_name, investment_url?, city, city_slug, developer: { developer_slug, name, website?, description? }, developer_url?, price_history: [{ date?, kind ('offer' | 'archived' | 'restored'), price? }], price_flags: { lowest_price_30d?, lowest_price_90d?, price_changes, largest_drop_pct?, largest_rise_pct?, suspicious_reduction }, source } — the list key is `price_history`, oldest first. A flag with no basis (no drop yet) is omitted.

Transaction prices of flats in one city from the Real Estate Price Register (RCN), month by month or quarter by quarter: the number of transactions and the prices per m². These are prices flats actually sold for, not developers' asking prices. granularity=month (default): median and mean price per m², median area and median flat price. granularity=quarter: only the mean price per m² and the count, but a longer history. Months and quarters are different statistics: do not join them in one chart or series. Limits: flats only and whole cities only (city_slug from deweloperuch_search_locations; no districts, streets or whole Poland). Default: the latest 12 periods; truncated=true means older ones exist (raise periods, at most 60). The newest periods are incomplete (the RCN lags by months): skip a period with incomplete=true — do not quote its prices as a trend — and end a trend at last_complete_period (even its data may still change). Two kinds of prices must not be mixed: developers' asking prices (deweloperuch_search_investments, deweloperuch_get_investment, deweloperuch_get_offer, deweloperuch_get_market_statistics), RCN transaction prices (deweloperuch_estimate_property_value, deweloperuch_get_transaction_statistics, deweloperuch_rank_locations, deweloperuch_get_building) — what flats actually sold for, from the Real Estate Price Register. deweloperuch.pl is a free community project queried politely (one request at a time, results cached): if a result is an error starting with STOP, stop using the deweloperuch_* tools, retry nothing, look for no workaround and tell the user that market data is temporarily unavailable. Fields ending in _url are pages of deweloperuch.pl: give them to the user as links. Result shape: { city_slug, granularity, total, returned, truncated, available_from, last_complete_period?, hint?, note, stats_url, source, periods: [{ period ('2025-08' | '2025-Q3'), transactions, incomplete? (only when true), median_price_per_m2?, average_price_per_m2?, median_area_m2?, median_price? }] } — the list key is `periods`, oldest first; a period without transactions has no prices. last_complete_period is omitted when the history is too short or has too few transactions to judge; then read hint. Read `note` before describing a trend.

A ranking of localities (level=city) or powiats (level=powiat) in Poland by Real Estate Price Register (RCN) transactions: the number of transactions and the transaction price per m². Use it to compare many cities; for the trend of one city over time use deweloperuch_get_transaction_statistics. These are transaction prices, not asking prices. Limits: the site gives no period and does not say whether prices and areas are means or medians — present them as the values the site gives. Powiat transaction counts cover many years: they only order the list, are not the current volume and must not be compared with locality counts. Sorting by price leaves out places with fewer than 20 transactions by default (a price from a handful of sales is chance); min_transactions=0 shows all places, 50 gives steadier prices. Two kinds of prices must not be mixed: developers' asking prices (deweloperuch_search_investments, deweloperuch_get_investment, deweloperuch_get_offer, deweloperuch_get_market_statistics), RCN transaction prices (deweloperuch_estimate_property_value, deweloperuch_get_transaction_statistics, deweloperuch_rank_locations, deweloperuch_get_building) — what flats actually sold for, from the Real Estate Price Register. deweloperuch.pl is a free community project queried politely (one request at a time, results cached): if a result is an error starting with STOP, stop using the deweloperuch_* tools, retry nothing, look for no workaround and tell the user that market data is temporarily unavailable. Fields ending in _url are pages of deweloperuch.pl: give them to the user as links. Result shape: { level, sort, min_transactions (the threshold applied), total (places with at least that many transactions), returned, truncated, hint?, ranking_url? (city level), source, items: [{ name, city_slug? (city) | powiat_id? (informational: no tool takes it), transaction_count, price_per_m2?, area_m2?, price? }] } — the list key is `items`. A place without a price has no price fields and sorts last by price.

Find developers (primary market) by a fragment of the name, e.g. atal or dom development. Use it to turn a developer's name into the developer_slug that deweloperuch_search_investments takes (with city) to list that developer's investments. Returns no offers or prices. truncated=true means more developers match than shown: refine the name or raise limit (at most 20); total is null when it is only known that there are more. deweloperuch.pl is a free community project queried politely (one request at a time, results cached): if a result is an error starting with STOP, stop using the deweloperuch_* tools, retry nothing, look for no workaround and tell the user that market data is temporarily unavailable. Fields ending in _url are pages of deweloperuch.pl: give them to the user as links. Result shape: { total: number | null, returned, truncated, hint?, items: [{ developer_slug, name, offer_count? (the site's count of the developer's offers across Poland), developer_url? }] } — the list key is `items`. developer_url is the developer's profile for the whole of Poland on deweloperuch.pl.

Search investments (developer projects, primary market). Two modes: with city (full data) or with name alone (whole Poland; only investment_slug, name and offers_active, in the site's order). Use it when the question is about projects rather than single flats: e.g. the cheapest per m² in a city, the investments of one developer (city + developer_slug from deweloperuch_search_developers), the slug of an investment by its name. With city it returns the investments the site shows on the city's map (those with active offers; ones without may be missing) with averages over active offers; name and developer_slug narrow the list, sort orders it (default: most active offers; entries without an average come last). Offers and details of one investment come from deweloperuch_get_investment (investment_slug); a particular offer's price history from deweloperuch_get_offer. No price or area filter here — for those ranges use deweloperuch_get_market_statistics. city=polska does not work. These are developers' asking prices. Two kinds of prices must not be mixed: developers' asking prices (deweloperuch_search_investments, deweloperuch_get_investment, deweloperuch_get_offer, deweloperuch_get_market_statistics), RCN transaction prices (deweloperuch_estimate_property_value, deweloperuch_get_transaction_statistics, deweloperuch_rank_locations, deweloperuch_get_building) — what flats actually sold for, from the Real Estate Price Register. deweloperuch.pl is a free community project queried politely (one request at a time, results cached): if a result is an error starting with STOP, stop using the deweloperuch_* tools, retry nothing, look for no workaround and tell the user that market data is temporarily unavailable. Fields ending in _url are pages of deweloperuch.pl: give them to the user as links. Result shape: { total: number | null (null when the site does not say — a search by name), returned, truncated, hint?, source, items: [with city: { investment_slug, name, city_slug?, district?, street?, status? ('active' | 'archived'), offers_active?, offers_total?, avg_price?, avg_area_m2?, avg_price_per_m2? (active offers only, as the site counts them), developer_slug?, developer_name?, investment_url?, developer_url? } | by name: { investment_slug, name, offers_active? }] } — the list key is `items`.

Find cities, districts and streets in Poland by a fragment of the name. Use it first, to turn a place name into the city_slug the other deweloperuch_* tools take (and the lat/lng of a street or district for deweloperuch_estimate_property_value — an approximate point, not a particular building). Returns no prices. A locality with offer_count 0 has no developer offers. Costs two requests to deweloperuch.pl. deweloperuch.pl is a free community project queried politely (one request at a time, results cached): if a result is an error starting with STOP, stop using the deweloperuch_* tools, retry nothing, look for no workaround and tell the user that market data is temporarily unavailable. Result shape: { total: number | null, returned, truncated, hint?, items: [{ kind: 'city' | 'district' | 'street', name, city, city_slug, district?, street?, lat?, lng?, offer_count? }] } — the list key is `items`. `total` is null when more match than shown (truncated=true: refine the name). `offer_count` is the site's count of developer offers (exact for districts, approximate for streets and cities). A district or street carries the city_slug of its city (this server's tools have no district filter). Nothing matching is not an error: returned=0 with a hint.