propstack-mcp-server 1.0.0

package/dist/tools/activities.js

@@ -0,0 +1,177 @@
+import { z } from "zod";
+import { textResult, errorResult, fmt } from "./helpers.js";
+// ── Response formatting ──────────────────────────────────────────────
+/** Resolve activity type — Propstack API uses conversation_type (event, reminder, note, message, etc). */
+function getActivityType(a) {
+    const t = fmt(a.conversation_type ?? a.type, "");
+    if (t && t !== "none")
+        return t;
+    const rec = a;
+    const uid = String(rec.unique_id ?? "");
+    if (uid.startsWith("event-"))
+        return "event";
+    if (uid.startsWith("reminder-"))
+        return "reminder";
+    return "—";
+}
+function formatActivity(a) {
+    const lines = [
+        `**${fmt(a.title, "Untitled")}** (ID: ${a.id})`,
+        `Type: ${getActivityType(a)}`,
+        fmt(a.body, "") ? `Body: ${fmt(a.body)}` : null,
+        a.broker ? `Broker: ${fmt(a.broker.name)}` : (a.broker_id ? `Broker ID: ${a.broker_id}` : null),
+    ];
+    if (a.client) {
+        const name = fmt(a.client.name) !== "none" ? fmt(a.client.name) : [fmt(a.client.first_name, ""), fmt(a.client.last_name, "")].filter(Boolean).join(" ") || "Unnamed";
+        lines.push(`Contact: ${name} (ID: ${a.client.id})`);
+    }
+    else if (a.client_id) {
+        lines.push(`Contact ID: ${a.client_id}`);
+    }
+    if (a.property) {
+        lines.push(`Property: ${fmt(a.property.title, "Untitled")} (ID: ${a.property.id})`);
+    }
+    else if (a.property_id) {
+        lines.push(`Property ID: ${a.property_id}`);
+    }
+    if (a.project_id)
+        lines.push(`Project ID: ${a.project_id}`);
+    lines.push(`Date: ${fmt(a.created_at)}`);
+    return lines.filter(Boolean).join("\n");
+}
+function formatEvent(e) {
+    const lines = [
+        `**${fmt(e.title, "Untitled")}** (ID: ${e.id})`,
+        `Starts: ${fmt(e.starts_at)}`,
+        `Ends: ${fmt(e.ends_at)}`,
+        `State: ${fmt(e.state)}`,
+        fmt(e.location, "") ? `Location: ${fmt(e.location)}` : null,
+        e.all_day ? `All day: yes` : null,
+        e.private ? `Private: yes` : null,
+        e.recurring ? `Recurring: yes (${fmt(e.rrule)})` : null,
+        e.broker_id ? `Broker ID: ${e.broker_id}` : null,
+    ];
+    if (e.client) {
+        const name = fmt(e.client.name) !== "none" ? fmt(e.client.name) : [fmt(e.client.first_name, ""), fmt(e.client.last_name, "")].filter(Boolean).join(" ") || "Unnamed";
+        lines.push(`Contact: ${name} (ID: ${e.client.id})`);
+    }
+    if (e.property) {
+        lines.push(`Property: ${fmt(e.property.title, "Untitled")} (ID: ${e.property.id})`);
+    }
+    if (fmt(e.body, ""))
+        lines.push(`Notes: ${fmt(e.body)}`);
+    return lines.filter(Boolean).join("\n");
+}
+// ── Tool registration ────────────────────────────────────────────────
+export function registerActivityTools(server, client) {
+    // ── search_activities ───────────────────────────────────────────
+    server.tool("search_activities", `Search the activity feed/timeline in Propstack.
+
+Activities are the read-only feed of everything that happened: emails
+sent, notes logged, tasks created, events scheduled, cancellations,
+GDPR policy changes, etc.
+
+Use this tool to:
+- View the full interaction history for a contact (client_id)
+- See all activity on a property (property_id)
+- Track what a broker has been doing (broker_id)
+- Filter by activity type to find specific interactions
+- Answer "what happened with this contact/property this week?"
+
+Activity types:
+- message: Emails sent/received
+- note: Call notes, comments
+- reminder: To-do items (Aufgaben)
+- event: Appointments (Termine)
+- policy: GDPR consent changes
+- cancelation: Deal cancellations (Absagen)
+- decision: Deal decisions
+- sms: SMS messages
+- letter: Letters (Briefe)
+
+Use list_activity_types to see all valid types for this account.`, {
+        type: z.enum(["message", "note", "reminder", "event", "policy", "cancelation", "decision", "sms", "letter"]).optional()
+            .describe("Filter by activity type"),
+        broker_id: z.number().optional()
+            .describe("Filter by broker ID"),
+        client_id: z.number().optional()
+            .describe("Filter by contact ID — show all activity for this contact"),
+        property_id: z.number().optional()
+            .describe("Filter by property ID — show all activity for this property"),
+        project_id: z.number().optional()
+            .describe("Filter by project ID"),
+        sort_by: z.string().optional()
+            .describe("Field to sort by"),
+        order: z.enum(["asc", "desc"]).optional()
+            .describe("Sort order (default: desc)"),
+        page: z.number().optional()
+            .describe("Page number (default: 1)"),
+        per: z.number().optional()
+            .describe("Results per page (default: 20)"),
+    }, async (args) => {
+        try {
+            const res = await client.get("/activities", { params: args });
+            if (!res.data || res.data.length === 0) {
+                return textResult("No activities found matching your criteria.");
+            }
+            const header = res.meta?.total_count !== undefined
+                ? `Found ${res.meta.total_count} activities (showing ${res.data.length}):\n\n`
+                : `Found ${res.data.length} activities:\n\n`;
+            const formatted = res.data.map(formatActivity).join("\n\n---\n\n");
+            return textResult(header + formatted);
+        }
+        catch (err) {
+            return errorResult("Activity", err);
+        }
+    });
+    // ── list_events ─────────────────────────────────────────────────
+    server.tool("list_events", `List calendar events (Termine) in Propstack.
+
+Events are appointments like property viewings, client meetings,
+notary appointments, etc.
+
+Use this tool to:
+- See what's scheduled this week (starts_at_from/to)
+- List upcoming viewings for a broker
+- Find cancelled appointments (state="cancelled")
+- Check recurring events
+- Answer "what viewings are scheduled this week?"
+
+Event states:
+- neutral: Scheduled, not yet happened
+- took_place: Completed
+- cancelled: Was cancelled`, {
+        recurring: z.boolean().optional()
+            .describe("Filter for recurring events only"),
+        state: z.enum(["neutral", "took_place", "cancelled"]).optional()
+            .describe("Event state: neutral (scheduled), took_place, cancelled"),
+        group_id: z.number().optional()
+            .describe("Filter by tag/group ID"),
+        broker_id: z.number().optional()
+            .describe("Filter by broker ID"),
+        starts_at_from: z.string().optional()
+            .describe("Events starting after this date/time (ISO 8601)"),
+        starts_at_to: z.string().optional()
+            .describe("Events starting before this date/time (ISO 8601)"),
+        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("/events", { params: args });
+            if (!res.data || res.data.length === 0) {
+                return textResult("No events found matching your criteria.");
+            }
+            const header = res.meta?.total_count !== undefined
+                ? `Found ${res.meta.total_count} events (showing ${res.data.length}):\n\n`
+                : `Found ${res.data.length} events:\n\n`;
+            const formatted = res.data.map(formatEvent).join("\n\n---\n\n");
+            return textResult(header + formatted);
+        }
+        catch (err) {
+            return errorResult("Event", err);
+        }
+    });
+}
+//# sourceMappingURL=activities.js.map

package/dist/tools/activities.js.map

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

package/dist/tools/admin.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 registerAdminTools(server: McpServer, client: PropstackClient): void;
+//# sourceMappingURL=admin.d.ts.map

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

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

package/dist/tools/admin.js

@@ -0,0 +1,148 @@
+import { z } from "zod";
+import { textResult, errorResult, fmt, fmtPrice } from "./helpers.js";
+// ── Tool registration ────────────────────────────────────────────────
+export function registerAdminTools(server, client) {
+    // ── list_webhooks ───────────────────────────────────────────────
+    server.tool("list_webhooks", `List all configured webhooks in Propstack.
+
+Returns each webhook with its URL, subscribed events, active status,
+and HMAC secret. Use to review existing automation triggers.`, {}, async () => {
+        try {
+            const hooks = await client.get("/hooks");
+            if (!hooks || hooks.length === 0) {
+                return textResult("No webhooks configured.");
+            }
+            const lines = hooks.map((h) => {
+                const parts = [
+                    `**Webhook #${h.id}**`,
+                    `  URL: ${fmt(h.url)}`,
+                    `  Events: ${h.events?.join(", ") ?? "none"}`,
+                    `  Active: ${h.active ? "yes" : "no"}`,
+                    h.secret ? `  Secret: ${h.secret}` : null,
+                ];
+                return parts.filter(Boolean).join("\n");
+            });
+            return textResult(`Webhooks:\n\n${lines.join("\n\n")}`);
+        }
+        catch (err) {
+            return errorResult("Webhook", err);
+        }
+    });
+    // ── create_webhook ──────────────────────────────────────────────
+    server.tool("create_webhook", `Create a webhook to subscribe to Propstack CRM events.
+
+Propstack will POST a JSON payload to target_url whenever the event
+fires. Use HMAC verification (secret in response) to validate payloads.
+
+Common events:
+- CLIENT_CREATED — new contact added
+- CLIENT_UPDATED — contact details changed
+- PROPERTY_UPDATED — property details or status changed
+
+Use this to set up automation triggers, e.g.:
+"Notify me when any property status changes"
+"Alert when a new contact is created"`, {
+        event: z.string()
+            .describe("Event name (e.g. 'CLIENT_CREATED', 'CLIENT_UPDATED', 'PROPERTY_UPDATED')"),
+        target_url: z.string()
+            .describe("URL that Propstack will POST to when the event fires"),
+    }, async (args) => {
+        try {
+            const hook = await client.post("/hooks", { body: { event: args.event, target_url: args.target_url } });
+            const lines = [
+                `Webhook created (ID: ${hook.id}).`,
+                `URL: ${fmt(hook.url)}`,
+                `Events: ${hook.events?.join(", ") ?? args.event}`,
+                `Active: ${hook.active ? "yes" : "no"}`,
+                hook.secret ? `HMAC Secret: ${hook.secret}` : null,
+            ];
+            return textResult(lines.filter(Boolean).join("\n"));
+        }
+        catch (err) {
+            return errorResult("Webhook", err);
+        }
+    });
+    // ── delete_webhook ──────────────────────────────────────────────
+    server.tool("delete_webhook", `Delete a webhook subscription from Propstack.
+
+Removes the webhook so Propstack will stop sending events to its URL.`, {
+        id: z.number()
+            .describe("Webhook ID to delete"),
+    }, async (args) => {
+        try {
+            await client.delete(`/hooks/${args.id}`);
+            return textResult(`Webhook ${args.id} deleted.`);
+        }
+        catch (err) {
+            return errorResult("Webhook", err);
+        }
+    });
+    // ── export_data ─────────────────────────────────────────────────
+    server.tool("export_data", `Bulk export an entire data table from Propstack as JSON.
+
+Useful for reporting, backup, migration, or analytics. Returns the
+full contents of the selected table.
+
+Available tables:
+- Core: contacts, properties, projects, deals, saved_queries
+- Activities: appointments, todos, notes, messages, cancelations
+- Media: documents, images
+- Organization: brokers, teams, departments, commission_splits
+- Config: deal_pipelines, policies, relationships, property_details
+- Lookup: groups, contact_sources, contact_reasons, contact_statuses,
+  reservation_reasons, property_statuses`, {
+        table: z.enum([
+            "appointments", "brokers", "cancelations", "commission_splits",
+            "contacts", "deal_pipelines", "deals", "departments",
+            "documents", "images", "messages", "notes",
+            "policies", "projects", "properties", "property_details",
+            "relationships", "saved_queries", "teams", "todos",
+            "groups", "contact_sources", "contact_reasons", "contact_statuses",
+            "reservation_reasons", "property_statuses",
+        ])
+            .describe("Table name to export"),
+    }, async (args) => {
+        try {
+            const data = await client.get(`/datadump/${args.table}`);
+            if (Array.isArray(data)) {
+                return textResult(`Exported ${data.length} rows from "${args.table}".\n\n${JSON.stringify(data, null, 2)}`);
+            }
+            return textResult(`Export of "${args.table}":\n\n${JSON.stringify(data, null, 2)}`);
+        }
+        catch (err) {
+            return errorResult("Data export", err);
+        }
+    });
+    // ── get_contact_favorites ───────────────────────────────────────
+    server.tool("get_contact_favorites", `Get properties that a contact has favorited/bookmarked.
+
+Returns the list of properties the contact has marked as favorites
+in Propstack. Use to understand which listings a buyer is most
+interested in.`, {
+        contact_id: z.number()
+            .describe("Contact ID"),
+    }, async (args) => {
+        try {
+            const favorites = await client.get(`/contacts/${args.contact_id}/favorites`);
+            if (!favorites || favorites.length === 0) {
+                return textResult(`Contact ${args.contact_id} has no favorited properties.`);
+            }
+            const lines = favorites.map((p) => {
+                const addr = [fmt(p.street, ""), fmt(p.house_number, "")].filter(Boolean).join(" ");
+                const city = [fmt(p.zip_code, ""), fmt(p.city, "")].filter(Boolean).join(" ");
+                const fullAddr = [addr, city].filter(Boolean).join(", ");
+                const price = fmtPrice(p.price) !== "none"
+                    ? fmtPrice(p.price)
+                    : fmtPrice(p.base_rent) !== "none"
+                        ? fmtPrice(p.base_rent) + "/mo"
+                        : "no price";
+                return `- **${fmt(p.title, "Untitled")}** (ID: ${p.id}) — ${fullAddr || "no address"} — ${price}`;
+            });
+            return textResult(`Favorited properties (${favorites.length}):\n\n${lines.join("\n")}`);
+        }
+        catch (err) {
+            return errorResult("Contact favorites", err);
+        }
+    });
+}
+//# sourceMappingURL=admin.js.map

package/dist/tools/admin.js.map

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

package/dist/tools/composites.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 registerCompositeTools(server: McpServer, client: PropstackClient): void;
+//# sourceMappingURL=composites.d.ts.map

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

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