# Kisi MCP > Kisi MCP connects your AI agent directly to cloud-based access control systems, allowing you to manage locks, users, and physical security settings using natural conversation. You can instantly check door statuses across multiple locations, trigger remote unlocks for emergencies, and audit who has permission to enter specific areas. ## Overview - **Category:** security-compliance - **Price:** Free - **Tags:** physical-access-control, smart-locks, cloud-security, user-management, remote-access, facility-management ## Description Managing building access used to mean logging into a dashboard, clicking through menus, and running reports—a huge time sink when you're dealing with an emergency or a simple status check. Now, your agent handles that overhead. You just tell your AI client what needs doing: 'Unlock the main entrance for the delivery crew.' The MCP executes it instantly. It gives your agent the power to handle everything from listing all doors and checking if they are online to querying complex user roles across entire organizations. All this capability is available through Vinkius, making connection simple. You can delegate tasks like reviewing who belongs to which access group or getting detailed information on a specific door without touching a web interface. ## Tools ### get_lock_details Retrieves specific operational information about a single door lock. ### get_place_details Fetches detailed configuration data for a designated physical location or site. ### list_access_groups Generates a comprehensive list of all predefined access groups used in your system. ### list_locks Lists every managed lock (door) in the facility, providing an overview of all devices. ### get_my_profile Retrieves the profile details for the user currently authenticated with Kisi. ### list_places Lists every physical place or location configured within your security management system. ### list_role_assignments Shows all active role assignments, allowing you to monitor who has what level of permission. ### unlock_door Sends an immediate command to remotely unlock a specific door lock. ### list_users Provides a complete list of all users registered in the Kisi organization for management purposes. ## Prompt Examples **Prompt:** ``` Unlock the 'Main Entrance' door (ID: '12345') in Kisi. ``` **Response:** ``` I've sent the unlock command to 'Main Entrance'. The door should now be unlocked. ``` **Prompt:** ``` List all locks that are currently offline. ``` **Response:** ``` I've checked your devices. Currently, 'Side Exit (ID: 6789)' and 'Storage Room (ID: 1011)' are reporting as offline. ``` **Prompt:** ``` Show me the details for the place 'Headquarters'. ``` **Response:** ``` I've retrieved the details for Headquarters (ID: 9876). It currently has 12 active locks and 5 access groups associated with it. ``` ## Capabilities ### Remote Door Control You send an unlock command and the assigned door opens, regardless of your physical location. ### Device Status Check The agent lists all managed locks (doors) and reports their real-time status—online/offline or locked/unlocked. ### User Profile Retrieval You ask for a person's details, and the MCP pulls their full profile information from Kisi. ### Permission Audit The system checks complex access rules by listing roles assigned to specific groups or places. ### Location Mapping You list and inspect every physical location (place) configured in your security environment. ## Use Cases ### Emergency Access Required A security guard needs immediate access to the server room and knows the door ID. Instead of calling maintenance or waiting for keycard validation, they prompt their agent: 'Unlock the Server Room door (ID: 9876).' The MCP executes unlock_door instantly. ### Weekly Compliance Audit A facilities manager needs to know which employees are currently active and what access groups they belong to. They instruct their agent to list users, followed by calling list_role_assignments to verify compliance status across the company. ### System Health Check An operations engineer suspects several doors aren't communicating. They prompt for 'list all locks', immediately seeing which devices are reporting as offline, allowing them to dispatch repair crews instantly. ### Site Expansion Planning A team needs to map out a new wing. They use list_places to see the current site structure and get details for a specific location using get_place_details before planning where new access points are needed. ## Benefits - You don't need to switch between tabs. Instead of manually checking the status of every door in a building via a web dashboard, you simply ask your agent to list all locks, getting real-time data on online/offline status. - Emergency response time shrinks dramatically. Instead of calling maintenance and waiting for them to physically open a door, you tell your AI client to unlock_door immediately using the specific lock ID. - User onboarding is faster. You can ask the agent to list users and then review their full profiles via get_my_profile without having to navigate through complex user directories. - Auditing becomes trivial. To check if a team has too many permissions, you just query groups and places using list_access_groups and list_role_assignments instead of running multi-page reports. - Location oversight is simplified. You can use list_places to get an inventory of all sites across your portfolio at a glance, making facility audits much faster. ## How It Works The bottom line is that you talk to your AI client, and it talks directly to your building's physical lock system. 1. First, subscribe to this MCP on Vinkius and input your Kisi API Key (Personal Access Token). 2. Next, connect your preferred AI client to the catalog. Your agent now sees all available security tools. 3. Finally, you give a simple text prompt—like 'List all locks that are currently offline'—and the MCP executes the command. ## Frequently Asked Questions **How do I remotely unlock a door using the Kisi MCP?** You use the unlock_door tool by providing the specific lock ID. Your agent sends the command to the lock, and it should open immediately. **Does Kisi MCP let me see all users in one place?** Yes, you can list all registered users using list_users. This provides a full directory of accounts in your organization. **Can I check if a specific location is set up correctly?** You use get_place_details to retrieve the configuration details for any given physical place ID, ensuring it meets compliance standards. **What if I need to know which groups exist in my system?** Call list_access_groups. This tool gives you a complete inventory of all access groups defined within your Kisi environment. **How do I find out what a user's current roles are?** You query the system using list_role_assignments. This shows every role assigned to every group, helping you audit permissions quickly.