guesty-mcp-server 0.9.2 → 0.9.4

package/README.md

@@ -3,9 +3,15 @@
 [![npm version](https://img.shields.io/npm/v/guesty-mcp-server)](https://www.npmjs.com/package/guesty-mcp-server)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-The first MCP (Model Context Protocol) server for [Guesty](https://guesty.com) property management. Connect AI agents directly to your Guesty account to manage reservations, communicate with guests, track finances, and update pricing -- all autonomously.
+The first MCP (Model Context Protocol) server for [Guesty](https://guesty.com) property management. Connect any MCP-compatible AI client (Claude, ChatGPT, Copilot, Cline) to your Guesty account — manage reservations, communicate with guests, track finances, update pricing.
 
-**43 tools** covering reservations, listings, guests, messaging, financials, tasks, calendars, webhooks, and pricing — plus **1 IoT tool** (`get_readiness_score`) and **3 Enterprise-tier aggregators** (`get_property_health`, `submit_checkout_photos`, `get_maintenance_alerts`) for property health aggregation, checkout photo intake, and portfolio maintenance alerts.
+**Just shipped v0.9.3 (2026-05-23):** 23 free read-only tools — reservations, listings, guests, calendars, financial reports, operations, reviews, and webhook reads — live now. The full 43-tool surface (write/destructive ops + webhook management) ships behind a paid tier in v1.0 next week.
+
+**Why MCP:** Guesty is one of the larger PMS platforms in the short-term-rental space and no MCP integration existed. Every major PMS will need one — we built the first.
+
+**Built in production** on 8 of our own short-term rentals. Node.js + MCP SDK + Express, MIT licensed. Things we learned: Guesty's `/reservations` endpoint only returns future data (we use the calendar endpoint for historical), and the SSE transport doesn't run on Vercel serverless (expected). **2,112 lifetime npm downloads, 676 in the last 30 days.**
+
+Full tool surface: **43 tools** across reservations, listings, guests, messaging, financials, tasks, calendars, webhooks, and pricing — plus **1 IoT tool** (`get_readiness_score`) and **3 Enterprise-tier aggregators** (`get_property_health`, `submit_checkout_photos`, `get_maintenance_alerts`).
 
 > **Want AI to handle your guest messages 24/7?** [Guesty Copilot](https://guestycopilot.com) -- AI guest management for Guesty hosts, built on this MCP server. Now in beta.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "guesty-mcp-server",
-  "version": "0.9.2",
+  "version": "0.9.4",
   "description": "MCP server for Guesty property management — 43 production tools + 7 addressable resource templates covering reservations, guests, messaging, pricing, revenue, tasks, webhooks, and IoT/property-health Enterprise tier.",
   "main": "src/server.js",
   "bin": {

package/package.json.pre-resources-20260420-232423

@@ -1,49 +0,0 @@
-{
-  "name": "guesty-mcp-server",
-  "version": "0.8.2",
-  "description": "MCP server for Guesty property management — 43 production tools covering reservations, guests, messaging, pricing, revenue, tasks, webhooks, and IoT/property-health Enterprise tier.",
-  "main": "src/server.js",
-  "bin": {
-    "guesty-mcp-server": "src/server.js",
-    "guesty-cli": "src/cli.js"
-  },
-  "type": "module",
-  "scripts": {
-    "start": "node src/server.js",
-    "test": "node tests/test-enterprise.js && node tests/test-iot.js"
-  },
-  "keywords": [
-    "mcp",
-    "mcp-server",
-    "model-context-protocol",
-    "guesty",
-    "property-management",
-    "short-term-rental",
-    "airbnb",
-    "vrbo",
-    "vacation-rental",
-    "ai-agent",
-    "pms",
-    "iot",
-    "enterprise",
-    "hospitality",
-    "real-estate",
-    "automation"
-  ],
-  "author": "DLJ Properties",
-  "license": "MIT",
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "latest",
-    "@vercel/analytics": "^2.0.1",
-    "express": "^5.2.1"
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/DLJRealty/guesty-mcp-server.git"
-  },
-  "homepage": "https://github.com/DLJRealty/guesty-mcp-server",
-  "mcpName": "io.github.DLJRealty/guesty",
-  "engines": {
-    "node": ">=18.0.0"
-  }
-}

package/package.json.pre-v092-stub-20260521-1751

@@ -1,49 +0,0 @@
-{
-  "name": "guesty-mcp-server",
-  "version": "0.9.1",
-  "description": "MCP server for Guesty property management — 43 production tools + 7 addressable resource templates covering reservations, guests, messaging, pricing, revenue, tasks, webhooks, and IoT/property-health Enterprise tier.",
-  "main": "src/server.js",
-  "bin": {
-    "guesty-mcp-server": "src/server.js",
-    "guesty-cli": "src/cli.js"
-  },
-  "type": "module",
-  "scripts": {
-    "start": "node src/server.js",
-    "test": "node tests/test-enterprise.js && node tests/test-iot.js"
-  },
-  "keywords": [
-    "mcp",
-    "mcp-server",
-    "model-context-protocol",
-    "guesty",
-    "property-management",
-    "short-term-rental",
-    "airbnb",
-    "vrbo",
-    "vacation-rental",
-    "ai-agent",
-    "pms",
-    "iot",
-    "enterprise",
-    "hospitality",
-    "real-estate",
-    "automation"
-  ],
-  "author": "DLJ Properties",
-  "license": "MIT",
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "latest",
-    "@vercel/analytics": "^2.0.1",
-    "express": "^5.2.1"
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/DLJRealty/guesty-mcp-server.git"
-  },
-  "homepage": "https://github.com/DLJRealty/guesty-mcp-server",
-  "mcpName": "io.github.DLJRealty/guesty",
-  "engines": {
-    "node": ">=18.0.0"
-  }
-}

package/src/license.js.bak.20260426-tier-enforcement

@@ -1,117 +0,0 @@
-/**
- * Guesty MCP Server — License Key System (v2)
- * 
- * 3-Layer Monetization Model (Danny-approved 2026-04-06):
- * - Layer 1: MCP Server = operations/data tool (FREE, lead gen)
- * - Layer 2: Guesty Copilot = SaaS platform (PAID)
- * - Layer 3: DLJ Managed AI = premium service (our real IP)
- * 
- * FREE tier: Read-only operations data — reservations, listings, calendar,
- *   financials, tasks, guest lookup, pricing, occupancy, channels, photos.
- * PRO+ tier: Guest communication — messaging, review responses, webhook
- *   creation, reservation writes, listing updates.
- * 
- * Reads GUESTY_MCP_LICENSE_KEY from env.
- * No key or invalid key = free tier (operations data only).
- */
-
-// Free tier: read-only operations and data tools
-const FREE_TOOLS = [
-  // Reservations (read-only)
-  "get_reservations",
-  "search_reservations",
-  "get_reservation_financials",
-  // Listings (read-only)
-  "get_listing",
-  "get_listing_occupancy",
-  "get_listing_pricing",
-  "get_photos",
-  // Guests (read-only)
-  "get_guests",
-  "get_guest_by_id",
-  // Calendar (read-only)
-  "get_calendar",
-  "get_calendar_blocks",
-  // Financials (read-only)
-  "get_financials",
-  "get_owner_statements",
-  "get_expenses",
-  "get_revenue_summary",
-  // Operations (read-only)
-  "get_tasks",
-  "get_channels",
-  "get_automation_rules",
-  "get_custom_fields",
-  "get_account_info",
-  "get_supported_languages",
-  // Reviews (read-only)
-  "get_reviews",
-  // Webhooks (read-only)
-  "get_webhooks",
-];
-
-// PRO+ gated tools: guest communication, writes, and real-time events
-// send_guest_message, respond_to_review, create_webhook, delete_webhook,
-// create_reservation, update_reservation, create_reservation_note,
-// update_pricing, update_calendar, update_listing, update_photos,
-// update_listing_pricing, create_expense, create_task,
-// get_conversations (contains message content)
-
-// Simple key-to-tier mapping
-// Production: Stripe webhook or DB lookup
-// For now: keys prefixed gmcp_pro_*, gmcp_biz_*, gmcp_ent_*
-function resolveTier(licenseKey) {
-  if (!licenseKey) return "free";
-  const key = licenseKey.trim();
-  if (key.startsWith("gmcp_ent_")) return "enterprise";
-  if (key.startsWith("gmcp_biz_")) return "business";
-  if (key.startsWith("gmcp_pro_")) return "pro";
-  if (key === "test_pro") return "pro";
-  if (key === "test_biz") return "business";
-  if (key === "test_ent") return "enterprise";
-  return "free";
-}
-
-function getTier() {
-  return resolveTier(process.env.GUESTY_MCP_LICENSE_KEY);
-}
-
-function isToolAllowed(toolName) {
-  const tier = getTier();
-  if (tier !== "free") return true;
-  return FREE_TOOLS.includes(toolName);
-}
-
-function getTierInfo() {
-  const tier = getTier();
-  // 39 Guesty core tools + 1 IoT (get_readiness_score) + 3 Enterprise aggregators
-  // (get_property_health, submit_checkout_photos, get_maintenance_alerts) = 43.
-  // Updated 2026-04-17 for Enterprise Tier MVP merge (Owner msg 6406).
-  const totalTools = 43;
-  return {
-    tier,
-    hasKey: !!process.env.GUESTY_MCP_LICENSE_KEY,
-    freeToolCount: FREE_TOOLS.length,
-    gatedToolCount: totalTools - FREE_TOOLS.length,
-    unlocked: tier !== "free",
-  };
-}
-
-function gatedHandler(toolName, handler) {
-  return async (params) => {
-    if (!isToolAllowed(toolName)) {
-      const msg = "This tool (" + toolName + ") requires a Pro or higher license. " +
-                  "Free tier includes " + FREE_TOOLS.length + " operations and data tools. " +
-                  "Guest messaging, review responses, and write operations require Pro+. " +
-                  "Upgrade at https://guestycopilot.com/pricing -- " +
-                  "Set GUESTY_MCP_LICENSE_KEY env var to unlock all 43 tools.";
-      return {
-        content: [{ type: "text", text: msg }],
-        isError: true,
-      };
-    }
-    return handler(params);
-  };
-}
-
-export { getTier, isToolAllowed, getTierInfo, gatedHandler, FREE_TOOLS };

package/src/license.js.pre-v092-stub-20260521-1751

@@ -1,163 +0,0 @@
-/**
- * Guesty MCP Server — License Key System (v2)
- * 
- * 3-Layer Monetization Model (Danny-approved 2026-04-06):
- * - Layer 1: MCP Server = operations/data tool (FREE, lead gen)
- * - Layer 2: Guesty Copilot = SaaS platform (PAID)
- * - Layer 3: DLJ Managed AI = premium service (our real IP)
- * 
- * FREE tier: Read-only operations data — reservations, listings, calendar,
- *   financials, tasks, guest lookup, pricing, occupancy, channels, photos.
- * PRO+ tier: Guest communication — messaging, review responses, webhook
- *   creation, reservation writes, listing updates.
- * 
- * Reads GUESTY_MCP_LICENSE_KEY from env.
- * No key or invalid key = free tier (operations data only).
- */
-
-// Free tier: read-only operations and data tools
-const FREE_TOOLS = [
-  // Reservations (read-only)
-  "get_reservations",
-  "search_reservations",
-  "get_reservation_financials",
-  // Listings (read-only)
-  "get_listing",
-  "get_listing_occupancy",
-  "get_listing_pricing",
-  "get_photos",
-  // Guests (read-only)
-  "get_guests",
-  "get_guest_by_id",
-  // Calendar (read-only)
-  "get_calendar",
-  "get_calendar_blocks",
-  // Financials (read-only)
-  "get_financials",
-  "get_owner_statements",
-  "get_expenses",
-  "get_revenue_summary",
-  // Operations (read-only)
-  "get_tasks",
-  "get_channels",
-  "get_automation_rules",
-  "get_custom_fields",
-  "get_account_info",
-  "get_supported_languages",
-  // Reviews (read-only)
-  "get_reviews",
-  // Webhooks (read-only)
-  "get_webhooks",
-];
-
-// Enterprise tier: IoT + property aggregator tools (4 total)
-// These ship in active validation per data-integrity gate; require Enterprise license.
-const ENT_TOOLS = [
-  "get_readiness_score",
-  "get_property_health",
-  "submit_checkout_photos",
-  "get_maintenance_alerts",
-];
-
-// Business tier: operational/SLA features the binary advertises (consumed by getTierInfo).
-// No per-call tool gating — Business unlocks the same 39 base tools as Pro plus the
-// multi-account license terms and priority support promised by guestycopilot.com pricing.
-const BIZ_FEATURES = {
-  multiAccountLicense: true,
-  prioritySupport: true,
-};
-
-// PRO+ gated tools: guest communication, writes, and real-time events
-// send_guest_message, respond_to_review, create_webhook, delete_webhook,
-// create_reservation, update_reservation, create_reservation_note,
-// update_pricing, update_calendar, update_listing, update_photos,
-// update_listing_pricing, create_expense, create_task,
-// get_conversations (contains message content)
-
-// Simple key-to-tier mapping
-// Production: Stripe webhook or DB lookup
-// For now: keys prefixed gmcp_pro_*, gmcp_biz_*, gmcp_ent_*
-function resolveTier(licenseKey) {
-  if (!licenseKey) return "free";
-  const key = licenseKey.trim();
-  if (key.startsWith("gmcp_ent_")) return "enterprise";
-  if (key.startsWith("gmcp_biz_")) return "business";
-  if (key.startsWith("gmcp_pro_")) return "pro";
-  if (key === "test_pro") return "pro";
-  if (key === "test_biz") return "business";
-  if (key === "test_ent") return "enterprise";
-  return "free";
-}
-
-function getTier() {
-  return resolveTier(process.env.GUESTY_MCP_LICENSE_KEY);
-}
-
-function isToolAllowed(toolName) {
-  const tier = getTier();
-  if (tier === "free") {
-    return FREE_TOOLS.includes(toolName);
-  }
-  // Enterprise-tier tools require enterprise license
-  if (ENT_TOOLS.includes(toolName)) {
-    return tier === "enterprise";
-  }
-  // All other paid tools (Pro+) allowed for pro / business / enterprise
-  return true;
-}
-
-function getTierInfo() {
-  const tier = getTier();
-  // 39 Guesty core tools + 1 IoT (get_readiness_score) + 3 Enterprise aggregators
-  // (get_property_health, submit_checkout_photos, get_maintenance_alerts) = 43.
-  // Updated 2026-04-17 for Enterprise Tier MVP merge (Owner msg 6406).
-  const totalTools = 43;
-  const entToolCount = ENT_TOOLS.length;
-  const baseToolCount = totalTools - entToolCount;  // 39
-  const accessibleCount =
-    tier === "free" ? FREE_TOOLS.length :
-    tier === "enterprise" ? totalTools :
-    baseToolCount;  // pro / business
-  return {
-    tier,
-    hasKey: !!process.env.GUESTY_MCP_LICENSE_KEY,
-    freeToolCount: FREE_TOOLS.length,
-    baseToolCount,
-    entToolCount,
-    accessibleToolCount: accessibleCount,
-    gatedToolCount: totalTools - accessibleCount,
-    unlocked: tier !== "free",
-    bizFeatures: tier === "business" || tier === "enterprise" ? BIZ_FEATURES : null,
-  };
-}
-
-function gatedHandler(toolName, handler) {
-  return async (params) => {
-    if (!isToolAllowed(toolName)) {
-      const tier = getTier();
-      let msg;
-      if (tier === "free") {
-        msg = "This tool (" + toolName + ") requires a Pro or higher license. " +
-              "Free tier includes " + FREE_TOOLS.length + " operations and data tools. " +
-              "Guest messaging, review responses, and write operations require Pro+. " +
-              "Upgrade at https://guestycopilot.com/pricing -- " +
-              "Set GUESTY_MCP_LICENSE_KEY env var to unlock all 43 tools.";
-      } else if (ENT_TOOLS.includes(toolName)) {
-        msg = "This tool (" + toolName + ") requires an Enterprise license. " +
-              "Your current tier (" + tier + ") includes the 39 base Guesty tools. " +
-              "Enterprise adds IoT readiness, property health, checkout photo intake, " +
-              "and maintenance alerts (4 additional tools). " +
-              "Talk to us at https://guestycopilot.com/pricing";
-      } else {
-        msg = "This tool (" + toolName + ") is not available in your current tier (" + tier + ").";
-      }
-      return {
-        content: [{ type: "text", text: msg }],
-        isError: true,
-      };
-    }
-    return handler(params);
-  };
-}
-
-export { getTier, isToolAllowed, getTierInfo, gatedHandler, FREE_TOOLS, ENT_TOOLS, BIZ_FEATURES };