# Preno MCP

> Preno connects your entire property management system to your AI agent. It handles everything from checking room availability and listing all bookings to creating new guest profiles and pulling payment records. Manage hotel operations through natural conversation, no dashboards required.

## Overview
- **Category:** erp-operations
- **Price:** Free
- **Tags:** booking-management, hotel-management, guest-services, occupancy-tracking, hospitality-tech

## Description

**Preno MCP Server: Your Hotel Ops Command Center.**

You don't need to stare at clunky dashboards or learn a new piece of software just to manage your hotel. Preno connects your entire property management system directly to your AI agent, letting you handle everything—from checking room availability and pulling payment records to creating brand-new guest profiles—all through natural conversation. It's about talking shop with your agent, period.

**System Health Check.**

Before anything else, you can check the system's heartbeat using `check_preno_status`. That confirms the connection between your AI client and Preno’s API is solid, so you know your commands are actually going through. You can also use `list_preno_agents` to see all the Online Travel Agencies (OTAs) and booking agents tied to your property.

**Managing Reservations.**

When it comes to bookings, you've got deep control. To pull up a specific guest stay, you run `get_preno_booking`, which hands over the full metadata and status for that single booking ID. If you need to know everything happening across your whole portfolio, `list_preno_bookings` grabs a complete list of multiple existing reservations. Need to book something new? Just tell it to; `create_preno_booking` generates a brand-new reservation record in the system.

**Handling Guests and Profiles.**

Your guests' data is right here. You can run `list_preno_guests` to pull up a list of property visitors, giving you the option to filter that list by name or email address. For one specific person, use `get_preno_guest`; it pulls every piece of info and stay history for that single guest profile. If someone new shows up who isn't in your system yet, `create_preno_guest` adds a completely fresh profile to your database.

**Inventory and Rates.**

You gotta know what you're selling. You can list every available room category using `list_preno_room_types`, which displays all inventory details along with current pricing information. If you only need the deets on one specific room type—like finding out exactly what a 'King Suite' costs right now—`get_preno_room_type` pulls that detailed info for you.

**Financial Tracking.**

Keeping track of the money is crucial. To pull up a record of all recorded financial payments and transactions, run `list_preno_payments`. It gives you a full list of every payment entry across the property's books. You manage these operations through natural language; no dashboard diving required.

## Tools

### list_preno_agents
Lists all connected Online Travel Agencies (OTAs) and booking agents for your property.

### list_preno_bookings
Retrieves a list of multiple existing bookings across the entire property portfolio.

### create_preno_booking
Creates a new reservation record for a guest stay in the property management system.

### create_preno_guest
Adds a completely new profile for an individual visitor to your guest database.

### get_preno_booking
Retrieves full details and status metadata for one specific booking ID.

### get_preno_guest
Pulls the complete profile and stay history data for a specified guest.

### get_preno_room_type
Retrieves detailed information about a specific room type, including rates.

### list_preno_guests
Lists property guests, allowing optional filtering by name or email address.

### list_preno_payments
Retrieves a list of all recorded financial payments and transactions for the property.

### list_preno_room_types
Lists every available room category type, showing inventory details.

### check_preno_status
Checks the current API connection status between your AI client and Preno.

## Prompt Examples

**Prompt:** 
```
List all active bookings and show their arrival status.
```

**Response:** 
```
I've retrieved your bookings. You currently have 15 active high-fidelity reservations, including 'John Doe' (Checked In) and 'Sarah Smith' (Expected). Would you like to see the detailed guest metadata for any of them?
```

**Prompt:** 
```
Create a new booking for guest 'John Doe' arriving tomorrow for 3 nights.
```

**Response:** 
```
Reservation orchestrated! I've successfully generated a new high-fidelity booking for 'John Doe' (ID: res_456) for 3 nights. This record is now live in Preno. Shall I verify the available room technical types for assignment?
```

**Prompt:** 
```
Check the last 5 payments recorded today.
```

**Response:** 
```
Transaction directory orchestrated! I've identified 5 recent high-fidelity payment profiles, including one for 'Deluxe Suite' ($450). Your API connection is healthy. Shall I retrieve the detailed financial alignment metadata for today's transactions?
```

## Capabilities

### Check system health
Verifies the connection between your AI client and Preno's API.

### Create new reservations
Generates a brand-new booking record in Preno for a guest stay.

### Create guest records
Adds a completely new profile for a visitor to your system.

### Get specific reservation details
Retrieves the full metadata and status of one existing booking.

### Get guest profile data
Pulls all available information for a single, specified guest.

### List property reservations
Retrieves a list of multiple bookings across your entire portfolio.

### List room categories and rates
Displays the full directory of available room types and associated pricing information.

## Use Cases

### Checking pre-arrival status for a group.
A manager needs to know who's arriving next week and if their current bookings are confirmed. They ask the agent, 'List all bookings for next week.' The agent uses `list_preno_bookings` and filters the results by arrival date, giving an immediate status report on every stay.

### Handling a walk-in guest request.
A front desk lead has a last-minute walk-in. They ask the agent to 'Check room availability for 3 nights.' The agent runs `list_preno_room_types` and reports available inventory, allowing them to immediately run `create_preno_booking` using the best rate.

### Auditing last month's revenue.
A revenue manager needs to confirm a specific client paid their deposit. They prompt the agent with 'Show payments for Client X.' The agent uses `list_preno_payments` and returns the exact transaction details, solving the manual ledger check.

### Onboarding new staff members.
A supervisor needs to quickly train a new employee. They ask the agent, 'What's our current list of connected booking channels?' The agent uses `list_preno_agents` and provides the full list of OTAs, saving hours of manual documentation review.

## Benefits

- Stop jumping between tabs. You can list all bookings using `list_preno_bookings` and immediately access detailed guest notes via `get_preno_guest`, all in one conversation thread.
- Financial tracking gets simpler. Instead of running reports, just ask your agent to pull recent payments using `list_preno_payments`. You get the data instantly for auditing or reconciliation.
- Booking adjustments are fast. Need a new room? Run `create_preno_booking` and specify dates/guests. The record is live without you touching the PMS interface.
- Room inventory is always current. Use `list_preno_room_types` to see every rate card and category type instantly, helping revenue managers optimize pricing on the fly.
- Operational checks are instant. If you're unsure if your API connection works, run `check_preno_status`. It tells you right away if everything is healthy for high-volume transactions.

## How It Works

The bottom line is: Your agent acts like an internal property coordinator, running complex backend queries through simple chat prompts.

1. Subscribe to this server on Vinkius. Then, pull your Preno API Key from Settings > API Access.
2. Connect that key to your preferred AI client (Claude, Cursor, etc.).
3. Use natural conversation to run tasks—like 'List all bookings for next week' or 'Create a new guest profile'.

## Frequently Asked Questions

**How do I check the API status using check_preno_status?**
Run `check_preno_status` to verify if your AI client is connected properly. It confirms that Preno's APIs are available and ready for you to start making booking or guest calls.

**What does list_preno_bookings do?**
`list_preno_bookings` pulls a list of all current bookings. You can then specify filters, like 'Show me only active reservations for this month,' to narrow down the results.

**Can I create a new guest profile using create_preno_guest?**
Yes, `create_preno_guest` adds a brand-new person's record to your system. This is useful when you deal with walk-ins or partners who haven’t booked through the main channel.

**I need to know room rates; what tool do I use? list_preno_room_types?**
`list_preno_room_types` lists all available categories and their current rate metadata. It gives you the full picture of your inventory without needing a specific booking ID.

**How do I see past payments with list_preno_payments?**
`list_preno_payments` retrieves a log of financial transactions. You can filter this by date range or client name to quickly audit revenue streams.

**I know the booking ID; how do I retrieve all specific details for a single reservation using get_preno_booking?**
It pulls the complete record history for that one booking. You'll see check-in/check-out dates, guest names, and associated room types—all in one place.

**If I only know a guest’s email or name, how do I search for their profile using list_preno_guests?**
You pass the name or email into the tool. It returns all matching property guests, letting you confirm their stay history without knowing their ID.

**How do I check which Online Travel Agencies (OTAs) are connected to my property using list_preno_agents?**
This tool lists every agent and OTA currently linked to your Preno account. It’s useful for auditing connectivity or seeing what channels might be affected by an outage.

**How do I find my Preno API Key?**
Log in to your account, navigate to **Settings** > **API Access**, and copy your unique high-fidelity **API Token**.

**Can I check room availability via AI?**
Yes! The `list_preno_room_types` tool allows your agent to retrieve high-fidelity configuration and availability metadata for all room categories.

**How do I list my property's guests?**
Use the `list_preno_guests` tool to retrieve the complete high-fidelity directory of guest profiles along with their unique identifiers for precise orchestration.