propstack-mcp-server 1.0.0

package/dist/tools/helpers.js

@@ -0,0 +1,160 @@
+import { PropstackError } from "../propstack-client.js";
+export function textResult(text) {
+    return { content: [{ type: "text", text }] };
+}
+/**
+ * Parse 422 validation error body into human-readable field errors.
+ */
+function parse422(detail) {
+    try {
+        const parsed = JSON.parse(detail);
+        // Propstack returns { errors: { field: ["msg", ...] } } or { error: "msg" }
+        if (parsed.errors && typeof parsed.errors === "object") {
+            const lines = [];
+            for (const [field, msgs] of Object.entries(parsed.errors)) {
+                const msgList = Array.isArray(msgs) ? msgs.join(", ") : String(msgs);
+                lines.push(`  ${field}: ${msgList}`);
+            }
+            if (lines.length > 0)
+                return `Validation failed:\n${lines.join("\n")}`;
+        }
+        if (parsed.error)
+            return `Validation error: ${parsed.error}`;
+    }
+    catch {
+        // Not JSON, return as-is
+    }
+    return `Validation error: ${detail}`;
+}
+/**
+ * Extract a resource ID from the API path for better 404 messages.
+ * e.g. "/contacts/123" → "123", "/units/456" → "456"
+ */
+function extractIdFromPath(path) {
+    const match = /\/(\d+)(?:\/|$)/.exec(path);
+    return match?.[1] ?? null;
+}
+/**
+ * Format any error into a user-friendly string.
+ */
+export function formatError(err) {
+    if (err instanceof PropstackError) {
+        const id = extractIdFromPath(err.path);
+        switch (err.status) {
+            case 401:
+                return "Invalid API key. Check your PROPSTACK_API_KEY. Manage keys at crm.propstack.de/app/admin/api_keys";
+            case 403:
+                return "Insufficient permissions. Check API key permissions in Propstack admin.";
+            case 404:
+                return id
+                    ? `Not found. The resource with ID ${id} does not exist (${err.path}).`
+                    : `Not found (${err.path}).`;
+            case 422:
+                return parse422(err.detail);
+            case 429:
+                return "Rate limited by Propstack API. Please try again in a moment.";
+            default:
+                return `Propstack API error ${err.status}: ${err.detail}`;
+        }
+    }
+    if (err instanceof TypeError && (err.message.includes("fetch") || err.message.includes("ECONNREFUSED") || err.message.includes("ENOTFOUND"))) {
+        return `Network error: could not reach Propstack API. Check your internet connection. (${err.message})`;
+    }
+    if (err instanceof Error)
+        return err.message;
+    return String(err);
+}
+export function errorResult(entity, err) {
+    if (err instanceof PropstackError) {
+        const id = extractIdFromPath(err.path);
+        if (err.status === 401) {
+            return textResult("Invalid API key. Check your PROPSTACK_API_KEY. Manage keys at crm.propstack.de/app/admin/api_keys");
+        }
+        if (err.status === 403) {
+            return textResult("Insufficient permissions. Check API key permissions in Propstack admin.");
+        }
+        if (err.status === 404) {
+            return id
+                ? textResult(`${entity} not found. No ${entity.toLowerCase()} with ID ${id} exists.`)
+                : textResult(`${entity} not found.`);
+        }
+        if (err.status === 422) {
+            return textResult(parse422(err.detail));
+        }
+        if (err.status === 429) {
+            return textResult("Rate limited by Propstack API. Please try again in a moment.");
+        }
+        return textResult(`Propstack API error ${err.status}: ${err.detail}`);
+    }
+    const msg = formatError(err);
+    return { content: [{ type: "text", text: `Error: ${msg}` }], isError: true };
+}
+/**
+ * Propstack API with new=1/expand=1 returns nested objects like { value: X } or
+ * { value: X, pretty_value: Y }. Unwrap to the underlying primitive for display.
+ */
+export function unwrapPropstackValue(val) {
+    if (val === null || val === undefined)
+        return val;
+    if (typeof val === "object" && val !== null) {
+        const o = val;
+        if ("pretty_value" in o && o.pretty_value != null && o.pretty_value !== "") {
+            return unwrapPropstackValue(o.pretty_value);
+        }
+        if ("value" in o) {
+            return unwrapPropstackValue(o.value);
+        }
+    }
+    return val;
+}
+export function fmt(value, fallback = "none") {
+    const v = unwrapPropstackValue(value);
+    if (v === null || v === undefined || v === "")
+        return fallback;
+    if (typeof v === "object")
+        return fallback;
+    return String(v);
+}
+/** Unwrap and coerce to number for price/area formatting. */
+export function unwrapNumber(val) {
+    const v = unwrapPropstackValue(val);
+    if (typeof v === "number" && !Number.isNaN(v))
+        return v;
+    if (typeof v === "string") {
+        const n = parseFloat(v);
+        return Number.isNaN(n) ? null : n;
+    }
+    return null;
+}
+export function fmtPrice(value) {
+    const n = unwrapNumber(value);
+    if (n === null)
+        return "none";
+    return n.toLocaleString("de-DE", { style: "currency", currency: "EUR", maximumFractionDigits: 0 });
+}
+export function fmtArea(value, unit = "m²") {
+    const n = unwrapNumber(value);
+    if (n === null)
+        return "none";
+    return `${n} ${unit}`;
+}
+export function fmtNested(obj, key, fallback = "none") {
+    if (!obj || typeof obj !== "object")
+        return fallback;
+    const val = obj[key];
+    return fmt(val, fallback);
+}
+/**
+ * Remove keys with undefined values from an object so we don't send
+ * nulls to the API when optional fields are omitted.
+ */
+export function stripUndefined(obj) {
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+        if (value !== undefined) {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=helpers.js.map

package/dist/tools/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/tools/helpers.ts"],"names":[],"mappings":"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"}

package/dist/tools/lookups.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { PropstackClient } from "../propstack-client.js";
+export declare function registerLookupTools(server: McpServer, client: PropstackClient): void;
+//# sourceMappingURL=lookups.d.ts.map

package/dist/tools/lookups.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lookups.d.ts","sourceRoot":"","sources":["../../src/tools/lookups.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAmD9D,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAsZpF"}

package/dist/tools/lookups.js

@@ -0,0 +1,333 @@
+import { z } from "zod";
+import { textResult, errorResult, fmt } from "./helpers.js";
+// ── Response formatting ──────────────────────────────────────────────
+function formatPipeline(p) {
+    const lines = [
+        `**${fmt(p.name, "Untitled")}** (ID: ${p.id})`,
+    ];
+    if (p.broker_ids?.length) {
+        lines.push(`Brokers: ${p.broker_ids.join(", ")}`);
+    }
+    if (p.deal_stages?.length) {
+        lines.push("Stages:");
+        for (const s of p.deal_stages) {
+            const chance = s.chance !== null && s.chance !== undefined ? ` (${s.chance}%)` : "";
+            lines.push(`  ${s.position ?? "?"}) **${fmt(s.name)}** (ID: ${s.id})${chance}`);
+        }
+    }
+    return lines.join("\n");
+}
+function formatBroker(b) {
+    const lines = [
+        `**${fmt(b.name)}** (ID: ${b.id})`,
+        `Email: ${fmt(b.email)}`,
+        b.phone ? `Phone: ${b.phone}` : null,
+        b.position ? `Position: ${b.position}` : null,
+        b.team_id ? `Team ID: ${b.team_id}` : null,
+        b.department_ids?.length ? `Departments: ${b.department_ids.join(", ")}` : null,
+    ];
+    return lines.filter(Boolean).join("\n");
+}
+// ── Tool registration ────────────────────────────────────────────────
+export function registerLookupTools(server, client) {
+    // ── list_pipelines ──────────────────────────────────────────────
+    server.tool("list_pipelines", `List all deal pipelines and their stages in Propstack.
+
+Returns each pipeline with its ordered stages, including stage IDs,
+names, positions, colors, and chance percentages.
+
+You NEED stage IDs from this tool to create or move deals. Call this
+before using create_deal or update_deal if you don't know the stage IDs.
+
+Typical pipelines: Sales (Verkauf), Acquisition (Akquise), Rental (Vermietung).
+Typical stages: Anfrage → Besichtigung → Reserviert → Notartermin → Verkauft.`, {}, async () => {
+        try {
+            const pipelines = await client.get("/deal_pipelines");
+            if (!pipelines || pipelines.length === 0) {
+                return textResult("No deal pipelines configured.");
+            }
+            const formatted = pipelines.map(formatPipeline).join("\n\n---\n\n");
+            return textResult(`Deal pipelines:\n\n${formatted}`);
+        }
+        catch (err) {
+            return errorResult("Pipeline", err);
+        }
+    });
+    // ── get_pipeline ────────────────────────────────────────────────
+    server.tool("get_pipeline", `Get a single deal pipeline by ID with its stages.
+
+Returns the pipeline with all stages in order. Use this when you
+already know which pipeline you need and want its stage details.`, {
+        id: z.number()
+            .describe("Pipeline ID"),
+    }, async (args) => {
+        try {
+            const pipeline = await client.get(`/deal_pipelines/${args.id}`);
+            return textResult(formatPipeline(pipeline));
+        }
+        catch (err) {
+            return errorResult("Pipeline", err);
+        }
+    });
+    // ── list_tags / list_groups ──────────────────────────────────────
+    server.tool("list_tags", `List all tags/labels (Merkmale/Gruppen) in Propstack.
+
+Use these IDs to filter contacts (search_contacts group param) or assign
+tags (create_contact/update_contact group_ids). Filter by entity to get
+tags for contacts, properties, or activities.
+
+Entity: for_clients (default), for_properties, for_activities.
+
+Returns flat list: **Name** (ID: 123). Use super_groups param to optionally
+try hierarchical view via /super_groups.`, {
+        entity: z.enum(["for_clients", "for_properties", "for_activities"]).optional()
+            .describe("Filter by entity type (default: for_clients)"),
+        super_groups: z.boolean().optional()
+            .describe("If true, fetch hierarchical structure from /super_groups (Obermerkmale with children)"),
+    }, async (args) => {
+        try {
+            const params = {};
+            if (args.entity)
+                params["entity"] = args.entity;
+            if (args.super_groups) {
+                const res = await client.get("/super_groups", { params: { ...params, include: "groups" } });
+                const sgs = Array.isArray(res) ? res : res?.data ?? [];
+                if (!sgs.length)
+                    return textResult("No super groups found.");
+                const lines = [];
+                for (const sg of sgs) {
+                    lines.push(`**${fmt(sg.name, "Ungrouped")}** (ID: ${sg.id})`);
+                    if (sg.groups?.length) {
+                        for (const g of sg.groups) {
+                            lines.push(`  • ${fmt(g.name)} (ID: ${g.id})`);
+                        }
+                    }
+                }
+                return textResult(`Tags (hierarchical):\n\n${lines.join("\n")}`);
+            }
+            const raw = await client.get("/groups", { params });
+            const items = Array.isArray(raw) ? raw : [];
+            if (!items.length) {
+                return textResult("No tags found.");
+            }
+            // API returns flat [{id, name, super_group_id, public_name}] or hierarchical [{id, name, groups: []}]
+            const flatItems = [];
+            for (const item of items) {
+                const sg = item;
+                if (sg.groups?.length) {
+                    for (const g of sg.groups)
+                        flatItems.push({ id: g.id, name: g.name, super_group_id: g.super_group_id });
+                }
+                else {
+                    flatItems.push({
+                        id: item.id,
+                        name: item.name,
+                        super_group_id: item.super_group_id,
+                    });
+                }
+            }
+            const lines = flatItems.map((g) => `- **${fmt(g.name)}** (ID: ${g.id})`);
+            return textResult(`Tags/Groups (Merkmale) — use these IDs for search_contacts group filter:\n\n${lines.join("\n")}`);
+        }
+        catch (err) {
+            return errorResult("Tag", err);
+        }
+    });
+    // ── create_tag ──────────────────────────────────────────────────
+    server.tool("create_tag", `Create a new tag/label (Merkmal) in Propstack.
+
+Tags are used to categorize contacts, properties, and activities.
+Optionally assign to a parent super-group (Obermerkmal) for hierarchy.
+
+Examples: "Penthouse-Käufer", "VIP", "Kapitalanleger", "Erstbezug".`, {
+        name: z.string()
+            .describe("Tag name"),
+        entity: z.enum(["for_clients", "for_properties", "for_activities"])
+            .describe("Which entity type this tag applies to"),
+        super_group_id: z.number().optional()
+            .describe("Parent super-group ID (Obermerkmal) for hierarchy"),
+    }, async (args) => {
+        try {
+            const tag = await client.post("/groups", { body: args });
+            return textResult(`Tag created: **${fmt(tag.name)}** (ID: ${tag.id})` +
+                (tag.super_group_id ? ` — parent group: ${tag.super_group_id}` : ""));
+        }
+        catch (err) {
+            return errorResult("Tag", err);
+        }
+    });
+    // ── list_custom_fields ──────────────────────────────────────────
+    server.tool("list_custom_fields", `List custom field definitions for an entity type in Propstack.
+
+IMPORTANT: Call this tool to discover what custom fields exist before
+reading or writing custom field values on contacts, properties, etc.
+
+Returns field groups, each containing field definitions with:
+- name: The API key to use (e.g. "cf_budget_range")
+- pretty_name: Human-readable label (e.g. "Budget Range")
+- type: Field type (String, Dropdown, Number, Date, etc.)
+- options: Available values for Dropdown fields
+
+To READ custom fields: use expand=true on search or get tools.
+To WRITE custom fields: use partial_custom_fields: {"cf_field_name": "value"}.
+To FILTER by custom fields: add cf_fieldname=value as a search param.`, {
+        entity: z.enum(["for_clients", "for_properties", "for_projects", "for_brokers", "for_tasks", "for_deals"])
+            .describe("Entity type to get custom fields for"),
+    }, async (args) => {
+        try {
+            const groups = await client.get("/custom_field_groups", { params: { entity: args.entity } });
+            if (!groups || groups.length === 0) {
+                return textResult(`No custom fields configured for ${args.entity}.`);
+            }
+            const lines = [];
+            for (const g of groups) {
+                lines.push(`**${fmt(g.name, "Default")}** (Group ID: ${g.id})`);
+                if (g.fields?.length) {
+                    for (const f of g.fields) {
+                        let desc = `  • \`${f.name}\` — ${fmt(f.pretty_name)} (${fmt(f.type)})`;
+                        if (f.options?.length) {
+                            desc += `\n    Options: ${f.options.join(", ")}`;
+                        }
+                        lines.push(desc);
+                    }
+                }
+            }
+            return textResult(`Custom fields for ${args.entity}:\n\n${lines.join("\n")}`);
+        }
+        catch (err) {
+            return errorResult("Custom field", err);
+        }
+    });
+    // ── list_users ──────────────────────────────────────────────────
+    server.tool("list_users", `List all brokers/agents (Nutzer) in the Propstack account.
+
+Returns team members with their IDs, names, email, phone, position,
+team, and department assignments.
+
+You need broker IDs for:
+- Assigning contacts or properties to a broker
+- Filtering by broker in search tools
+- Setting the sender for emails (send_email broker_id)
+- Assigning tasks and events`, {}, async () => {
+        try {
+            const brokers = await client.get("/brokers");
+            if (!brokers || brokers.length === 0) {
+                return textResult("No brokers/users found.");
+            }
+            const formatted = brokers.map(formatBroker).join("\n\n---\n\n");
+            return textResult(`Brokers/Users:\n\n${formatted}`);
+        }
+        catch (err) {
+            return errorResult("Broker", err);
+        }
+    });
+    // ── list_teams ──────────────────────────────────────────────────
+    server.tool("list_teams", `List all teams/departments in Propstack.
+
+Returns teams with their broker member assignments. Use for team-level
+filtering and to understand the organizational structure.`, {}, async () => {
+        try {
+            const teams = await client.get("/teams");
+            if (!teams || teams.length === 0) {
+                return textResult("No teams configured.");
+            }
+            const lines = teams.map((t) => {
+                const members = t.broker_ids?.length ? `Members: ${t.broker_ids.join(", ")}` : "No members";
+                return `**${fmt(t.name)}** (ID: ${t.id}) — ${members}`;
+            });
+            return textResult(`Teams:\n\n${lines.join("\n")}`);
+        }
+        catch (err) {
+            return errorResult("Team", err);
+        }
+    });
+    // ── list_activity_types ─────────────────────────────────────────
+    server.tool("list_activity_types", `List all activity/task types in Propstack.
+
+These are templates for creating notes, todos (reminders), events, and messages.
+Each has an id, name, and category. Use these IDs when creating tasks:
+- category "for_notes" → note_type_id in create_task
+- category "for_reminders" → todo_type_id (when is_reminder: true)
+- category "for_events" → event_type_id (when is_event: true)
+- category "message" → snippet_id for email templates
+
+Categories map to search_activities filter: for_notes→note, for_reminders→reminder,
+for_events→event, message→message.`, {
+        category: z.enum(["message", "for_notes", "for_reminders", "for_events"]).optional()
+            .describe("Filter by category (message, for_notes, for_reminders, for_events)"),
+    }, async (args) => {
+        try {
+            const res = await client.get("/activity_types", args.category ? { params: { category: args.category } } : undefined);
+            let types = Array.isArray(res) ? res : res?.data ?? [];
+            if (args.category) {
+                types = types.filter((t) => fmt(t.category) === args.category);
+            }
+            if (!types.length) {
+                return textResult(args.category
+                    ? `No activity types in category "${args.category}".`
+                    : "No activity types configured.");
+            }
+            const lines = types.map((t) => {
+                const cat = fmt(t.category, "");
+                return `- **${fmt(t.name)}** (ID: ${t.id}) — ${cat}`;
+            });
+            return textResult(`Activity types${args.category ? ` (${args.category})` : ""}:\n\n${lines.join("\n")}`);
+        }
+        catch (err) {
+            return errorResult("Activity type", err);
+        }
+    });
+    // ── list_contact_statuses ──────────────────────────────────────
+    server.tool("list_contact_statuses", `List contact statuses (Kontaktstatus) in Propstack.
+
+Use these IDs for search_contacts (status param) and create_contact/update_contact
+(client_status_id). E.g. "Lead", "Kunde", "Archiviert".`, {}, async () => {
+        try {
+            const raw = await client.get("/contact_statuses");
+            const items = Array.isArray(raw) ? raw : raw?.data ?? [];
+            if (!items.length)
+                return textResult("No contact statuses found.");
+            const lines = items.map((s) => `- **${fmt(s.name)}** (ID: ${s.id})`);
+            return textResult(`Contact statuses:\n\n${lines.join("\n")}`);
+        }
+        catch (err) {
+            return errorResult("Contact status", err);
+        }
+    });
+    // ── list_reservation_reasons ────────────────────────────────────
+    server.tool("list_reservation_reasons", `List deal cancellation reasons (Reservierungsgründe/Absagegründe).
+
+Use when creating deal cancellations (create_task with reservation_reason_id)
+or filtering lost deals (search_deals reservation_reason_ids).`, {}, async () => {
+        try {
+            const raw = await client.get("/reservation_reasons");
+            const items = Array.isArray(raw) ? raw : raw?.data ?? [];
+            if (!items.length)
+                return textResult("No reservation reasons found.");
+            const lines = items.map((r) => `- **${fmt(r.name)}** (ID: ${r.id})`);
+            return textResult(`Reservation/cancellation reasons:\n\n${lines.join("\n")}`);
+        }
+        catch (err) {
+            return errorResult("Reservation reason", err);
+        }
+    });
+    // ── list_locations ──────────────────────────────────────────────
+    server.tool("list_locations", `List geographic areas/districts (Geolagen) in Propstack.
+
+Returns location IDs and names used for property and search profile
+location matching. Use location IDs when creating search profiles
+or filtering properties by area.`, {}, async () => {
+        try {
+            const locations = await client.get("/locations");
+            if (!locations || locations.length === 0) {
+                return textResult("No locations configured.");
+            }
+            const lines = locations.map((l) => `- **${fmt(l.name)}** (ID: ${l.id})`);
+            return textResult(`Locations:\n\n${lines.join("\n")}`);
+        }
+        catch (err) {
+            return errorResult("Location", err);
+        }
+    });
+}
+//# sourceMappingURL=lookups.js.map

package/dist/tools/lookups.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lookups.js","sourceRoot":"","sources":["../../src/tools/lookups.ts"],"names":[],"mappings":"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"}

package/dist/tools/projects.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { PropstackClient } from "../propstack-client.js";
+export declare function registerProjectTools(server: McpServer, client: PropstackClient): void;
+//# sourceMappingURL=projects.d.ts.map

package/dist/tools/projects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../src/tools/projects.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAgD9D,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAkFrF"}

package/dist/tools/projects.js

@@ -0,0 +1,104 @@
+import { z } from "zod";
+import { textResult, errorResult, fmt } from "./helpers.js";
+// ── Response formatting ──────────────────────────────────────────────
+function formatProject(p) {
+    const title = fmt(p.title ?? p.name, "Untitled");
+    const addr = [p.street, p.house_number].filter(Boolean).join(" ");
+    const cityLine = [p.zip_code, p.city].filter(Boolean).join(" ");
+    const fullAddress = [addr, cityLine, p.country].filter(Boolean).join(", ");
+    const lines = [
+        `**${title}** (ID: ${p.id})`,
+        `Status: ${fmt(p.status)}`,
+        `Address: ${fullAddress || "none"}`,
+        `Broker: ${fmt(p.broker_id, "unassigned")}`,
+    ];
+    // Units summary
+    if (p.units && p.units.length > 0) {
+        lines.push(`Units: ${p.units.length}`);
+        for (const u of p.units) {
+            const uAddr = [u.street, u.house_number].filter(Boolean).join(" ");
+            lines.push(`  • ${fmt(u.title, "Untitled")} (ID: ${u.id}) — ${fmt(u.property_status?.name)} ${uAddr ? `— ${uAddr}` : ""}`);
+        }
+    }
+    // Media counts
+    if (p.images?.length)
+        lines.push(`Images: ${p.images.length}`);
+    if (p.floorplans?.length)
+        lines.push(`Floorplans: ${p.floorplans.length}`);
+    if (p.documents?.length)
+        lines.push(`Documents: ${p.documents.length}`);
+    if (p.links?.length)
+        lines.push(`Links: ${p.links.length}`);
+    lines.push(`Created: ${fmt(p.created_at)}`);
+    return lines.filter(Boolean).join("\n");
+}
+function formatProjectRow(p) {
+    const title = fmt(p.title ?? p.name, "Untitled");
+    const cityLine = [p.zip_code, p.city].filter(Boolean).join(" ");
+    const unitCount = p.units?.length ?? "—";
+    return `| ${p.id} | ${title} | ${fmt(p.status)} | ${cityLine || "—"} | ${unitCount} |`;
+}
+// ── Tool registration ────────────────────────────────────────────────
+export function registerProjectTools(server, client) {
+    // ── list_projects ───────────────────────────────────────────────
+    server.tool("list_projects", `List development projects in Propstack.
+
+A project is a "super-object" that groups multiple property units
+(e.g. a new-build apartment complex with 20 units).
+
+Use this tool to:
+- See all active development projects
+- Get an overview of unit counts and statuses
+- Find a project by name before drilling into its units
+
+Use expand=true to include custom fields in the response.`, {
+        expand: z.boolean().optional()
+            .describe("Include custom fields in response"),
+        page: z.number().optional()
+            .describe("Page number (default: 1)"),
+        per_page: z.number().optional()
+            .describe("Results per page (default: 25)"),
+    }, async (args) => {
+        try {
+            const res = await client.get("/projects", { params: args });
+            if (!res.data || res.data.length === 0) {
+                return textResult("No projects found.");
+            }
+            const header = res.meta?.total_count !== undefined
+                ? `Found ${res.meta.total_count} projects (showing ${res.data.length}):\n\n`
+                : `Found ${res.data.length} projects:\n\n`;
+            const table = [
+                "| ID | Title | Status | City | Units |",
+                "|---|---|---|---|---|",
+                ...res.data.map(formatProjectRow),
+            ].join("\n");
+            return textResult(header + table);
+        }
+        catch (err) {
+            return errorResult("Project", err);
+        }
+    });
+    // ── get_project ─────────────────────────────────────────────────
+    server.tool("get_project", `Get full details of a single project by ID.
+
+Returns the complete project with all units, images, floorplans,
+documents, and links.
+
+Use this tool to:
+- See how a project is performing (unit statuses)
+- Check how many units are still available vs. sold/reserved
+- View project media and documents
+- Get unit-level details (prices, sizes, statuses)`, {
+        id: z.number()
+            .describe("Project ID"),
+    }, async (args) => {
+        try {
+            const project = await client.get(`/projects/${args.id}`);
+            return textResult(formatProject(project));
+        }
+        catch (err) {
+            return errorResult("Project", err);
+        }
+    });
+}
+//# sourceMappingURL=projects.js.map