# Home River Group MCP > Home River Group MCP connects your AI agent directly to property management functions via Entrata. Use this tool to list properties, check unit availability, track maintenance work orders, and manage resident records all in one place. It lets you automate everything from lead capture to lease tracking without switching systems. ## Overview - **Category:** real-estate - **Price:** Free - **Tags:** work-orders, unit-availability, resident-management, lead-tracking, property-maintenance ## Description This connection gives your agent full access to Home River Group’s property management data. Instead of jumping between separate portals to verify details, your AI client pulls all the necessary information into a single conversation thread. You can pull property listings and then check specific units for availability right away. Need to track maintenance? Your agent handles work orders, letting you know what's broken and who needs to fix it. Want to talk prospects? You can list leads or create new ones immediately. It’s about automating the entire lifecycle, from initial lead contact through property occupancy and resident financial records. By connecting this MCP via Vinkius, your agent becomes a single point of truth for all things related to Home River Group properties. ## Tools ### create_lead Submits a brand-new prospect or lead record to the Home River Group system. ### create_work_order Generates and submits a new maintenance work order for tracking. ### get_availability Checks the current lease availability status for units within a specific property. ### get_leads Lists all existing sales leads and prospects stored in the system. ### get_lease_info Retrieves detailed lease contract information for specific residents. ### get_ledgers Pulls financial ledger records and account statements for a resident. ### get_properties Lists all properties managed by the group, which is necessary to get PropertyIDs needed for other tools. ### get_residents Retrieves a list of residents across multiple or filtered properties. ### get_units Lists all units belonging to a specific property, requiring a valid PropertyID. ### get_work_orders Retrieves existing maintenance work orders, ideally filtered by a specific property ID. ## Prompt Examples **Prompt:** ``` List all properties managed by Home River Group. ``` **Response:** ``` I'll fetch the list of properties for you. ``` **Prompt:** ``` Check for any open maintenance requests for property ID 123. ``` **Response:** ``` I'll check the current work orders for that property. ``` **Prompt:** ``` Find all units available for lease in building 456. ``` **Response:** ``` I'll retrieve the current unit availability for you. ``` ## Capabilities ### Identify managed properties Your agent lists every property controlled by the group using `get_properties`, giving you necessary IDs for follow-up actions. ### Check unit status You can confirm if specific units are available or occupied in a given building using `get_availability`. ### Manage resident records Access detailed resident information, including lease specifics and financial ledgers for account tracking. ### Handle maintenance requests The agent tracks existing work orders or creates brand new ones using `get_work_orders` and `create_work_order`. ### Track sales prospects You can list stored leads with `get_leads`, or immediately submit a new prospect record via `create_lead`. ## Use Cases ### A prospect calls with an emergency question. The Sales Agent runs `get_properties` to confirm the building's name, then uses `get_availability` on that property ID. This confirms if the unit is occupied or available, allowing them to answer the client instantly and follow up by calling `create_lead`. ### A resident reports a plumbing issue. The Maintenance Coordinator uses `get_properties` to confirm the building ID. Then they check for existing tickets with `get_work_orders`. If nothing is open, they use `create_work_order` and log it immediately. ### Time for annual rent collection. The Property Manager needs a full view of resident finances. They first run `get_residents` to get the list, then loop through them calling `get_ledgers` on each one to prepare statements. ### Onboarding a new tenant. The Leasing Specialist confirms the unit is ready with `get_availability`. They pull the current lease terms using `get_lease_info`, then use that data to guide the resident through signing up, and finally log them as a record in the system. ## Benefits - Stop tracking lead data manually. You can list all current leads using `get_leads` or immediately create a new prospect with `create_lead`, ensuring no follow-up slips through the cracks. - Streamline property discovery. Running `get_properties` gives you the PropertyIDs; then, use that ID to check unit availability (`get_availability`) and list all associated units via `get_units` in two steps. - Keep maintenance running smoothly. You don't need multiple forms. Use `get_work_orders` to review open tickets or call `create_work_order` directly from your workflow when something breaks. - Cut through the paperwork. Need lease details? Use `get_lease_info` and `get_ledgers` together. You get a full financial picture of a resident's account history without logging into billing software. - Avoid data fragmentation. Instead of pulling property listings in one place, you can use the agent to chain requests: list properties (`get_properties`) then check residents for that specific ID (`get_residents`). ## How It Works The bottom line is: your agent coordinates multiple related actions across property listings, unit status, and resident data in one workflow. 1. First, tell your agent to locate the target property using `get_properties`. This gives you the specific PropertyID needed for all subsequent steps. 2. Next, ask it to check unit status or pull resident data. For example, checking availability with `get_availability` requires that ID from step one. 3. Finally, execute the action—be it pulling financial ledgers (`get_ledgers`), submitting a new lead (`create_lead`), or logging a maintenance issue using `create_work_order`. ## Frequently Asked Questions **How do I find all properties with the Home River Group MCP?** You use `get_properties`. This tool lists every property managed by the group, giving you the foundational PropertyIDs needed to run any other function. **Can I get financial information using get_ledgers?** Yes. The `get_ledgers` tool pulls detailed financial records and account statements for specific residents, helping you track payments and balances. **Does the create_work_order tool require a PropertyID?** Yes, it does. You must first run `get_properties` to get a valid PropertyID before submitting any work order ticket using `create_work_order`. **How do I check if a unit is ready for rent? (using get_availability)** Run `get_availability`. You need to provide the specific PropertyID and then specify the units you want checked. The result tells you exactly which units are open. **What if I find a new lead? Should I use create_lead?** Yes, `create_lead` is the correct tool. It submits a new prospect record directly into Home River Group's system for follow-up. **When I call `get_lease_info`, what specific documents or details can I retrieve for a resident?** It pulls granular lease agreements, including start and end dates, associated rental terms, and any linked amendments. This is useful when you need to check the exact contractual status of an existing tenant. **How do I use `get_work_orders` to view a maintenance history for a property?** You list all active or closed work orders by filtering the results with a specific PropertyID. This lets you track the full timeline of maintenance issues, not just current ones. **What is the best way to use `get_units` if I need an inventory count for a building?** You must provide the PropertyID first. The tool then returns a list of every unit ID and its associated status within that specific property, giving you a complete unit breakdown. **How do I get API credentials for Home River Group?** You need to log in to your Entrata instance (homeriver.entrata.com) and navigate to Setup > Company > API Access. If you don't have access, contact your system administrator. **Can I create work orders with this MCP?** Yes, you can use the create_work_order tool to submit new maintenance requests directly into the system. **Is the subdomain required?** It defaults to 'homeriver'. If your specific instance uses a different subdomain, you should provide it during setup. **Are these real-time updates?** Yes, all data retrieved and created is processed directly through the Entrata API in real-time.