# Softinn MCP for AI Agents AI Agent Connect > Softinn MCP connects your AI agent to your Hotel Management System. It lets you handle room bookings, check housekeeping statuses, and manage guest folios without leaving your chat interface. It's built for property managers who want to talk to their PMS instead of clicking through dozens of tabs to find a vacant room or update a guest's bill. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_VLY5IHVUGC84LOVIUahmAGF8VRRhkNofmK4NAyTq/ai-agent-connect - **Tags:** softinn-pms, hotel-management, booking-engine, reservation-system, inventory-sync, guest-folios, housekeeping-app ## Description Managing a hotel involves a lot of jumping between different screens. You have to check if a room is clean, see if a guest has arrived, and then figure out if their balance is paid. This Connector changes that by giving your AI agent a direct line into your Softinn property operations. You can ask your agent to find a vacant room for a guest arriving tomorrow or tell it to mark a suite as clean so it's ready for the next check-in. It handles the heavy lifting of searching for availability, creating new bookings, and updating room statuses in real-time. It even lets you pull up billing folios and record payments on the fly. By connecting this to the Vinkius catalog, you get a way to manage your property through a natural conversation. Instead of manual data entry, your agent does the work, keeping your inventory accurate and your guests happy. It's about moving from managing a software to actually managing your hotel. ## Tools ### add_folio_payment Record a payment against a guest folio. You can log a payment as soon as a guest hands over their card. ### check_availability Search for available rooms in the hotel. This helps you see what's open for specific dates instantly. ### create_reservation Create a new guest reservation. You can book a room for a guest just by describing the dates and room type. ### get_hotel_summary Get an overview of the hotel configuration. Use this to quickly see high-level property metadata. ### get_reservation_details Get details for a specific reservation. This pulls up all the info for a single booking in one go. ### list_reservation_folios Retrieve billing folios for a reservation. You can see exactly what a guest owes without opening their specific file. ### list_reservations_by_date List all reservations for a specific date. This is perfect for generating a quick arrival or departure list. ### list_room_types List all configured room types for the hotel. Use this to see what kinds of rooms you have available to sell. ### list_all_rooms List all physical rooms and their current metadata. This gives you a full inventory of every room and its current state. ### update_room_status Update the housekeeping or occupancy status of a room. Use this to mark rooms as clean, dirty, or out of order instantly. ## Prompt Examples **Prompt:** ``` Check if we have any Deluxe Suites available for next Friday. ``` **Response:** ``` ### Softinn Availability Search I've checked the inventory for next Friday. Here is what we have available: | Room Type | Remaining | Price per Night | | :--- | :--- | :--- | | **Deluxe Suite** | 2 | $350 | | **King Room** | 5 | $280 | | **Single Economy** | 1 | $150 | Would you like me to book one of these for you? ``` **Prompt:** ``` Show me the arrival list for today. ``` **Response:** ``` ### Today's Arrivals I found 4 arrivals scheduled for today: * **John Doe** (Res: #12345) - Room Assigned * **Jane Smith** (Res: #12346) - Room Assigned * **Robert Brown** (Res: #12347) - Room Assigned * **Alice White** (Res: #12348) - Room Assigned All guests have been assigned to their rooms. ``` **Prompt:** ``` The guest in room 302 just paid their full balance of $450. ``` **Response:** ``` ### Payment Recorded I've successfully updated the folio for Room 302. * **Status:** Paid in Full * **Amount:** $450.00 * **Reference:** Payment logged via agent. The guest's balance is now zero. ``` ## Capabilities ### Find vacant rooms Search for open rooms based on specific dates to see what is available for booking. ### Book guest stays Create a new reservation for a guest just by describing the dates and room type. ### Monitor room occupancy View a full list of physical rooms and their current metadata to track your inventory. ### Update housekeeping status Change a room's status to clean, dirty, or out of order instantly. ### Manage guest billing Retrieve billing folios for specific reservations to see what guests owe. ### Record guest payments Log a payment against a guest's folio as soon as they pay their bill. ## Use Cases ### Handling a walk-in guest A guest walks in and the receptionist asks the agent to check availability and create a reservation on the spot using check_availability and create_reservation. ### Syncing housekeeping status A housekeeper finishes a room and the manager tells the agent to update the status to Clean so it's ready for the next guest using update_room_status. ### Generating an arrival list A manager asks for a list of all arrivals for today to prep the front desk using list_reservations_by_date. ### Logging a guest payment A guest pays their final bill, and the staff member tells the agent to record the payment against the folio using add_folio_payment. ## Benefits - Stop clicking through tabs to find room availability by using check_availability. - Book guests instantly via create_reservation without manual data entry. - Keep housekeeping in sync by using update_room_status to mark rooms ready. - View daily arrival lists faster with list_reservations_by_date. - Handle guest billing accurately by using list_reservation_folios and add_folio_payment. - Get a bird's-eye view of your property with get_hotel_summary. ## How It Works The bottom line is you get a natural language interface for your entire hotel management system. 1. Subscribe to this Connector on the Vinkius catalog. 2. Log in to your Softinn Merchant Portal to request your API Access Key from support. 3. Enter your credentials and unique Hotel ID into your AI client to start managing your property. ## Frequently Asked Questions **Can I use the Softinn MCP to book rooms?** Yes, you can use it to create new reservations for guests by simply describing the dates and room types in your chat. **How does Softinn MCP help with housekeeping?** It allows you to update room statuses like Clean, Dirty, or Out of Order instantly, ensuring your team always knows which rooms are ready. **Can I see guest bills with Softinn MCP?** Yes, you can retrieve billing folios for specific reservations to see exactly what a guest owes or has paid. **Does Softinn MCP work for multi-property management?** Yes, you can manage different properties by providing your unique Hotel ID within your credentials. **Can I use Softinn MCP to check room availability?** Yes, you can ask your agent to search for vacant rooms on specific dates to see what's available for booking. **How do I get my API key for Softinn MCP?** You need to log in to your Softinn Merchant Portal and contact their support team to request your unique API Access Key. **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.