guesty-mcp-server 0.4.0 → 0.4.2

package/.mcpregistry_github_token

@@ -0,0 +1 @@
+ghu_erLfGY4zAYVbjzUz0jwdlWjPzYIRaP0Kql1T

package/.mcpregistry_registry_token

@@ -0,0 +1 @@
+{"token":"eyJhbGciOiJFZERTQSIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJtY3AtcmVnaXN0cnkiLCJleHAiOjE3NzQ1NzkyNTksIm5iZiI6MTc3NDU3ODk1OSwiaWF0IjoxNzc0NTc4OTU5LCJhdXRoX21ldGhvZCI6ImdpdGh1Yi1hdCIsImF1dGhfbWV0aG9kX3N1YiI6IkRMSlJlYWx0eSIsInBlcm1pc3Npb25zIjpbeyJhY3Rpb24iOiJwdWJsaXNoIiwicmVzb3VyY2UiOiJpby5naXRodWIuRExKUmVhbHR5LyoifV19.U8Lmee0qloF-2ugZuRdpi7Wnu-HeODY6kfMmztM1TamM4mWppFfytEELC9EM6nTs6Sq_y1HSKOmHiWOhODVYDg","expires_at":1774579259}

package/README.md

@@ -1,63 +1,26 @@
 # Guesty MCP Server
 
-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.
+[![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)
 
-## Features
+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.
 
-| Tool | Description |
-|------|-------------|
-| `get_reservations` | Fetch reservations with filters (dates, listing, status, guest) |
-| `get_listing` | Get property details or list all properties |
-| `get_conversations` | Fetch guest message history |
-| `send_guest_message` | Send messages to guests in conversations |
-| `get_financials` | Revenue, payouts, and commission data |
-| `update_pricing` | Update base price or date-specific pricing |
-| `create_reservation` | Create direct bookings (website → Guesty) |
-| `get_reviews` | Fetch guest reviews from all channels |
-| `get_calendar` | Check availability and pricing by date |
-| `update_calendar` | Block/unblock dates, set minimum nights |
-| `respond_to_review` | Post responses to guest reviews |
-| `get_owner_statements` | Owner revenue statements and reports |
-| `get_expenses` | Track operational expenses |
-| `get_channels` | List connected booking channels per property |
-| `get_tasks` | Fetch cleaning and maintenance tasks |
+**38 tools** covering reservations, listings, guests, messaging, financials, tasks, calendars, webhooks, pricing, and more.
 
 ## Quick Start
 
-### 1. Get Guesty API Credentials
-
-1. Log into [Guesty Dashboard](https://app.guesty.com)
-2. Go to **Settings > API** (or Marketplace > API Credentials)
-3. Create an API application with `open-api` scope
-4. Copy your **Client ID** and **Client Secret**
-
-### 2. Install
-
 ```bash
-git clone https://github.com/DLJRealty/guesty-mcp-server.git
-cd guesty-mcp-server
-npm install
+npx guesty-mcp-server
 ```
 
-### 3. Configure
-
-Set your Guesty credentials as environment variables:
-
-```bash
-export GUESTY_CLIENT_ID="your-client-id"
-export GUESTY_CLIENT_SECRET="your-client-secret"
-```
-
-### 4. Add to Claude Code
-
-Add to your Claude Code settings (`~/.claude/settings.json`):
+Or add to your Claude Code settings (`~/.claude/settings.json`):
 
 ```json
 {
   "mcpServers": {
     "guesty": {
-      "command": "node",
-      "args": ["/path/to/guesty-mcp-server/src/server.js"],
+      "command": "npx",
+      "args": ["-y", "guesty-mcp-server"],
       "env": {
         "GUESTY_CLIENT_ID": "your-client-id",
         "GUESTY_CLIENT_SECRET": "your-client-secret"
@@ -67,17 +30,76 @@ Add to your Claude Code settings (`~/.claude/settings.json`):
 }
 ```
 
-### 5. Use
+## Get Guesty API Credentials
+
+1. Log into [Guesty Dashboard](https://app.guesty.com)
+2. Go to **Settings > API** (or Marketplace > API Credentials)
+3. Create an API application with `open-api` scope
+4. Copy your **Client ID** and **Client Secret**
+
+## All 38 Tools
 
-Once connected, your AI agent can:
+### Reservations & Guests
+| Tool | Description |
+|------|-------------|
+| `get_reservations` | Fetch reservations with filters (dates, listing, status, guest) |
+| `create_reservation` | Create direct bookings (website to Guesty) |
+| `update_reservation` | Update reservation status, dates, guest info, or add notes |
+| `search_reservations` | Search by guest name, email, or confirmation code |
+| `get_reservation_financials` | Detailed financial breakdown for a reservation |
+| `create_reservation_note` | Add internal notes to a reservation |
+| `get_guests` | Search guest database by name or email |
+| `get_guest_by_id` | Get detailed guest profile |
+
+### Listings & Calendar
+| Tool | Description |
+|------|-------------|
+| `get_listing` | Get property details or list all properties |
+| `update_listing` | Update title, description, amenities, min nights, max guests |
+| `get_calendar` | Check availability and pricing by date |
+| `update_calendar` | Block/unblock dates, set minimum nights |
+| `get_calendar_blocks` | Get blocked dates with reasons |
+| `get_listing_occupancy` | Calculate occupancy rate over a date range |
+| `get_photos` | Fetch listing photos with captions |
+| `update_photos` | Replace or reorder listing photos |
 
-```
-"Show me all reservations checking in this week"
-"What's the total revenue for March?"
-"Send a welcome message to the guest checking in tomorrow"
-"Update the base price for Unit Y to $159"
-"List all my properties with their current status"
-```
+### Messaging
+| Tool | Description |
+|------|-------------|
+| `get_conversations` | Fetch guest message history |
+| `send_guest_message` | Send messages to guests in conversations |
+
+### Financials & Pricing
+| Tool | Description |
+|------|-------------|
+| `get_financials` | Revenue, payouts, and commission data |
+| `update_pricing` | Update base price or date-specific pricing |
+| `get_listing_pricing` | Get base price, discounts, and fee details |
+| `update_listing_pricing` | Update base price, cleaning fee, discounts |
+| `get_owner_statements` | Owner revenue statements and reports |
+| `get_expenses` | Track operational expenses |
+| `create_expense` | Create new expense records |
+| `get_revenue_summary` | Aggregated revenue across all listings |
+
+### Operations
+| Tool | Description |
+|------|-------------|
+| `get_tasks` | Fetch cleaning and maintenance tasks |
+| `create_task` | Create cleaning or maintenance tasks |
+| `get_reviews` | Fetch guest reviews from all channels |
+| `respond_to_review` | Post responses to guest reviews |
+| `get_channels` | List connected booking channels per property |
+| `get_supported_languages` | Get supported languages for a listing |
+
+### Automation & Integrations
+| Tool | Description |
+|------|-------------|
+| `get_automation_rules` | List automation and workflow rules |
+| `get_webhooks` | List registered webhooks |
+| `create_webhook` | Register new webhook for event notifications |
+| `delete_webhook` | Remove a registered webhook |
+| `get_custom_fields` | Fetch custom fields for listings or reservations |
+| `get_account_info` | Get account info and subscription details |
 
 ## Use Cases
 
@@ -85,17 +107,17 @@ Once connected, your AI agent can:
 - **Revenue Management**: Pull financial reports, analyze occupancy, optimize pricing
 - **Operations**: Track check-ins/outs, coordinate cleaning schedules, manage availability
 - **Marketing**: Identify low-occupancy periods, create targeted promotions
-- **Multi-Agent Teams**: Give your entire AI team (CEO, Marketing, CS, Ops) access to property data
+- **Multi-Agent Teams**: Give your entire AI team access to property data
 
 ## Requirements
 
 - Node.js 18+
 - Guesty account with API access (Professional plan or higher)
-- MCP-compatible AI client (Claude Code, OpenClaw, etc.)
+- MCP-compatible AI client (Claude Code, Cursor, Windsurf, etc.)
 
 ## API Reference
 
-This server wraps the [Guesty Open API](https://open-api.guesty.com/api-docs). Authentication uses OAuth2 client credentials flow with automatic token caching and refresh.
+This server wraps the [Guesty Open API](https://open-api.guesty.com/api-docs). Authentication uses OAuth2 client credentials flow with automatic token caching, retry logic, and rate limit handling.
 
 ## Built By
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "guesty-mcp-server",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "MCP Server for Guesty Property Management - The first Guesty MCP server",
   "main": "src/server.js",
   "bin": {
@@ -30,7 +30,8 @@
     "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/server.json

@@ -0,0 +1,36 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.DLJRealty/guesty",
+  "description": "MCP server for Guesty property management — 38 tools for STR operations.",
+  "repository": {
+    "url": "https://github.com/DLJRealty/guesty-mcp-server",
+    "source": "github"
+  },
+  "version": "0.4.1",
+  "packages": [
+    {
+      "registryType": "npm",
+      "identifier": "guesty-mcp-server",
+      "version": "0.4.1",
+      "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"
+        }
+      ]
+    }
+  ]
+}

package/smithery.yaml

@@ -0,0 +1,17 @@
+startCommand:
+  type: stdio
+  configSchema:
+    type: object
+    required:
+      - guestyClientId
+      - guestyClientSecret
+    properties:
+      guestyClientId:
+        type: string
+        description: Guesty OAuth2 Client ID
+      guestyClientSecret:
+        type: string
+        description: Guesty OAuth2 Client Secret
+  commandFunction:
+    |-
+      (config) => ({ command: 'npx', args: ['-y', 'guesty-mcp-server'], env: { GUESTY_CLIENT_ID: config.guestyClientId, GUESTY_CLIENT_SECRET: config.guestyClientSecret } })