# BoxLock MCP > BoxLock manages secure package deliveries and physical access using smart locks. Connect this MCP to your AI client, and you gain control over every lock in your organization. Your agent can check battery levels, track assets via barcodes, authorize temporary openings, and provide a full audit trail of who accessed what, right from your conversation. ## Overview - **Category:** security-compliance - **Price:** Free - **Tags:** smart-lock, access-control, logistics-security, package-delivery, remote-monitoring, physical-security ## Description Managing physical sites used to mean logging into multiple dashboards just to know if the loading dock was accessible or how many locks had low batteries. Now, you can treat your entire network of smart boxes like an extension of your agent. You talk through your AI client and tell it what needs doing—from tracking a specific barcode asset to remotely authorizing access for a maintenance crew. If you're looking at Vinkius for physical security tools, this is one of them. Your agent handles the logistics coordination: listing all locks, checking their status, or pulling up detailed activity logs showing every time a door opened or was scanned. It cuts out the manual process entirely. ## Tools ### get_lock Retrieves specific details about a single BoxLock smart lock. ### list_activities Pulls comprehensive records of all access events for the locks. ### list_barcodes Lists every active barcode used to track physical assets. ### list_locations Provides a directory of all known organizational sites and groups. ### list_locks Retrieves the status, battery level, and count of every smart lock in your account. ### list_users Lists all user accounts configured within the organization's system. ### press_to_open Remotely authorizes a specific lock to be opened via a physical button press. ## Prompt Examples **Prompt:** ``` List all active smart locks in my organization. ``` **Response:** ``` I've retrieved your smart locks. You currently have 5 active devices, including 'Front Gate' (Battery: 85%) and 'Loading Dock B'. Which one would you like to inspect for activity logs? ``` **Prompt:** ``` Authorize 'Loading Dock B' (ID: 'lock_123') to be opened for worker '101' for the next hour. ``` **Response:** ``` Remote opening authorized! The lock 'Loading Dock B' can now be opened when the physical button is pressed by worker 101. The authorization expires in 60 minutes. Shall I monitor for the opening event? ``` **Prompt:** ``` Show the last 5 access events for all locks from today. ``` **Response:** ``` Accessing audit logs... Today's last 5 events include 3 successful openings at 'Warehouse West' and 2 barcode scans for asset 'P-500'. All interactions were within high-fidelity norms. Need more historical context? ``` ## Capabilities ### Check and manage physical lock inventory Get a complete list of all smart locks, along with their current battery levels and connectivity status. ### Authorize remote package access Temporarily grant permission to open a specific lock for designated personnel or maintenance workers in real time. ### Audit physical entry history Review detailed logs of all opening events and scans to maintain an accurate, high-fidelity record of who was on site and when. ### Track assets using barcodes Access a directory of trackable items and list any associated barcodes for coordinated digital ledger maintenance. ### Map out physical infrastructure Retrieve directories of all organizational locations, helping coordinate site-specific security measures. ## Use Cases ### The delivery driver needs immediate access verification. A package arrives at a facility. Instead of calling security, the agent checks the status using `get_lock` and then executes `press_to_open`, letting the authorized worker open the lock when they arrive. ### Security needs to investigate a suspected breach. The coordinator uses `list_activities` to pull up the last 24 hours of logs, quickly isolating unusual access patterns and identifying which user account was involved. ### Facilities team plans a major renovation. They use `list_users` alongside `list_locations` to verify that all required personnel have the correct permissions assigned across every physical site before construction starts. ## Benefits - Stop manually checking lock status. You can use `list_locks` to instantly get the battery health and connectivity status for every device in your network. - Streamline site coordination by using `list_locations` to pull up directory information, helping you manage security across different physical groups. - Keep a perfect record of activity. Use `list_activities` to build high-fidelity audit trails that show exactly who accessed what and when. - Authorize access without sending emails. You can use `press_to_open` to grant temporary remote authorization for specific workers or maintenance windows. - Coordinate goods tracking by listing barcodes with `list_barcodes`, ensuring your digital ledger matches your physical inventory count. ## How It Works The bottom line is that instead of opening separate apps for inventory, access logs, and location maps, you ask one AI client to do it all. 1. First, subscribe to this MCP and grab your API Key from your BoxLock Control dashboard. 2. Next, connect your AI client using that key. Your agent now has access to all the lock status and location data. 3. Finally, give your agent a command, like 'List all locks in the West Warehouse.' It talks to the system and gives you the real-time operational answer. ## Frequently Asked Questions **How do I check the battery life using get_lock?** The `get_lock` tool provides real-time details, including the current battery percentage for that specific lock. This lets you preemptively know which devices need maintenance. **Can list_activities show me who entered the building last week?** Yes. `list_activities` pulls historical records of openings and scans. You can ask for a specific date range to narrow down who accessed the site and when. **What is the difference between list_locks and get_lock?** Use `list_locks` if you want an overview of *all* devices in your account. Use `get_lock` when you know the specific lock ID and only need details on that single device. **How do I remotely grant access using press_to_open?** You use `press_to_open`, passing the required JSON data. This sends a temporary authorization signal to the lock, allowing it to open when the physical button is pressed. **How do I use list_barcodes to generate a full inventory of trackable assets?** It returns a complete directory of every active barcode in your system. This lets you build a perfect digital ledger by accessing all associated physical goods, not just the ones that have been scanned recently. **What does list_locations show me about my overall facility structure?** The tool retrieves a complete directory of your monitored physical sites and groups. This lets you coordinate infrastructure security across multiple buildings or departments without knowing their specific names beforehand. **Can I use list_users to manage worker permissions and check account status?** Yes, it provides a comprehensive directory of all organization users. You can programmatically verify who is currently authorized in the system or check user-specific roles before granting access. **If I run list_locks, how do I get status updates for multiple devices at once?** The tool lists all smart locks and provides essential metrics like battery levels and connectivity status upfront. This lets you quickly assess the health of your entire network from one command. **How do I find my BoxLock API Key?** Log in to your BoxLock Control account, navigate to **Settings** > **Developer API**, and generate a new v3 Bearer Token. **Can I open a lock remotely via AI?** Yes! The `press_to_open` tool allows you to authorize the physical button on a lock to be active for a specific worker and reason programmatically. **How do I check battery levels?** Use the `list_locks` or `get_lock` tools to retrieve real-time metadata including current battery percentage and signal strength for every device.