UniFi MCP Server

Implementation Reference

• src/tools/access.js:73-78 (handler)

  MCP tool handler for 'lock_door' that calls the underlying unifi.lockDoor function and formats a text response with the result.

  handler: async ({ hostId, doorId }) => {
    const result = await unifi.lockDoor(hostId, doorId);
    return {
      content: [{ type: 'text', text: `Door locked. ${JSON.stringify(result, null, 2)}` }]
    };
  }

• src/tools/access.js:69-72 (schema)

  Zod input schema defining required hostId and doorId parameters for the lock_door tool.

  schema: z.object({
    hostId: z.string().describe('The host ID'),
    doorId: z.string().describe('The door ID')
  }),

• src/server.js:28-32 (registration)

  Registration of the accessTools module (containing lock_door) to the MCP server using registerToolsFromModule.

  registerToolsFromModule(networkTools);
  registerToolsFromModule(deviceTools);
  registerToolsFromModule(clientTools);
  registerToolsFromModule(protectTools);
  registerToolsFromModule(accessTools);

• src/unifi-client.js:279-282 (helper)

  Helper function that performs the actual API POST request to lock a UniFi Access door.

  export async function lockDoor(hostId, doorId) {
    const response = await cloudApi.post(`/v1/hosts/${hostId}/doors/${doorId}/lock`);
    return response.data;
  }