@cenogram/mcp-server 0.1.2 → 0.1.3

package/dist/api-client.d.ts

@@ -103,6 +103,9 @@ export interface TransactionParams {
     parcelId?: string;
     propertyType?: number;
     marketType?: number;
+    unitFunction?: number;
+    buildingType?: number;
+    mpzpDesignation?: string;
     minPrice?: number;
     maxPrice?: number;
     dateFrom?: string;
@@ -138,6 +141,9 @@ export interface SpatialSearchParams {
     };
     propertyType?: number;
     marketType?: number;
+    unitFunction?: number;
+    buildingType?: number;
+    mpzpDesignation?: string;
     minPrice?: number;
     maxPrice?: number;
     dateFrom?: string;
@@ -192,6 +198,9 @@ export interface CompareParams {
     districts: string;
     propertyType?: number;
     marketType?: number;
+    unitFunction?: number;
+    buildingType?: number;
+    mpzpDesignation?: string;
     minPrice?: number;
     maxPrice?: number;
     dateFrom?: string;

package/dist/api-client.js

@@ -95,6 +95,9 @@ export function getTransactions(p, apiKey) {
         parcelId: p.parcelId,
         propertyType: p.propertyType,
         marketType: p.marketType,
+        unitFunction: p.unitFunction,
+        buildingType: p.buildingType,
+        mpzpDesignation: p.mpzpDesignation,
         minPrice: p.minPrice,
         maxPrice: p.maxPrice,
         dateFrom: p.dateFrom,
@@ -114,6 +117,9 @@ export function getTransactionsSummary(p, apiKey) {
         street: p.street,
         propertyType: p.propertyType,
         marketType: p.marketType,
+        unitFunction: p.unitFunction,
+        buildingType: p.buildingType,
+        mpzpDesignation: p.mpzpDesignation,
         minPrice: p.minPrice,
         maxPrice: p.maxPrice,
         dateFrom: p.dateFrom,
@@ -141,6 +147,12 @@ export function searchByPolygon(p, apiKey) {
         body.propertyType = p.propertyType;
     if (p.marketType != null)
         body.marketType = p.marketType;
+    if (p.unitFunction != null)
+        body.unitFunction = p.unitFunction;
+    if (p.buildingType != null)
+        body.buildingType = p.buildingType;
+    if (p.mpzpDesignation)
+        body.mpzpDesignation = p.mpzpDesignation;
     if (p.minPrice != null)
         body.minPrice = p.minPrice;
     if (p.maxPrice != null)
@@ -166,6 +178,9 @@ export function compareLocations(p, apiKey) {
         districts: p.districts,
         propertyType: p.propertyType,
         marketType: p.marketType,
+        unitFunction: p.unitFunction,
+        buildingType: p.buildingType,
+        mpzpDesignation: p.mpzpDesignation,
         minPrice: p.minPrice,
         maxPrice: p.maxPrice,
         dateFrom: p.dateFrom,

package/dist/mappings.d.ts

@@ -2,6 +2,10 @@ export declare const PROPERTY_TYPES: Record<number, string>;
 export declare const MARKET_TYPES: Record<number, string>;
 export declare function mapPropertyType(value: string | undefined): number | undefined;
 export declare function mapMarketType(value: string | undefined): number | undefined;
+export declare const UNIT_FUNCTIONS: Record<number, string>;
+export declare function mapUnitFunction(value: string | undefined): number | undefined;
+export declare const BUILDING_TYPES: Record<number, string>;
+export declare function mapBuildingType(value: string | undefined): number | undefined;
 /** Convert lat/lng/radius to bbox [minLng, minLat, maxLng, maxLat] (lng-first!) */
 export declare function radiusKmToBbox(lat: number, lng: number, radiusKm: number): [number, number, number, number];
 /** Filter districts by location name (case-insensitive includes match) */

package/dist/mappings.js

@@ -29,6 +29,58 @@ export function mapMarketType(value) {
         return undefined;
     return MARKET_TYPE_MAP[value];
 }
+// ── Unit function enum maps ─────────────────────────────────────────
+export const UNIT_FUNCTIONS = {
+    1: "Residential (Mieszkalna)",
+    2: "Commercial (Handlowo-usługowa)",
+    3: "Office (Biurowa)",
+    4: "Production (Produkcyjna)",
+    5: "Garage (Garaż)",
+    6: "Other (Inne)",
+};
+const UNIT_FUNCTION_MAP = {
+    residential: 1,
+    commercial: 2,
+    office: 3,
+    production: 4,
+    garage: 5,
+    other: 6,
+};
+export function mapUnitFunction(value) {
+    if (!value)
+        return undefined;
+    return UNIT_FUNCTION_MAP[value];
+}
+// ── Building type enum maps ─────────────────────────────────────────
+export const BUILDING_TYPES = {
+    110: "Residential (Mieszkalny)",
+    121: "Commercial (Handlowo-usługowy)",
+    122: "Industrial (Przemysłowy)",
+    123: "Transport (Transportu i łączności)",
+    124: "Office (Biurowy)",
+    125: "Warehouse (Zbiorniki/Silosy/Magazyny)",
+    126: "Education/Sports (Oświaty i sportu)",
+    127: "Farm/Utility (Gospodarczy)",
+    128: "Hospital (Szpitale)",
+    129: "Other non-residential (Pozostałe niemieszkalne)",
+};
+const BUILDING_TYPE_MAP = {
+    residential: 110,
+    commercial: 121,
+    industrial: 122,
+    transport: 123,
+    office: 124,
+    warehouse: 125,
+    education_sports: 126,
+    farm_utility: 127,
+    hospital: 128,
+    other_nonresidential: 129,
+};
+export function mapBuildingType(value) {
+    if (!value)
+        return undefined;
+    return BUILDING_TYPE_MAP[value];
+}
 // ── Bbox conversion ─────────────────────────────────────────────────
 /** Convert lat/lng/radius to bbox [minLng, minLat, maxLng, maxLat] (lng-first!) */
 export function radiusKmToBbox(lat, lng, radiusKm) {

package/dist/tools.js

@@ -1,7 +1,7 @@
 import { z } from "zod";
 import { getStats, getTransactions, getPricePerM2, getDistricts, getPriceHistogram, getTransactionsSummary, searchParcels, searchByPolygon, compareLocations, } from "./api-client.js";
 import { formatTransactionList, formatMarketOverview, formatPriceStats, formatHistogram, formatParcelResults, formatSpatialResults, formatCompareResults, } from "./formatters.js";
-import { mapPropertyType, mapMarketType, radiusKmToBbox, filterByLocation, } from "./mappings.js";
+import { mapPropertyType, mapMarketType, mapUnitFunction, mapBuildingType, radiusKmToBbox, filterByLocation, } from "./mappings.js";
 // ── Helpers ─────────────────────────────────────────────────────────
 function textResponse(text) {
     return { content: [{ type: "text", text }] };
@@ -37,6 +37,12 @@ Example: search for apartments in Mokotów sold in 2024 above 500,000 PLN.`, {
             .describe("Property type filter"),
         marketType: z.enum(["primary", "secondary"]).optional()
             .describe("Market type: primary (developer) or secondary (resale)"),
+        unitFunction: z.enum(["residential", "commercial", "office", "production", "garage", "other"]).optional()
+            .describe("Unit/apartment function filter"),
+        buildingType: z.enum(["residential", "commercial", "industrial", "transport", "office", "warehouse", "education_sports", "farm_utility", "hospital", "other_nonresidential"]).optional()
+            .describe("Building type filter (PKOB classification)"),
+        mpzpDesignation: z.string().optional()
+            .describe("MPZP zoning designation filter (exact match, e.g. 'budownictwoMieszkanioweWielorodzinne', 'terenObiektowProdukcyjnychSkladowIMagazynow')"),
         minPrice: z.number().optional().describe("Minimum price in PLN"),
         maxPrice: z.number().optional().describe("Maximum price in PLN"),
         dateFrom: z.string().optional().describe("Start date (YYYY-MM-DD)"),
@@ -60,6 +66,9 @@ Example: search for apartments in Mokotów sold in 2024 above 500,000 PLN.`, {
             district: params.location,
             propertyType: mapPropertyType(params.propertyType),
             marketType: mapMarketType(params.marketType),
+            unitFunction: mapUnitFunction(params.unitFunction),
+            buildingType: mapBuildingType(params.buildingType),
+            mpzpDesignation: params.mpzpDesignation,
             minPrice: params.minPrice,
             maxPrice: params.maxPrice,
             dateFrom: params.dateFrom,
@@ -120,6 +129,10 @@ Example: find apartment sales within 2km of Warsaw's Palace of Culture (lat 52.2
             .describe("Property type filter"),
         marketType: z.enum(["primary", "secondary"]).optional()
             .describe("Market type filter"),
+        unitFunction: z.enum(["residential", "commercial", "office", "production", "garage", "other"]).optional()
+            .describe("Unit/apartment function filter"),
+        buildingType: z.enum(["residential", "commercial", "industrial", "transport", "office", "warehouse", "education_sports", "farm_utility", "hospital", "other_nonresidential"]).optional()
+            .describe("Building type filter (PKOB classification)"),
         minPrice: z.number().optional().describe("Minimum price in PLN"),
         maxPrice: z.number().optional().describe("Maximum price in PLN"),
         dateFrom: z.string().optional().describe("Start date (YYYY-MM-DD)"),
@@ -133,6 +146,8 @@ Example: find apartment sales within 2km of Warsaw's Palace of Culture (lat 52.2
             bbox: bbox.join(","),
             propertyType: mapPropertyType(params.propertyType),
             marketType: mapMarketType(params.marketType),
+            unitFunction: mapUnitFunction(params.unitFunction),
+            buildingType: mapBuildingType(params.buildingType),
             minPrice: params.minPrice,
             maxPrice: params.maxPrice,
             dateFrom: params.dateFrom,
@@ -213,6 +228,12 @@ Example: {"type":"Polygon","coordinates":[[[21.0,52.2],[21.01,52.2],[21.01,52.21
             .describe("Property type filter"),
         marketType: z.enum(["primary", "secondary"]).optional()
             .describe("Market type filter"),
+        unitFunction: z.enum(["residential", "commercial", "office", "production", "garage", "other"]).optional()
+            .describe("Unit/apartment function filter"),
+        buildingType: z.enum(["residential", "commercial", "industrial", "transport", "office", "warehouse", "education_sports", "farm_utility", "hospital", "other_nonresidential"]).optional()
+            .describe("Building type filter (PKOB classification)"),
+        mpzpDesignation: z.string().optional()
+            .describe("MPZP zoning designation filter (exact match)"),
         minPrice: z.number().optional().describe("Minimum price in PLN"),
         maxPrice: z.number().optional().describe("Maximum price in PLN"),
         dateFrom: z.string().optional().describe("Start date (YYYY-MM-DD)"),
@@ -229,6 +250,9 @@ Example: {"type":"Polygon","coordinates":[[[21.0,52.2],[21.01,52.2],[21.01,52.21
             polygon: params.polygon,
             propertyType: mapPropertyType(params.propertyType),
             marketType: mapMarketType(params.marketType),
+            unitFunction: mapUnitFunction(params.unitFunction),
+            buildingType: mapBuildingType(params.buildingType),
+            mpzpDesignation: params.mpzpDesignation,
             minPrice: params.minPrice,
             maxPrice: params.maxPrice,
             dateFrom: params.dateFrom,
@@ -252,6 +276,10 @@ Example: compare Mokotów, Wola, Ursynów for apartments.`, {
             .describe("Property type filter (recommended - API requires at least one filter)"),
         marketType: z.enum(["primary", "secondary"]).optional()
             .describe("Market type filter"),
+        unitFunction: z.enum(["residential", "commercial", "office", "production", "garage", "other"]).optional()
+            .describe("Unit/apartment function filter"),
+        buildingType: z.enum(["residential", "commercial", "industrial", "transport", "office", "warehouse", "education_sports", "farm_utility", "hospital", "other_nonresidential"]).optional()
+            .describe("Building type filter (PKOB classification)"),
         minPrice: z.number().optional().describe("Minimum price in PLN"),
         maxPrice: z.number().optional().describe("Maximum price in PLN"),
         dateFrom: z.string().optional().describe("Start date (YYYY-MM-DD)"),
@@ -265,6 +293,8 @@ Example: compare Mokotów, Wola, Ursynów for apartments.`, {
             districts: params.districts,
             propertyType: mapPropertyType(params.propertyType),
             marketType: mapMarketType(params.marketType),
+            unitFunction: mapUnitFunction(params.unitFunction),
+            buildingType: mapBuildingType(params.buildingType),
             minPrice: params.minPrice,
             maxPrice: params.maxPrice,
             dateFrom: params.dateFrom,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cenogram/mcp-server",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "MCP Server for Polish real estate transaction data (7M+ transactions from RCN)",
   "type": "module",
   "bin": {
@@ -23,7 +23,7 @@
     "@types/node": "^22.0.0",
     "tsx": "^4.19.0",
     "typescript": "^5.6.0",
-    "vitest": "^3.0.0"
+    "vitest": "^3.0.4"
   },
   "mcpName": "pl.cenogram/mcp-server",
   "keywords": ["mcp", "real-estate", "poland", "rcn", "nieruchomosci", "property", "transactions"],