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';