UniFi MCP Server

Implementation Reference

• src/tools/clients.js:85-90 (handler)

  The primary handler for the 'unblock_client' MCP tool. It invokes the UniFi API via unifi.unblockClient, handles the response, and returns formatted text output.
  handler: async ({ hostId, siteId, mac }) => { const result = await unifi.unblockClient(hostId, siteId, mac); return { content: [{ type: 'text', text: `Client ${mac} has been unblocked. ${JSON.stringify(result, null, 2)}` }] }; }
• src/tools/clients.js:80-84 (schema)

  Zod schema defining input parameters for the unblock_client tool: hostId, siteId, and mac address.
  schema: z.object({ hostId: z.string().describe('The host ID'), siteId: z.string().describe('The site ID'), mac: z.string().describe('The client MAC address') }),
• src/server.js:30-30 (registration)

  Registration of the clientTools module (containing unblock_client) to the MCP server via registerToolsFromModule, which calls server.tool() for each tool.
  registerToolsFromModule(clientTools);
• src/unifi-client.js:161-164 (helper)

  Underlying helper function that makes the actual POST request to the UniFi Cloud API to unblock the client.
  export async function unblockClient(hostId, siteId, mac) { const response = await cloudApi.post(`/v1/hosts/${hostId}/sites/${siteId}/clients/${mac}/unblock`); return response.data; }
• src/server.js:4-4 (registration)

  Import of the clientTools module, which includes the unblock_client tool definition.
  import { clientTools } from './tools/clients.js';