# Softinn MCP > Softinn MCP Server manages your entire hotel property operation through any AI client. It gives agents direct access to Softinn's PMS and Booking Engine, handling everything from real-time room availability checks and creating guest reservations to updating housekeeping status and processing payments against guest folios. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** softinn-pms, hotel-management, booking-engine, reservation-system, inventory-sync, guest-folios, housekeeping-app ## Description Listen up. The Softinn MCP Server connects your AI client straight into the core of a hotel’s operations—the Property Management System and Booking Engine. You don't gotta jump between ten different dashboards or call five separate APIs to handle an entire guest stay; this server puts it all in one place. It lets your agent manage everything from checking room availability to processing payments on a folio, giving you full control over the property cycle. ### Guest Booking and Reservation Management To start booking someone up, your agent uses **`check_availability`** to search for vacant rooms within any date range. This tool tells you exactly which room types are open and how many of each you got. Once you know what’s available, the system lets you generate a brand new guest reservation using **`create_reservation`**. You just feed it the necessary details—the dates, the number of guests, and the desired room type—and it books the record straight into Softinn's main system. For existing stays, you can use **`list_reservations_by_date`** to pull a list of every guest scheduled to check in or stay on any specific day. If you have a known reservation ID, **`get_reservation_details`** pulls up all the specifics for that single booking. You can also get a full picture of what’s going on with billing by running **`list_reservation_folios`**, which retrieves every financial folio attached to that reservation. ### Inventory and Room Status Control You gotta keep track of your physical inventory, right? The server gives you two tools for that. First, **`list_room_types`** lists every single configured room type the hotel offers—things like 'King Suite' or 'Double Room.' Second, **`list_all_rooms`** goes deeper; it lists *every* physical room in the building and its current metadata so you know exactly what you’re dealing with. For housekeeping operations, you can change a specific physical room’s status using **`update_room_status`**. This lets your agent mark a room as Clean, Dirty, or Out of Order to keep all staff systems synced up. ### Financial and Billing Operations Money moves fast in hotels. When it comes to billing, the server allows you to see detailed financial records using **`list_reservation_folios`**. More critically, if a guest pays something—say, they pay for dinner or parking—your agent uses **`add_folio_payment`** to record that payment amount directly against a specific folio number. You can also get a high-level look at the whole property setup by running **`get_hotel_summary`**, which pulls configuration data about the entire hotel operation. ### Workflow Summary Basically, you’re letting your agent manage the full lifecycle. It's gotta check availability first (**`check_availability`**), then create the booking (**`create_reservation`**). While they stay here, housekeeping marks rooms (using **`update_room_status`**) and staff manages billing by checking folios (**`list_reservation_folios`**) and recording payments (**`add_folio_payment`**). If you need to know what’s going on with the whole place—like every room or all reservations for tomorrow—you got **`list_all_rooms`**, **`list_room_types`**, and **`list_reservations_by_date`**. It's a complete stack. You don't wanna manually manage this stuff; let your agent handle it. ## Tools ### add_folio_payment Records a payment amount directly against a specific guest folio number. ### check_availability Searches the system to find out which room types are available within a defined date range. ### create_reservation Generates and books a brand new guest reservation using provided details (dates, type, guest). ### get_hotel_summary Retrieves high-level configuration data about the entire hotel property setup. ### get_reservation_details Pulls all specific information for a single, known reservation ID. ### list_reservation_folios Retrieves a list of financial billing folios associated with a specific reservation. ### list_reservations_by_date Gathers and lists all reservations that are scheduled to check in or stay on one particular day. ### list_room_types Lists every configured room type the hotel offers (e.g., King Suite, Double Room). ### list_all_rooms Lists every physical room in the hotel and its current metadata (ID, type). ### update_room_status Changes the operational status of a specific physical room to Clean, Dirty, or Out of Order. ## Prompt Examples **Prompt:** ``` Check room availability in my Softinn hotel from 2024-06-01 to 2024-06-05. ``` **Response:** ``` Searching Softinn booking engine... I've found 3 available room types for those dates: 1. Deluxe Suite (2 left, RM 350/night), 2. King Room (5 left, RM 280/night), 3. Single Economy (1 left, RM 150/night). Would you like to create a reservation? ``` **Prompt:** ``` Show me the arrival list for today. ``` **Response:** ``` Retrieving reservations for 2024-04-12... I found 4 arrivals: 1. John Doe (Res: #12345), 2. Jane Smith (Res: #12346), 3. Robert Brown (Res: #12347), 4. Alice White (Res: #12348). All rooms are currently assigned. ``` **Prompt:** ``` Update the status of room 302 to 'Clean'. ``` **Response:** ``` Connecting to Softinn PMS... I've successfully updated Room 302 (ID: rm_302) to status: 'Clean'. The change is now visible across all property dashboards. ``` ## Capabilities ### Check and manage room availability The system searches for vacant rooms across the hotel based on specified dates, returning available types and quantities. ### Create new guest bookings It takes reservation parameters (dates, guests, type) and automatically generates a new booking record in Softinn's system. ### Update room status for housekeeping You can change the status of a specific physical room—marking it Clean, Dirty, or Out of Order—to synchronize staff operations. ### View and modify guest billing records The server retrieves detailed financial folios for any reservation and allows agents to record payments against those accounts using `add_folio_payment`. ### List all hotel inventory metadata It provides an overview of the property's configuration, including room types and summary settings. ## Use Cases ### The last-minute group booking. A corporate client calls needing 10 rooms next week. Instead of manually checking the PMS, the agent runs `check_availability` for that date range and confirms three suitable room types. It then uses `create_reservation` ten times in sequence to book the entire block. ### The end-of-stay billing audit. A manager needs to verify if a guest was overcharged for minibar use. The agent first runs `list_reservation_folios`, finds the disputed charge, and then records an adjustment payment using `add_folio_payment`. ### The morning housekeeping sweep. Housekeeping finishes a section of rooms. Instead of walking to every desk, they tell their agent: 'Update all rooms 101-150 to Clean.' The agent runs `update_room_status` on the whole block instantly. ### The daily arrival report. A front desk worker needs a list of everyone arriving today. They prompt: 'Show me all arrivals for 2024-10-25.' The agent runs `list_reservations_by_date` and hands back the full, actionable manifest. ## Benefits - Eliminate manual availability checks. By running `check_availability`, your agent instantly reports open rooms for any date range—no more cross-referencing spreadsheets or calling another department just to confirm if a Deluxe Suite is free. - Automate check-ins and bookings. Instead of filling out forms, you tell the agent to 'Book John Smith for three nights in a King Room.' The system runs `create_reservation` instantly. - Keep housekeeping synced. When cleaning staff finish up, they just prompt their agent: 'Update room 302 to Clean.' The tool executes `update_room_status`, making the change visible immediately across all dashboards. - Handle billing disputes quickly. Need to know what was charged? Use `list_reservation_folios` to pull the full bill history, and then use `add_folio_payment` to record a refund or payment without touching an accounting terminal. - Gain property oversight fast. The `get_hotel_summary` tool gives you high-level data on the hotel's configuration—metadata you need for quick operational decisions without digging into deep settings. ## How It Works The bottom line is that after setting up your keys, your AI agent gains full, conversational control over Softinn's core PMS functions. 1. Subscribe to this server on Vinkius Marketplace. 2. Log into your Softinn Merchant Portal and get your API Access Key; identify your unique Hotel ID. 3. Enter the required credentials (API Key, Hotel ID) into your AI agent client. The agent can now execute tools like `check_availability` or `create_reservation`. ## Frequently Asked Questions **How do I check room availability using the Softinn MCP Server?** You use the `check_availability` tool. You just need to provide a start date and an end date; the agent returns all available types and their counts for that period. **Can I list reservations by date using Softinn MCP Server?** Yes, use `list_reservations_by_date`. This tool gathers every reservation scheduled for a specific day, giving you an immediate arrival or stay manifest. **What is the difference between list_all_rooms and list_room_types?** `list_room_types` tells you what kinds of rooms exist (e.g., King Suite, Deluxe). `list_all_rooms` lists every actual physical room ID that exists in the property. **How do I update a room's status after cleaning?** You run the `update_room_status` tool. You need to specify the exact Room ID and set the new state (e.g., 'Clean'). The change is instant across the PMS. **Does Softinn MCP Server let me add payments?** Yes, use `add_folio_payment`. You need to provide the folio ID and the payment amount; it handles recording the transaction against the guest's bill. **What setup details do I need to use the `create_reservation` tool?** You must provide your unique Softinn Hotel ID and a valid API Access Key. These credentials authenticate your agent with the PMS, ensuring that reservations are logged against the correct property. **How do I use `list_reservation_folios` to audit guest billing records?** This tool retrieves every billing folio associated with a reservation. It lets you review all charges—room, tax, services—before verifying any outstanding balances or processing payments using `add_folio_payment`. **What should I do if the `update_room_status` command returns an error?** The error message tells you exactly why the status change failed. It might indicate a conflict with another tool call or that the room is currently locked, so check the details and adjust your workflow. **How do I obtain a Softinn API Key?** Softinn restricts API access to registered merchants. You must reach out to their support team at support@mysoftinn.com to request an API key for your specific property. **Can my AI automatically update room statuses for cleaning?** Yes! Use the `update_room_status` tool with the specific Room ID and the target status (e.g., 'Clean', 'Dirty'). Your agent will synchronize the change with the PMS instantly. **Does it support real-time availability searching?** Absolutely. The `check_availability` tool queries the live booking engine to find vacant rooms between any two dates for your hotel.