# Hostfully MCP > Hostfully lets you manage every aspect of a vacation rental business directly through your AI client. List properties, track incoming leads, check guest details, and monitor maintenance workers all in one place. Stop switching between different dashboards; get all your booking data and property records handled by your agent. ## Overview - **Category:** erp-operations - **Price:** Free - **Tags:** vacation-rentals, lead-management, booking-operations, hospitality-management, service-provider-tracking ## Description Your AI agent connects to Hostfully to handle the entire lifecycle of a rental property, from listing it to checking out the guests. When you start with `list_properties`, your agent pulls up every unit tied to an agency account. From there, you can investigate specific details about properties or review who owns them using `list_owners`. If someone contacts you, your agent grabs their info and checks for new leads via `list_leads` and `get_lead`. Need to know who stayed? You can list associated guests with `list_guests`. For maintenance issues, the MCP lets you view service providers through `list_service_providers`. It's built to handle all hospitality operations without you having to click through a dozen different tabs. By connecting this Hostfully MCP through Vinkius, your AI client becomes the central hub for managing everything from bookings and leads to property status. ## Tools ### get_agency Retrieves detailed information for one specific agency account. ### get_lead Pulls up the complete file and inquiry details for a single potential client. ### get_property Retrieves all specific records and data points for one rental unit. ### list_agencies Lists every agency account connected and accessible through the API key. ### list_guests Gets a comprehensive list of all recorded guests tied to an agency. ### list_leads Provides a full list of current leads and booking inquiries for the specified agency. ### list_owners Lists all registered property owners linked to an agency account. ### list_properties Generates a full roster of every unit that belongs to the specified agency. ### list_service_providers Retrieves contact and service details for all maintenance workers or cleaners registered to the agency. ### list_webhooks Lists any webhooks that have been configured and activated for an agency account. ## Prompt Examples **Prompt:** ``` List all vacation rental properties in Hostfully. ``` **Response:** ``` Fetching your property catalog... I found 5 active properties right now. The highlight is 'Sunset Villa (ID: PR-921)' which is currently available for direct bookings, while 'Downtown Loft (ID: PR-304)' remains blocked for maintenance. ``` **Prompt:** ``` Check for new leads in agency UID 'abc-123'. ``` **Response:** ``` Reviewing agency leads... You have 3 pending inquiries. Lead #409 (Jane Doe) sent an inquiry for the Beach House for next week, and Lead #412 asks about pet policies. ``` **Prompt:** ``` List all service providers for my agency. ``` **Response:** ``` Here are your service providers: 1. 'Prime Cleaners' (Housekeeping, ID: SP-01). 2. 'QuickFix Plumbing' (Maintenance, ID: SP-02). Let me know if you need to dispatch an emergency order to them. ``` ## Capabilities ### Gathering Property Details Retrieve full details on any specific rental unit using `get_property`. ### Managing Contacts and Inquiries List all potential leads and bookings for an agency, or pull up a single lead's information with `get_lead`. ### Tracking Agency Assets Pull lists of associated agencies using `list_agencies`, owners via `list_owners`, and service providers through `list_service_providers`. ### Viewing Occupancy Records Get a list of all guests connected to the agency with `list_guests`. ### Listing Available Units Pull a complete catalog of properties belonging to an agency using `list_properties`. ## Use Cases ### Onboarding a New Property A property manager needs to add a new listing. They ask their agent to run `list_properties` first to see the current catalog, then use the details to pull up owner info via `get_property`, making sure all necessary ownership records are attached before going live. ### Handling Peak Season Inquiries A booking coordinator gets swamped with inquiries. They ask their agent to check for new leads using `list_leads` and immediately review the background on a hot prospect using `get_lead`. This cuts down manual research time by hours. ### Emergency Maintenance Dispatch A unit needs immediate cleaning. Instead of calling contacts, the agent runs `list_service_providers` to get names and IDs for available cleaners, then drafts a dispatch message immediately. ### Quarterly Audit Check An agency admin has to verify all linked accounts. They use `list_agencies` first, then run through `list_owners` on each one to ensure the ownership records are current and accurate for compliance. ## Benefits - Consolidate property data: Instead of manually checking different systems for unit status, your agent can pull a full roster using `list_properties`, giving you an instant view of all available units. - Speed up lead follow-up: When a new inquiry comes in, your AI client doesn't just show the name; it uses `get_lead` to pull the entire history and details for that potential guest right away. - Track service providers efficiently: You can instantly list all registered cleaners or maintenance workers using `list_service_providers`, knowing exactly who to dispatch without searching multiple contact books. - Maintain clear ownership records: The MCP lets your agent check out every associated owner via `list_owners` and review the full guest roster with `list_guests`—all in one conversational flow. - Centralize agency oversight: Need an overview? Use `list_agencies` to manage multiple operations under one umbrella, getting a single view of all connected accounts. ## How It Works The bottom line is your AI client acts as the unified front-end for all of your property management tools. 1. Tell your AI agent what you need. For example, 'Check for all leads associated with Agency X.' 2. Your agent sends a request to the MCP's tools, pulling data on properties, leads, or guests based on your prompt. 3. The Hostfully API returns structured data that your agent interprets and presents back to you in plain language. ## Frequently Asked Questions **How do I list all properties using the Hostfully MCP?** You use the `list_properties` tool and must include an agency UID in your prompt. The agent will then return a comprehensive catalog of every unit associated with that account. **Can Hostfully MCP help me check for new leads?** Yes, running the `list_leads` tool pulls all active inquiries and bookings for your agency. Your agent can then review details on a specific lead using `get_lead`. **What information does get_agency provide?** The `get_agency` tool retrieves detailed foundational data about the entire agency account, giving you context for all other operations linked to it. **Does Hostfully MCP track maintenance workers?** Yes. You run `list_service_providers` to see a list of registered cleaners and maintenance contacts, keeping your emergency dispatch information centralized. **How do I find out who owns the properties in my agency?** Use the `list_owners` tool. It pulls all records of property owners linked to the agency account, which is crucial for compliance and record keeping.