# Lodgify — how to use (mcp.ai)

Connect your Lodgify account and use 30 tools for scheduling and booking straight from your AI agent. Connect with your own API key. Lodgify is an all-in-one vacation rental software that enables property owners and managers to create bookable websites, synchronize property data across multiple channels, and manage guest reservations and communications from a single platform.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_lodgify?ms=1787295900000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `lodgify_create_callmeback_request`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/lodgify`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/lodgify/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/lodgify/create/callmeback/request` — Tool to create a Call Me Back request in Lodgify. Use when scheduling a callback appointment with a guest for property inquiries or booking assistance.
  - body: { date?: string, time?: integer, guest?: object, notes?: string, origin?: string, people?: integer, status?: string, arrival?: string, duration?: number, messages?: object[], departure?: string, thread_id?: string, ip_created?: string, property_id?: integer, source_text?: string, room_type_id?: integer, source_address?: string, guest_breakdown: object, time_zone_info_id?: string, has_privacy_consent?: boolean }
- `POST https://api.mcp.ai/api/lodgify/create/enquiry` — Tool to create a new general enquiry with guest and reservation details. Use when a potential guest wants to make an enquiry about a property or availability.
  - body: { guest?: object, origin?: string, people?: integer, status?: string, arrival?: string, messages?: object[], departure?: string, thread_id?: string, ip_created?: string, property_id?: integer, source_text?: string, room_type_id?: integer, source_address?: string, guest_breakdown: object, has_privacy_consent?: boolean }
- `POST https://api.mcp.ai/api/lodgify/decline/enquiry` — Tool to decline an enquiry, changing its status to Declined. Use when you need to reject or decline an enquiry from a potential guest.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/lodgify/delete/enquiry` — Tool to delete an enquiry by moving it to the trash. Use when you need to remove an enquiry from active listings without permanently deleting it.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/lodgify/delete/reservations` — Tool to delete multiple bookings or enquiries in a single batch operation. Use when you need to remove several reservations at once instead of deleting them individually.
  - body: { reservations: object[] }
- `POST https://api.mcp.ai/api/lodgify/get/countries` — Tool to retrieve all available countries. Use when you need to populate country selectors with supported ISO codes and names.
- `POST https://api.mcp.ai/api/lodgify/get/country/by/code` — Tool to retrieve a specific country by its ISO code. Use when you need to validate a country code or get the full country name for a given code.
  - body: { code: string }
- `POST https://api.mcp.ai/api/lodgify/get/currency/by/code` — Tool to retrieve currency details by its code. Use when you need to get information about a specific currency including its exchange rate, decimal places, and symbol.
  - body: { code: string }
- `POST https://api.mcp.ai/api/lodgify/get/deleted/properties` — Retrieves IDs of properties that have been deleted from the Lodgify account. Use this action to: - Get a list of all deleted property IDs - Filter deleted properties by deletion date using the deleted
  - body: { deletedSince?: string }
- `POST https://api.mcp.ai/api/lodgify/get/external/bookings` — Tool to retrieve external bookings for a specific booking ID. Use when you need to get external booking details associated with a main booking record.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/lodgify/get/messaging/thread` — Tool to retrieve details of a messaging thread. Use when you need to access thread information including messages, guest details, and thread status. The threadGuid parameter can be obtained from: - Re
  - body: { threadGuid: string }
- `POST https://api.mcp.ai/api/lodgify/get/property/availability` — Retrieves availability information for a specific property within a date range. This action queries the Lodgify API to get detailed availability data including: - Property ID, room type ID, and user I
  - body: { periodEnd?: string, propertyId: integer, periodStart?: string }
- `POST https://api.mcp.ai/api/lodgify/get/roomtype/availability` — Retrieves availability calendar data for a specific room type within a property for a given date range. This action queries the Lodgify API to get detailed availability information for a specific room
  - body: { end?: string, start?: string, propertyId: integer, roomTypeId: integer, includeDetails?: boolean }
- `POST https://api.mcp.ai/api/lodgify/get/unread/count` — Retrieves the total count of unread bookings and enquiries. Use this to check how many new reservations or enquiries require attention.
- `POST https://api.mcp.ai/api/lodgify/get/v1/availability` — Retrieves availability information for all properties and room types for a given date range. Use when you need to check availability across all properties in the account. Returns empty array if no ava
  - body: { periodEnd: string, periodStart: string, BookingsOnly?: boolean, ModifiedSince?: string, CombineRoomTypes?: boolean, IncludeBookingIds?: boolean }
- `POST https://api.mcp.ai/api/lodgify/list/channel/connections` — Tool to retrieve a list of all channel connections. Use when you need to display or synchronize channel connections across properties.
  - body: { page?: integer, status?: string, channel?: string, pageSize?: integer }
- `POST https://api.mcp.ai/api/lodgify/list/channel/mappings` — Tool to list channel mappings. Use when you need to retrieve all channel mappings, optionally filtered by property, channel code, or external ID. Supports pagination.
  - body: { page?: integer, pageSize?: integer, externalId?: string, propertyId?: integer, channelCode?: string }
- `POST https://api.mcp.ai/api/lodgify/list/channel/reservations` — Tool to list channel reservations. Use when you need to retrieve reservations across channels filtered by property, channel, or date range. Results are paginated; use `limit` and `offset` together acr
  - body: { limit?: integer, offset?: integer, channelId?: integer, createdTo?: string, propertyId?: integer, createdFrom?: string }
- `POST https://api.mcp.ai/api/lodgify/list/channels` — Retrieves a list of all available distribution channels in the Lodgify account. Channels are booking platforms (e.g., Airbnb, Booking.com, Vrbo, Expedia) that can be connected to properties for synchr
- `POST https://api.mcp.ai/api/lodgify/list/currencies` — Tool to retrieve all available currency codes. Use when you need to display currency options or validate currency codes for pricing and reservations.
- `POST https://api.mcp.ai/api/lodgify/list/properties` — Retrieves all properties from the Lodgify account with optional pagination. Use this action to: - Get a list of all properties in the account - Iterate through properties using pagination - Check whic
  - body: { page?: integer, pageSize?: integer }
- `POST https://api.mcp.ai/api/lodgify/list/reservations` — Tool to retrieve a paginated list of bookings and enquiries from the inbox. Use when you need to fetch reservations with optional filtering by status, property, date range, or trash status.
  - body: { limit?: integer, trash?: boolean, offset?: integer, status?: string, periodEnd?: string, propertyId?: integer, periodStart?: string, modifiedSince?: string }
- `POST https://api.mcp.ai/api/lodgify/list/webhooks` — Retrieves a list of all webhooks configured in the Lodgify account. Use this action to: - Get all webhook configurations - View webhook details including ID, event type, and target URL - Check which w
- `POST https://api.mcp.ai/api/lodgify/mark/reservations/not/replied` — Tool to batch mark bookings and enquiries as not replied. Use when you need to mark multiple reservations (bookings or enquiries) as not replied in a single operation.
  - body: { items: object[] }
- `POST https://api.mcp.ai/api/lodgify/mark/reservations/replied` — Tool to batch mark bookings or enquiries as replied. Use when you need to mark multiple reservations as replied in a single operation.
  - body: { items: object[] }
- `POST https://api.mcp.ai/api/lodgify/recover/enquiry` — Tool to restore an enquiry that was previously moved to the trash. Use when you need to recover a deleted enquiry by its ID.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/lodgify/reopen/enquiry` — Tool to reopen an enquiry, changing its status to Open. Use when you need to reactivate a previously closed or cancelled enquiry.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/lodgify/set/availability` — Updates the number of available units for a specific room type within a date range. Use this action to set availability for booking periods. The period_start and period_end dates define the range duri
  - body: { available: integer, period_end: string, property_id: integer, period_start: string, room_type_id: integer }
- `POST https://api.mcp.ai/api/lodgify/subscribe/webhook` — Subscribes to a Lodgify webhook by providing a target URL and event type. Use this action to: - Register a callback URL to receive real-time notifications from Lodgify - Listen for specific events lik
  - body: { event: string, target_url: string }
- `POST https://api.mcp.ai/api/lodgify/unsubscribe/webhook` — Tool to unsubscribe from a Lodgify webhook. Use when you need to remove a webhook subscription by providing the webhook ID that was returned during subscription.
  - body: { id: string }

## Example prompts
- "What can I do in Lodgify?"
- "Show me a summary of my Lodgify account"

## More
- Page: https://mcp.ai/lodgify
- Agent spec (llms.txt): https://mcp.ai/lodgify/llms.txt
- Postman collection: https://mcp.ai/lodgify/postman.json