guesty-mcp-server 0.5.0 → 0.6.0

package/CHANGELOG.md

@@ -2,6 +2,29 @@
 
 All notable changes to the Guesty MCP Server will be documented in this file.
 
+## [0.6.0] - 2026-04-10
+
+### Added
+- **License tier gating** — 3-tier monetization (Free/Pro/Business/Enterprise)
+  - 23 free tools (read-only operations)
+  - 15 gated tools (write operations, messaging, webhooks)
+  - License key validation via `GUESTY_MCP_LICENSE_KEY` env var
+- **MCP annotations** on all 38 tools (`readOnlyHint`, `destructiveHint`)
+- **Enhanced rate limiting** with exponential backoff and retry-after header support
+- Streamable HTTP remote endpoint via Vercel deployment
+- License key environment variable documented in server.json
+
+### Changed
+- Upgraded from v0.5.0 monetization foundation to production-ready gating
+- Improved server.json with full environment variable documentation
+- Version bumped across all entry points (server.js, http-server.js, cli.js)
+
+## [0.5.0] - 2026-04-07
+
+### Added
+- License tier system (`src/license.js`) for Pro/Business/Enterprise gating
+- MCP annotations on all 38 tools for better client-side filtering
+
 ## [0.4.3] - 2026-03-27
 
 ### Changed

package/HACKERNEWS-POST.md

@@ -0,0 +1,44 @@
+# Hacker News Show HN Post — Launch Tomorrow 8:30 AM EST
+
+## Title (80 chars max)
+Show HN: First MCP server for Guesty property management – 39 tools, open source
+
+## URL
+https://github.com/DLJRealty/guesty-mcp-server
+
+## First Comment (post within 5 minutes of submission)
+
+Hey HN – we built guesty-mcp-server because we manage 8 short-term rental properties on Guesty and wanted our AI agents to actually *do* things, not just chat.
+
+**What it does:** Connects any MCP-compatible AI client (Claude, ChatGPT, Copilot, Cline) to the Guesty property management API. 39 tools covering reservations, guest messaging, pricing, financials, calendars, reviews, tasks, and webhooks.
+
+**Install:** `npx guesty-mcp-server`
+
+**Tech:** Node.js, MCP SDK, Express for the hosted transport layer. MIT licensed. TypeScript would be nice – PRs welcome.
+
+**Why MCP:** Guesty has 100K+ listings worldwide but no MCP integration existed. Every major PMS will need one – we built the first.
+
+**What we learned:**
+- Guesty's /reservations API only returns future data. Had to use the calendar endpoint as a workaround for historical queries.
+- The MCP Dev Summit is happening this week in NYC (April 2-3). Timing was lucky.
+- 497 npm downloads in the first week, mostly from the Smithery registry listing.
+
+**Limitations:**
+- Tool execution requires your own Guesty API credentials (not a hosted SaaS... yet)
+- Some Guesty API endpoints have aggressive rate limiting (5 token refreshes/day)
+- The SSE transport doesn't work on Vercel serverless (expected)
+
+Hosted version: https://guesty-mcp-server.vercel.app
+npm: https://www.npmjs.com/package/guesty-mcp-server
+
+Happy to answer questions about building MCP servers for vertical SaaS APIs.
+
+## Timing
+- Post at 8:30 AM EST / 5:30 AM PT on Wednesday April 3
+- HN peak traffic: Tuesday-Thursday, 8-10 AM PT
+- MCP Dev Summit Day 2 happening same day = topical relevance
+- Engage with EVERY comment within first 2 hours
+
+## Backup titles (if first doesn't get traction)
+- "Show HN: We built an MCP server that manages our Airbnb properties"
+- "Show HN: Open-source MCP server for Guesty – manage rentals with AI agents"

package/guesty-partnership-email.md

@@ -0,0 +1,48 @@
+**To:** partnerships@guesty.com
+**Subject:** First MCP Server for Guesty — Marketplace Partnership Request
+
+---
+
+Hi Guesty Partnerships Team,
+
+We built the first Model Context Protocol (MCP) server for Guesty and would like to discuss listing it in the Guesty Marketplace.
+
+**What we built:**
+guesty-mcp-server — an open-source MCP server that enables AI agents (Claude, ChatGPT, Copilot, Cline, and others) to interact with Guesty's Open API through the industry-standard MCP protocol. One install command: `npx guesty-mcp-server`.
+
+**39 tools covering the full Guesty workflow:**
+- Reservations: list, get, create, update
+- Guests: get, list, search
+- Messaging: list conversations, get posts, send messages
+- Listings: list, get, update, calendar, availability, photos
+- Pricing: get pricing, update base price, calendar pricing
+- Financials: summary, owner payouts, payout details, revenue report
+- Operations: tasks, cleaning tasks, check-in/check-out, occupancy report
+- Reviews: list, get, reply
+- Webhooks: create, list, delete
+- Analytics: channel distribution
+
+**Why this matters for Guesty:**
+- MCP is the fastest-growing AI integration standard — 97M monthly SDK downloads, adopted by Anthropic, OpenAI, Google, Microsoft, and AWS
+- The MCP Dev Summit (April 2-3, NYC) is happening this week under the Linux Foundation
+- Every major property management platform will have MCP integration within 12 months — Guesty can lead by being first
+- This server lets any Guesty customer connect AI agents to their account in under 60 seconds
+
+**Traction:**
+- Live and hosted: https://guesty-mcp-server.vercel.app
+- Published on npm: https://www.npmjs.com/package/guesty-mcp-server
+- Listed on Smithery (accepted), Cline MCP Marketplace, official MCP servers directory, and 4 additional MCP directories
+- Battle-tested in production at DLJ Properties (7 units across Colorado and Miami)
+- Open source: https://github.com/DLJRealty/guesty-mcp-server
+
+**What we're asking:**
+We'd like to be listed as a Community Partner or Integrated Partner in the Guesty Marketplace. We're happy to work with your team on any requirements — documentation, security review, or deeper API integration.
+
+We're also open to co-marketing the launch. Our case study shows measurable results: 500+ automated guest replies, reduced response times, and streamlined operations across 7 properties using Guesty + MCP.
+
+Happy to jump on a call anytime. Looking forward to partnering.
+
+Best,
+Danny Perez
+DLJ Properties
+https://guestycopilot.com

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "guesty-mcp-server",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "The first MCP server for Guesty property management. 38 tools for reservations, guests, messaging, pricing, financials, calendars, reviews, tasks, and webhooks.",
   "main": "src/server.js",
   "bin": {

package/server.json

@@ -1,14 +1,41 @@
 {
-  "\$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
   "name": "io.github.DLJRealty/guesty",
   "title": "Guesty MCP Server",
   "description": "The first MCP server for Guesty property management. 38 tools for reservations, guests, messaging, pricing, financials, calendars, reviews, tasks, and webhooks.",
-  "version": "0.5.0",
+  "version": "0.6.0",
+  "repository": {
+    "url": "https://github.com/DLJRealty/guesty-mcp-server",
+    "source": "github"
+  },
   "packages": [{
     "registryType": "npm",
     "identifier": "guesty-mcp-server",
-    "version": "0.5.0",
-    "transport": { "type": "stdio" }
+    "version": "0.6.0",
+    "transport": { "type": "stdio" },
+    "environmentVariables": [
+      {
+        "description": "Guesty OAuth2 Client ID",
+        "isRequired": true,
+        "format": "string",
+        "isSecret": true,
+        "name": "GUESTY_CLIENT_ID"
+      },
+      {
+        "description": "Guesty OAuth2 Client Secret",
+        "isRequired": true,
+        "format": "string",
+        "isSecret": true,
+        "name": "GUESTY_CLIENT_SECRET"
+      },
+      {
+        "description": "License key for Pro/Business/Enterprise features (optional for free tier)",
+        "isRequired": false,
+        "format": "string",
+        "isSecret": true,
+        "name": "GUESTY_MCP_LICENSE_KEY"
+      }
+    ]
   }],
   "remotes": [{
     "transportType": "streamable-http",

package/src/http-server.js

@@ -23,7 +23,7 @@ app.use((req, res, next) => {
 // Server info
 const SERVER_INFO = {
   name: "guesty-mcp-server",
-  version: "0.4.3",
+  version: "0.6.0",
   description: "The first MCP server for Guesty property management. 38 tools for reservations, guests, messaging, pricing, financials, calendars, reviews, tasks, and webhooks.",
   capabilities: {
     tools: { listChanged: false },

package/src/server.js

@@ -125,7 +125,7 @@ async function guestyDelete(path, retries = 2) {
 // Create MCP Server
 const server = new McpServer({
   name: "guesty-mcp-server",
-  version: "0.5.0",
+  version: "0.6.0",
 });
 // License tier check
 const _tier = getTier();

package/tripadvisor-partnership-email.md

@@ -0,0 +1,27 @@
+**To:** pmsupport@tripadvisor.com
+**From:** DLJrealty@yahoo.com
+**Subject:** API Access Request — Vacation Rental Property Manager (7 Properties)
+
+---
+
+Hi TripAdvisor Rentals Team,
+
+I manage 7 short-term rental properties across Colorado and Miami through DLJ Properties. I'd like to request API access to programmatically manage our TripAdvisor Rentals listings.
+
+Our portfolio:
+- 4 boutique tiny homes in Woodland Park, Colorado (Pikes Peak area)
+- 3 apartments in Miami, Florida
+- 628+ five-star reviews across platforms
+- Airbnb Superhost, every quarter
+
+We use Guesty as our PMS and would like to integrate with TripAdvisor's Content Connect API to manage listings, calendars, rates, and photos.
+
+Our website: https://tinyhomeboutiques.com
+Our properties: https://tinyhomeboutiques.com/unit-y-boutique-tinyhome.html
+
+Could you provide API access and documentation? Happy to discuss our setup and integration needs.
+
+Best,
+Danny Perez
+DLJ Properties
+DLJrealty@yahoo.com

package/SMITHERY_DESCRIPTION.md

@@ -1,33 +0,0 @@
-# Smithery Listing — Optimized Description (v2 — Operations Focus)
-
-## Display Name
-Guesty MCP Server
-
-## Short Description (for search results)
-The first MCP server for Guesty — automate property operations, reports, calendar sync, pricing, and occupancy monitoring for short-term rentals and vacation rental portfolios.
-
-## Full Description (for server detail page)
-Automate short-term rental operations with Guesty — the leading property management system (PMS). 39 production-ready tools for property managers, Airbnb hosts, VRBO operators, and hospitality teams managing vacation rentals, boutique hotels, and serviced apartments.
-
-Reports & Revenue: Generate financial reports, owner statements, expense summaries, and revenue breakdowns across your entire portfolio. Track reservation-level financials and host payouts in real time.
-
-Calendar & Availability: Sync calendars across all channels, manage date blocks, and monitor occupancy rates. Never miss a booking gap or double-booking risk.
-
-Pricing Management: View and update nightly rates, cleaning fees, seasonal pricing, and weekly/monthly discounts. Optimize revenue across every listing.
-
-Reservations & Guest Data: Search and filter reservations by date, status, channel, or listing. Look up guest details, contact info, and booking history.
-
-Property Operations: Create and track maintenance tasks, view listing details, manage property photos, monitor automation rules, and check channel distribution status.
-
-Reviews & Reputation: Monitor guest reviews across all platforms — track your rating trends and response rates.
-
-Webhooks & Automation: Configure real-time event webhooks for check-ins, check-outs, new bookings, cancellations, and message events.
-
-Free tier includes 23 operations and data tools. Pro tier unlocks guest messaging, review responses, and write operations. Production-tested across 7 properties. Supports stdio and HTTP/SSE transports. Open source, MIT licensed.
-
-## Keywords Hit
-property management, PMS, vacation rental, short-term rental, Airbnb, VRBO, Booking.com,
-hospitality, operations, reports, revenue, calendar sync, pricing, occupancy monitoring,
-task management, property operations, channel manager, reservations, financial reports,
-owner statements, expenses, webhooks, automation, property manager, host, real estate,
-boutique hotel, serviced apartment, cleaning fee, reviews, reputation management

package/SMITHERY_VERIFICATION_REQUEST.md

@@ -1,37 +0,0 @@
-# Smithery Verification Request — Guesty MCP Server
-
-## To: Smithery Team
-
-Subject: Verification Request — First-Ever Guesty MCP Server
-
-Hi Smithery team,
-
-We are requesting verification for our Guesty MCP Server — the first and only MCP integration for Guesty, the leading property management system serving 100,000+ properties worldwide.
-
-### Why This Deserves Verification
-
-1. **Category First-Mover**: No PMS (Property Management System) MCP server exists on Smithery. We are defining a new category.
-
-2. **Production-Tested**: Running in production across 7 short-term rental properties handling real guest messages, pricing updates, and reservation management daily.
-
-3. **Comprehensive Coverage**: 39 tools spanning reservations, guest messaging, pricing, financials, calendars, reviews, tasks, and webhooks — the most complete PMS integration available via MCP.
-
-4. **Quality**: All tools include MCP annotations (readOnlyHint, destructiveHint, idempotentHint, openWorldHint), detailed parameter descriptions, and proper error handling.
-
-5. **Published & Documented**: Available on npm (guesty-mcp-server v0.4.3, 500+ downloads), MIT licensed, with full documentation.
-
-6. **Dual Transport**: Supports both stdio and HTTP/SSE (Streamable HTTP) transports for maximum compatibility.
-
-### Server Details
-- **npm**: https://www.npmjs.com/package/guesty-mcp-server
-- **GitHub**: https://github.com/DLJRealty/guesty-mcp-server
-- **Live Endpoint**: https://guesty-mcp-server.vercel.app
-- **Namespace**: @dlj/guesty
-
-### About Guesty
-Guesty is the #1 property management platform for short-term rentals, used by property managers managing vacation rentals on Airbnb, VRBO, Booking.com, and direct booking channels. Bringing Guesty to the MCP ecosystem opens automation for an industry managing billions in rental revenue.
-
-We would appreciate verification to help property managers discover this integration with confidence.
-
-Best regards,
-DLJ Properties Engineering Team

package/publish-all.sh

@@ -1,44 +0,0 @@
-#!/bin/bash
-# Guesty MCP Server v0.5.0 — Full Publish Pipeline
-# Danny runs this once. Approves browser auths. All platforms go live.
-
-export PATH=/opt/homebrew/bin:/opt/homebrew/opt/node/bin:/Users/dljrealty/.local/bin:$PATH
-cd /Users/dljrealty/guesty-mcp-server
-
-echo '=== STEP 0: npm Login (if needed) ==='
-npm whoami 2>/dev/null || npm adduser
-echo ''
-
-echo '=== STEP 0.5: Commit & push v0.5.0 to GitHub (triggers Vercel deploy) ==='
-git add package.json server.json src/server.js src/license.js
-git commit -m 'v0.5.0: Add license tier gating and MCP annotations
-
-- 23 free operations/data tools, 15 gated behind Pro+ (messaging, writes, webhooks)
-- MCP annotations (readOnlyHint, destructiveHint, etc.) on all 38 tools
-- License key system via GUESTY_MCP_LICENSE_KEY env var
-- get_license_info tool shows current tier and available tools'
-git push origin main
-echo ''
-
-echo '=== STEP 1: Publish v0.5.0 to npm ==='
-npm publish
-echo ''
-
-echo '=== STEP 2: Publish to Smithery ==='
-echo 'A browser will open for auth. Approve it.'
-smithery auth login
-smithery mcp publish 'https://guesty-mcp-server.vercel.app' -n @dlj/guesty
-echo ''
-
-echo '=== STEP 3: Publish to MCP Registry ==='
-echo 'A browser will open for GitHub device auth. Enter the code shown.'
-/Users/dljrealty/.local/bin/mcp-publisher login github
-/Users/dljrealty/.local/bin/mcp-publisher publish
-echo ''
-
-echo '=== ALL DONE ==='
-echo 'Verify:'
-echo '  npm: https://www.npmjs.com/package/guesty-mcp-server'
-echo '  Smithery: https://smithery.ai/server/@dlj/guesty'
-echo '  Registry: curl https://registry.modelcontextprotocol.io/v0.1/servers?search=guesty'
-echo '  Vercel: https://guesty-mcp-server.vercel.app (auto-deploys from GitHub push)'

package/src/LICENSE-INTEGRATION.md

@@ -1,61 +0,0 @@
-# License Key Integration Guide
-
-## How it works
-
-1. `license.js` reads `GUESTY_MCP_LICENSE_KEY` env var on startup
-2. Maps key prefix to tier: `gmcp_pro_*` = Pro, `gmcp_biz_*` = Business, `gmcp_ent_*` = Enterprise
-3. No key or invalid key = Free tier (5 read-only tools)
-4. `gatedHandler()` wraps each tool's handler — returns upgrade message for gated tools
-
-## Integration into server.js (2 changes)
-
-### Change 1: Import at top of server.js
-```js
-import { getTier, getTierInfo, gatedHandler } from './license.js';
-```
-
-### Change 2: Wrap each tool handler
-Before:
-```js
-server.tool('send_guest_message', 'Send a message...', { ... }, async (params) => {
-  // handler code
-});
-```
-
-After:
-```js
-server.tool('send_guest_message', 'Send a message...', { ... }, gatedHandler('send_guest_message', async (params) => {
-  // handler code — unchanged
-}));
-```
-
-### Change 3 (optional): Add tier info tool
-```js
-server.tool('get_license_info', 'Show current license tier and available tools', {}, async () => {
-  const info = getTierInfo();
-  return { content: [{ type: 'text', text: JSON.stringify(info, null, 2) }] };
-});
-```
-
-## Testing
-
-```bash
-# Free tier (no key)
-unset GUESTY_MCP_LICENSE_KEY
-npx guesty-mcp-server
-# Only 5 tools work, others return upgrade message
-
-# Pro tier (test key)
-GUESTY_MCP_LICENSE_KEY=test_pro npx guesty-mcp-server
-# All 38 tools unlocked
-
-# Pro tier (production key)
-GUESTY_MCP_LICENSE_KEY=gmcp_pro_abc123 npx guesty-mcp-server
-```
-
-## Key Format
-- Free: no key
-- Pro: `gmcp_pro_<random>`
-- Business: `gmcp_biz_<random>`
-- Enterprise: `gmcp_ent_<random>`
-- Test keys: `test_pro`, `test_biz`, `test_ent`