# StayFi MCP > StayFi connects your AI agent to your vacation rental network, giving it 17 tools to manage WiFi properties, gather guest data, and track marketing analytics. It pulls real-time router health status, captures emails and phone numbers from captive portals, and gives you a full overview of performance across multiple properties. ## Overview - **Category:** marketing-automation - **Price:** Free - **Tags:** wifi-marketing, guest-capture, email-marketing, vacation-rentals, splash-pages, device-monitoring ## Description StayFi hooks your AI agent up to your entire vacation rental network. You get seventeen tools that manage WiFi properties, pull guest data, and track marketing numbers across every single location you own. It’s built for real-time monitoring—you can check router health, capture emails from captive portals, and see performance across multiple units without leaving your agent. **Managing Guest Contacts** You never gotta manually dig up guest info again. You've got tools to find, list, search, and export all the contact details. Use `list_guests` to pull a comprehensive list of every profile recorded in the system. Need to narrow it down? Run `list_guests_by_property` for only those who stayed at one specific location. If you know some identifying info—like name or email—use `search_guests` to zero in on profiles. To get full details, use `get_guest` with identification data. You can pull and export all the guest contact data using **`export_guests`**, making it ready for whatever spreadsheet program you’re running. **Monitoring Network Infrastructure Health** You know your business runs on reliable tech, so these tools keep tabs on everything. Start by checking the overall system connection status with **`check_stayfi_status`**. For hardware inventory, use `list_devices` to see every piece of equipment connected. Want to check if a specific router is running right? Use **`get_device_status`** for that. You can monitor all active WiFi networks by calling `list_networks`, and then get detailed info on any setup using **`get_network`**. If you want to see every property unit managed under the account, run `list_properties`. To drill down into one location's specifics, use **`get_property`**; for usage stats and key performance indicators specific to a rental, call **`get_property_stats`**. **Analyzing Marketing Performance Metrics** These tools turn your network into an actual marketing asset. You can retrieve an overview of how well your portfolio is performing using **`get_analytics`**. To see how many emails you've grabbed and what the collection rate looks like, use **`get_email_stats`**. For managing the login portals, you can list all configured splash pages with `list_splash_pages`, or grab the current content of an active page using **`get_splash_page`**. You can also get specific details and operational info for a single rental unit using **`get_property`**. **Putting It All Together** When you need to see what's going on, your AI agent has the full picture. Use `list_properties` to list every available unit, which gives context when pulling stats. You don’t gotta guess if a guest is there; use **`list_guests_by_property`** combined with **`get_property`** for surgical data retrieval. The sheer scope of these tools means you can verify everything from the system health to individual user profiles, making sure your marketing funnel stays clean and full. You just connect your agent to StayFi on Vinkius. Your agent then uses its 17 specific functions—from **`list_devices`** tracking hardware failure points to **`export_guests`** pulling usable client lists—to handle the whole operation for you. ## Tools ### check_stayfi_status Verifies the overall connection status of your StayFi network system. ### export_guests Pulls and exports all collected guest data into a usable format. ### get_analytics Retrieves an overview of marketing performance metrics across your portfolio. ### get_device_status Checks the current operational status for a specific piece of hardware equipment. ### get_email_stats Gets detailed statistics on how many emails were collected and the overall rate. ### get_guest Retrieves specific details for a single guest using identification data. ### get_network Pulls detailed information about the WiFi network setup at a property. ### get_property_stats Retrieves key performance indicators and usage statistics for a property. ### get_property Gets specific details and operational info for one rental unit. ### get_splash_page Gets the current content or configuration of an active WiFi splash page. ### list_devices Lists all hardware devices connected to your StayFi network for inventory tracking. ### list_guests_by_property Lists only the guests who stayed at a specific property location. ### list_guests Retrieves a comprehensive list of every guest profile recorded in the system. ### list_networks Returns a list of all active WiFi networks monitored by StayFi. ### list_properties Lists every rental unit or property managed under the account. ### list_splash_pages Returns a list of all custom splash pages configured across your properties. ### search_guests Finds specific guest profiles using name, email, or other available search parameters. ## Prompt Examples **Prompt:** ``` Show all guests captured via WiFi at our beach property this week. ``` **Response:** ``` I've fetched the guest list for 'Oceanview Villa'. You've captured 15 new guest profiles this week, including 15 emails and 12 phone numbers. Would you like me to export this list for your next email campaign? ``` **Prompt:** ``` Are all StayFi routers online and functioning correctly? ``` **Response:** ``` Running a diagnostic check... 23 out of 24 routers are currently online and broadcasting. However, the router at 'Mountain Cabin' has been offline for 2 hours. Should I pull the troubleshooting details for that specific device? ``` **Prompt:** ``` What is our email collection rate across all properties for the current month? ``` **Response:** ``` Fetching your collection stats... This month, your portfolio has collected 342 new emails with an average opt-in rate of 68% across all splash pages. 'Downtown Loft' is your highest-performing property with 85 new contacts. ``` ## Capabilities ### Collect and Organize Guest Contacts The agent can find, list, search, and export all guest contact details (emails, phones) from connected properties. ### Monitor Network Infrastructure Health You check the live status of all hardware devices, individual routers, and overall network connectivity across your portfolio. ### Analyze Marketing Performance Metrics The agent retrieves aggregated analytics data, including total emails collected and opt-in rates for specific periods or properties. ### Manage Property Details and Portals You list, retrieve details for, and manage the custom splash pages and overall statistics for individual rental units. ## Use Cases ### Need to run an email blast for last-minute bookings. The Property Manager needs every lead from the past quarter. They ask the agent to 'Gather all contacts from the Downtown and Beach properties.' The agent runs `list_guests_by_property` twice, then uses `export_guests`. It returns a clean CSV file containing 200+ emails ready for immediate campaign use. ### The network at a specific cabin is acting up. A guest reports slow WiFi. The Ops Engineer asks the agent to check the status of that site. The agent runs `get_device_status` and gets back that the main router has low signal strength, not that it's powered off. This pinpoints a hardware issue versus a simple outage. ### Comparing marketing performance across different units. The Digital Marketer wants to know if their new landing page works better than the old one. They ask the agent for 'Email collection stats comparison.' The agent runs `get_email_stats` and returns a side-by-side metric showing that Unit A's rate is 15% higher, proving which marketing funnel should get more focus. ### Investigating historical guest behavior. A manager suspects repeat visitors are leaving contacts behind. They ask the agent to 'List all guests who stayed at this property last year.' The agent runs `list_guests_by_property` for a specific date range and gives them a full, searchable list of past patrons. ## Benefits - Get a full list of contacts using `export_guests`. Instead of manually exporting data from multiple dashboards, your agent pulls all collected emails and phone numbers into one structured dataset for CRM use. This saves hours of copy-pasting across properties. - Identify network problems before they hit the guest. Run `check_stayfi_status` or `get_device_status` to see if a router is offline or failing. You get immediate alerts on hardware failure, allowing you to dispatch maintenance proactively. - Know what your marketing efforts are worth. The `get_analytics` tool aggregates data across the entire portfolio, showing exactly which properties yield the highest opt-in rate and total lead count for the month. - Manage guest flow through custom web pages. Use `list_splash_pages` to see what's active, then let your agent update or check the content of a specific page using `get_splash_page` without touching the portal settings directly. - Segment and find guests quickly. Don't scroll through thousands of names. The `search_guests` tool lets you pinpoint a single guest profile based on partial details, letting you confirm their history or contact info immediately. ## How It Works The bottom line is: Your agent talks directly to StayFi, getting real-time property and guest data without you ever needing to log into a separate dashboard. 1. Subscribe to this server on Vinkius. 2. Enter your StayFi API Key (found in your provider dashboard). 3. Your AI agent uses the tools to manage network marketing tasks through Vinkius. ## Frequently Asked Questions **How does the StayFi MCP Server help with marketing data?** It helps by running `get_email_stats` to pull detailed metrics on email collection rates. You can also use `export_guests` to get a clean, exportable list of all contacts for your next campaign. **What is the difference between `list_devices` and `check_stayfi_status`?** `check_stayfi_status` gives you a high-level 'is it working?' check. `list_devices` gives you an inventory list of every single piece of hardware (router, access point) connected to the system. **Can I find all guests who stayed at one specific location?** Yes. Use the `list_guests_by_property` tool. You just need to specify the property ID, and it filters out every other unit's data. **How do I get detailed information about a single guest?** Run `get_guest` with their unique identifier. It pulls up a structured object containing all known details for that specific person, like phone number and stay history. **How do I export guest contact information using `export_guests`?** The tool exports a comprehensive CSV file containing all captured data. This lets you segment lists and send them directly to your CRM for targeted email campaigns or follow-up outreach. **What does the `list_splash_pages` command reveal about my current setup?** It returns a list of all configured splash page URLs along with their unique IDs. You can quickly check which pages need content updates or if any old links remain active. **If I want to compare two properties, how do I use `get_property_stats`?** Run the tool for each property ID you want to compare. The output provides specific metrics like check-in counts and total data captures, letting you measure performance differences. **What information can I gather about my WiFi infrastructure using `list_networks`?** The tool lists every active SSID and its associated hardware ID across your portfolio. This confirms that all planned network points are online and properly identified by the system. **How can my AI retrieve the list of guests who connected to the WiFi at a specific property?** Simply use the `get_property_guests` tool providing the specific property ID. Your agent will instantly compile a list of all guests captured via the captive portal, including their names, emails, and phone numbers. **Can I automatically check if all my routers are online across my portfolio?** Yes! Ask the agent to run the `check_router_health` action. It will scan all your StayFi routers in real-time and report back any offline devices, ensuring your guest networks are always functional. **Is it possible to track the total number of emails collected this month?** Absolutely. By utilizing the `get_collection_stats` tool, your agent can instantly fetch the email collection analytics across all properties, giving you an immediate view of your marketing data growth.