Keycloak MCP Server

Instructions

Implementation Reference

• src/index.ts:136-154 (handler)

  Handler for the 'delete-user' tool: parses arguments with DeleteUserSchema, sets Keycloak realm config, deletes user by ID, returns success response.

  case "delete-user": {
    const { realm, userId } = DeleteUserSchema.parse(args);
    
    kcAdminClient.setConfig({
      realmName: realm
    });
  
    await kcAdminClient.users.del({
      id: userId,
      realm
    });
  
    return {
      content: [{
        type: "text",
        text: `User ${userId} deleted successfully from realm ${realm}`
      }]
    };
  }

• src/index.ts:34-37 (schema)

  Zod schema defining input validation for 'delete-user' tool: requires 'realm' and 'userId' strings.

  const DeleteUserSchema = z.object({
    realm: z.string(),
    userId: z.string()
  });

• src/index.ts:62-73 (registration)

  Tool registration in ListTools handler: defines name, description, and inputSchema for 'delete-user'.

  {
    name: "delete-user",
    description: "Delete a user from a specific realm",
    inputSchema: {
      type: "object",
      properties: {
        realm: { type: "string" },
        userId: { type: "string" }
      },
      required: ["realm", "userId"]
    }
  },