# HirePOS MCP > HirePOS manages your entire equipment rental business using natural conversation. It tracks inventory, handles customer records, creates bookings, and processes invoices for any physical asset rental operation. Connect to manage everything from availability checks to overdue tracking without opening the POS system. ## Overview - **Category:** ecommerce - **Price:** Free - **Tags:** equipment-rental, booking-management, inventory-tracking, invoicing, rental-business, asset-management ## Description This MCP connects your rental operations directly to your HirePOS account. You can talk to it like you're talking to a seasoned ops manager. Need to know if the excavator is free next Tuesday? Just ask. Want to see who owes money or check on items that are overdue? It pulls that data for you. You can list all existing customers, get specific profiles with full rental history, and even build new customer records right from your agent. Setting up this MCP takes minutes through Vinkius and gives you immediate control over bookings, inventory levels, and financial records without ever opening the core POS software. ## Tools ### check_item_availability Determines if a specific piece of equipment can be rented for given dates. ### check_hirepos_status Verifies that your connection to HirePOS is working correctly. ### create_customer Adds a brand-new customer profile to the system. ### create_hire Generates and logs a new rental booking record. ### get_customer Retrieves detailed information for a specific customer profile. ### get_hire Pulls all the details for one particular rental booking. ### get_invoice Fetches the full contents and line items of a specific invoice. ### get_item Retrieves detailed specs and information about a single piece of equipment. ### list_availability Provides a comprehensive list of what's available over a certain date range. ### list_categories Lists all the item categories used to organize your inventory. ### list_customers Generates a list of every customer currently in your database. ### list_hires_by_status Filters the list of hires to show only those matching a specific status, like 'active' or 'returned'. ### list_hires Presents an overview of all current and past rental bookings. ### list_invoices Lists all invoices and provides key details like amounts and payment statuses. ### list_items_by_category Filters the entire inventory list to show only items belonging to a specific category. ### list_items Shows a general listing of every item tracked in your inventory. ### list_overdue_hires Specifically lists all rentals that have passed their due return date. ## Prompt Examples **Prompt:** ``` Show all overdue rentals and the customer details for each. ``` **Response:** ``` 3 overdue rentals found. 1) Hire #1045 — 'Excavator CAT 320' rented by BuildCo Pty Ltd (John Smith, john@buildco.com). Due: Apr 20, 2025 (6 days overdue). Daily rate: $450. Estimated late fee: $2,700. 2) Hire #1052 — '2x Concrete Mixers' rented by QuickBuild (Mike Torres). Due: Apr 23 (3 days overdue). 3) Hire #1058 — 'Scaffolding Set A' rented by HomeReno Inc (Sarah Chen). Due: Apr 25 (1 day overdue). Total overdue value: $4,350 in pending late fees. Would you like to view invoices or check these customers' profiles? ``` **Prompt:** ``` Check if the pressure washer is available next week and create a booking for BuildCo. ``` **Response:** ``` Availability check: 'Pressure Washer 3000 PSI' (item_089) — Available Apr 28 to May 2 ✅. No conflicting bookings. Daily rate: $95. Booking created! Hire #1061, Customer: BuildCo Pty Ltd (cust_012), Items: Pressure Washer 3000 PSI, Period: Apr 28 – May 2 (5 days), Total: $475. Status: Confirmed. Invoice will be generated on return. Would you like to check other equipment availability or view BuildCo's rental history? ``` **Prompt:** ``` List all invoices with unpaid status and the rental items from the 'Power Tools' category. ``` **Response:** ``` Unpaid invoices: 5 outstanding. 1) INV-2089 — BuildCo, $1,350 (Hire #1045, Excavator). 2) INV-2091 — QuickBuild, $540 (Hire #1052, Mixers). 3) INV-2094 — HomeReno, $280 (Hire #1058, Scaffolding). 4) INV-2095 — GardenPro, $190 (Hire #1060, Mower). 5) INV-2096 — CleanCrew, $475 (Hire #1061, Pressure Washer). Total outstanding: $2,835. Power Tools category: 8 items. Available: Circular Saw ($35/day), Angle Grinder ($25/day), Impact Driver ($20/day), Jigsaw ($15/day). On hire: Drill Press, Router, Planer, Belt Sander. ``` ## Capabilities ### Manage Bookings Create new rentals or list existing ones, filtering by status like pending or overdue. ### Check Item Availability Determine if specific equipment is available for any date range you specify. ### Handle Customer Data Look up customer profiles, list all existing users, or create a new record in the system. ### Process Invoicing and History Review full invoices to check amounts and payment status, or retrieve detailed information on any specific line item. ### Track Overdue Assets Identify all rentals that passed their scheduled return date for immediate follow-up action. ## Use Cases ### Following up on late equipment A manager asks the agent: 'Who has overdue rentals?' The agent uses list_overdue_hires, providing a clean list of assets and customers needing immediate contact. This saves hours of manual follow-up calling. ### Processing end-of-day inventory reports The ops staff needs to know what's available next week. They ask the agent, 'What’s available between April 28 and May 5?' The agent calls list_items_by_category then checks_item_availability for a definitive report. ### Onboarding a new client A sales rep needs to add a big corporate account. They ask the agent to create the record, using the create_customer tool, and immediately verify their contact details with get_customer on the new profile. ### Auditing outstanding debt The finance team needs an overview of unpaid bills. They prompt the agent to list all invoices, then use the get_invoice tool for a specific ID to confirm line items and payment details. ## Benefits - Stop sifting through dashboards. You can immediately check item availability using the list_availability tool, getting a clear 'yes' or 'no' answer without navigating complex date pickers. - Reduce manual data entry for new clients. Instead of manually opening a profile, use the create_customer tool to add records and instantly build out your customer database. - Quickly manage finances. Review payments and outstanding balances by calling list_invoices, allowing finance teams to audit revenue streams faster than ever before. - Never miss a payment deadline again. The dedicated list_overdue_hires tool immediately flags every rental past its due date for follow-up. - Build structured reports instantly. You can filter bookings using list_hires_by_status, making it simple to isolate all 'pending' or 'overdue' jobs for your team. ## How It Works The bottom line is: your agent uses the established connection to speak directly to HirePOS and pull real-time business data into plain language responses. 1. Subscribe to this MCP and provide your API Key from your HirePOS account settings. 2. Connect the service using your preferred AI client, like Claude or Cursor. 3. Tell your agent exactly what you need—for example, 'Show me all overdue items for BuildCo'—and it executes the request. ## Frequently Asked Questions **Can I check if a specific item is available for a date range?** Yes. Use `check_item_availability` with the Item ID, start date, and end date (YYYY-MM-DD format) to verify if the item is free for that period. Use `list_availability` for a complete overview of all items and their current availability status. **Can I track overdue rentals that haven't been returned?** Yes. The `list_overdue_hires` tool retrieves all rentals past their return date with customer info, item details, and days overdue. Use `list_hires_by_status` with 'overdue' status for the same result, or filter by 'active', 'returned', or 'pending'. **Can I create a new rental booking through the AI agent?** Yes. Use `create_hire` with a JSON payload containing customer ID, item IDs, start date, end date, and any special instructions. Use `list_items` to browse available equipment and `list_customers` to find the customer. Use `create_customer` to add a new customer if needed. **How does the `list_customers` tool help me view a client’s full rental history?** It provides a comprehensive list of all your stored customer records. From there, you can run `get_customer` to pull up specific profiles and their entire rental activity history. **What is the best way to review all outstanding invoices using the `list_invoices` tool?** The `list_invoices` tool gives you a summary of every invoice, showing payment amounts and status. You then use `get_invoice` if you need to check specific line items or details. **Before starting, how do I confirm connectivity using the `check_hirepos_status` tool?** Running this simple check confirms your API key and connection status. It’s a quick way to make sure everything is active and ready before you start complex tasks. **If I need general item details, what should I use with the `get_item` tool?** Use `list_items` first if you want a broad overview of your entire inventory. Then, running `get_item` gives you all the specific rates and characteristics for one piece of equipment. **How do I manage my rental categories using the MCP tools?** You can browse all available item groups by calling `list_categories`. This helps organize your inventory before filtering down to specific items with `list_items_by_category`.