@cenogram/mcp-server 0.1.1 → 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/index.js

@@ -55,10 +55,6 @@ async function main() {
                 if (pathname === "/mcp") {
                     const auth = req.headers.authorization;
                     const apiKeyFromHeader = auth?.startsWith("Bearer ") ? auth.slice(7).trim() : undefined;
-                    if (!apiKeyFromHeader) {
-                        res.writeHead(401, { "Content-Type": "application/json" }).end(JSON.stringify({ jsonrpc: "2.0", error: { code: -32001, message: "Authorization: Bearer <api-key> required" }, id: null }));
-                        return;
-                    }
                     const transport = new StreamableHTTPServerTransport({ sessionIdGenerator: undefined });
                     const mcpServer = createMcpServer(apiKeyFromHeader);
                     try {

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 }] };
@@ -11,6 +11,11 @@ function formatCreditFooter(creditInfo) {
         return "";
     return `\n---\nTokeny API: ${creditInfo.balance} pozostało (koszt zapytania: ${creditInfo.cost})`;
 }
+function requireApiKey(apiKey) {
+    if (!apiKey) {
+        throw new Error("Authorization: Bearer <api-key> required. Get your free API key at https://cenogram.pl/api");
+    }
+}
 async function withErrorHandling(fn) {
     try {
         return await fn();
@@ -32,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)"),
@@ -50,10 +61,14 @@ Example: search for apartments in Mokotów sold in 2024 above 500,000 PLN.`, {
         page: z.number().min(1).default(1).optional()
             .describe("Page number for pagination (default: 1)"),
     }, { readOnlyHint: true }, async (params) => withErrorHandling(async () => {
+        requireApiKey(apiKey);
         const txParams = {
             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,
@@ -80,6 +95,7 @@ Note: only covers residential units (lokale mieszkalne). For other property type
 For Warsaw: use district names (Mokotów, Wola) - 'Warszawa' won't match any results.`, {
         location: z.string().optional().describe("Filter by location name (case-insensitive partial match). E.g. 'Kraków' matches 'Kraków-Podgórze', 'Kraków-Śródmieście', etc. Omit for all Poland."),
     }, { readOnlyHint: true }, async (params) => withErrorHandling(async () => {
+        requireApiKey(apiKey);
         const { data: allRows, creditInfo } = await getPricePerM2(apiKey);
         let rows = allRows;
         if (params.location) {
@@ -95,6 +111,7 @@ Useful for understanding the overall market price structure in Poland.`, {
         maxPrice: z.number().default(3_000_000)
             .describe("Maximum price to include (default 3,000,000 PLN)"),
     }, { readOnlyHint: true }, async (params) => withErrorHandling(async () => {
+        requireApiKey(apiKey);
         const { data: bins, creditInfo } = await getPriceHistogram(params.bins, params.maxPrice, apiKey);
         return textResponse(formatHistogram(bins) + formatCreditFooter(creditInfo));
     }));
@@ -112,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)"),
@@ -119,11 +140,14 @@ Example: find apartment sales within 2km of Warsaw's Palace of Culture (lat 52.2
         limit: z.number().min(1).max(50).default(20)
             .describe("Number of results (1-50, default 20)"),
     }, { readOnlyHint: true }, async (params) => withErrorHandling(async () => {
+        requireApiKey(apiKey);
         const bbox = radiusKmToBbox(params.latitude, params.longitude, params.radiusKm);
         const txParams = {
             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,
@@ -141,6 +165,7 @@ Example: find apartment sales within 2km of Warsaw's Palace of Culture (lat 52.2
     // ── Tool 5: get_market_overview ─────────────────────────────────────
     server.tool("get_market_overview", `Get a comprehensive overview of the Polish real estate transaction database.
 Returns: total transaction count, date range, breakdown by property type and market type, top locations, price statistics.`, {}, { readOnlyHint: true }, async () => withErrorHandling(async () => {
+        requireApiKey(apiKey);
         const { data: stats, creditInfo } = await getStats(apiKey);
         return textResponse(formatMarketOverview(stats) + formatCreditFooter(creditInfo));
     }));
@@ -152,6 +177,7 @@ For Kraków: returns sub-districts (Kraków-Podgórze, Kraków-Śródmieście, e
 Use the search parameter to filter by name.`, {
         search: z.string().optional().describe("Filter locations by name (case-insensitive partial match, e.g. 'Krak' for Kraków districts)"),
     }, { readOnlyHint: true }, async (params) => withErrorHandling(async () => {
+        requireApiKey(apiKey);
         const { data: allDistricts, creditInfo } = await getDistricts(apiKey);
         let districts = allDistricts;
         if (params.search) {
@@ -183,6 +209,7 @@ Example: search for parcels starting with '146518_8.01'.`, {
         limit: z.number().min(1).max(10).default(10).optional()
             .describe("Max results (1-10, default 10)"),
     }, { readOnlyHint: true }, async (params) => withErrorHandling(async () => {
+        requireApiKey(apiKey);
         const { data, creditInfo } = await searchParcels(params.q, params.limit, apiKey);
         return textResponse(formatParcelResults(data, params.q) + formatCreditFooter(creditInfo));
     }));
@@ -201,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)"),
@@ -212,10 +245,14 @@ Example: {"type":"Polygon","coordinates":[[[21.0,52.2],[21.01,52.2],[21.01,52.21
         limit: z.number().min(1).max(5000).default(100).optional()
             .describe("Max results (1-5000, default 100). MCP displays up to 50 transactions."),
     }, { readOnlyHint: true }, async (params) => withErrorHandling(async () => {
+        requireApiKey(apiKey);
         const { data, creditInfo } = await searchByPolygon({
             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,
@@ -239,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)"),
@@ -247,10 +288,13 @@ Example: compare Mokotów, Wola, Ursynów for apartments.`, {
         maxArea: z.number().optional().describe("Maximum area in m²"),
         street: z.string().optional().describe("Street name filter"),
     }, { readOnlyHint: true }, async (params) => withErrorHandling(async () => {
+        requireApiKey(apiKey);
         const { data, creditInfo } = await compareLocations({
             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.1",
+  "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"],